v0.2.0-beta

OpenAPI 3.1.0

Tarefas de Google Hotel Searches em tempo real

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas Cliente

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operações

post/v1/beta/dataforseo/business_data/google/hotel_searches/live

Tarefas de Google Hotel Searches em tempo real

Pesquisa no Google Hotels propriedades que correspondem a uma consulta, com datas e ocupação. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. É assim que se encontra o hotel cujo id os endpoints de informação precisam; post_dataforseo_business_google_hotel_info_live é a visão de detalhe.

Referência de preços

Medição: Custo da resposta reportado.
Estimativa de referência por requisição: USD 0.2428.
Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

Corpo

application/json

Tipo: array (object | null)[]
- adults
 Tipo: integer | null
 
 número de adultos
 campo opcional
 se você não especificar este campo, o valor padrão de 2 será aplicado;
 observação: você pode especificar até 6 pessoas, incluindo adultos e crianças
 exemplo:
 1
- amenities
 Tipo: array string[] | null
 
 comodidades do hotel
 campo opcional
 você pode usar este campo para especificar diferentes comodidades do hotel
 exemplo:
 [ "free_parking", "pets_allowed" ]
 valores possíveis:
 "air_conditioning", "all_inclusive_available", "bar", "free_breakfast", "fitness_center", "kid_friendly", "free_parking", "pets_allowed", "pool", "restaurant", "room_service", "spa", "free_wifi", "parking", "indoor_pool", "outdoor_pool", "wheelchair_accessible", "beach_access"
- check_in
 Tipo: string | null
 
 data de check-in
 campo opcional
 se você não especificar este campo, a data de amanhã será usada por padrão;
 formato de data: "yyyy-mm-dd"
 exemplo:
 "2019-01-15"
 Observação: o valor não pode ser anterior à data de hoje
- check_out
 Tipo: string | null
 
 data de check-out
 campo opcional
 se você não especificar este campo, nosso sistema aplicará por padrão a data de dois dias a partir de hoje;
 formato de data: "yyyy-mm-dd"
 exemplo:
 "2019-01-15"
 Observação: o valor não pode ser menor ou igual a check_in;
 o intervalo entre os valores de check_in e check_out não pode exceder 30 dias
- children
 Tipo: array string[] | null
 
 número e idade das crianças
 campo opcional
 se você não especificar este campo, nenhuma criança será incluída na pesquisa;
 a idade da criança pode ser de 0 a 17;
 observação: você pode especificar até 6 pessoas, incluindo adultos e crianças
 defina o seguinte valor se quiser incluir uma criança de 14 anos:
 [14]
 defina o seguinte valor se quiser incluir uma criança de 13 anos e uma de 8 anos:
 [13,8]
- currency
 Tipo: string | null
 
 moeda
 campo opcional
 exemplo:
 "USD"
- depth
 Tipo: integer | null
 
 profundidade de análise
 campo opcional
 número de resultados no Google Hotels
 valor padrão: 18 resultados orgânicos
 valor máximo: 140
 Observação: sua conta será cobrada por cada 18 resultados orgânicos, independentemente dos anúncios pagos na resposta;
 portanto, definir uma profundidade acima de 18 pode gerar cobranças adicionais se o Google Hotels retornar mais de 18 resultados;
 se a profundidade especificada for maior que o número de resultados na resposta, a diferença será reembolsada automaticamente no saldo da sua conta
- free_cancellation
 Tipo: boolean | null
 
 hotéis com cancelamento gratuito
 campo opcional
 defina este campo como true se quiser obter a lista de hotéis com cancelamento gratuito de reservas
 valor padrão: false
- is_vacation_rentals
 Tipo: boolean | null
 
 pesquisa de aluguéis de temporada
 campo opcional
 defina este campo como true se quiser obter a lista de aluguéis de temporada em vez de hotéis
 valor padrão: false
- keyword
 Tipo: string | null
 
 palavra-chave
 campo opcional
 a palavra-chave especificada é usada para pesquisar a lista de hotéis;
 se você não usar este campo, retornaremos a lista de hotéis encontrados em um local especificado;
 você pode especificar até 700 caracteres no campo keyword
 todos os %## serão decodificados (o caractere ‘+’ será decodificado como espaço)
 se precisar usar o caractere “%” no seu keyword, especifique-o como “%25”;
 Observação: para obter resultados de pesquisa precisos, o nome do local é anexado automaticamente à palavra-chave
 
 saiba mais sobre as regras e limitações dos campos keyword e keywords nas APIs do DataForSEO neste artigo da Central de Ajuda
- language_code
 Tipo: string
 
 código do idioma do mecanismo de busca
 campo obrigatório se você não especificar language_name
 se você usar este campo, não precisa especificar language_name
 você pode obter a lista de idiomas disponíveis com seu language_code fazendo uma requisição separada para https://api.dataforseo.com/v3/business_data/google/languages
 exemplo:
 en
- language_name
 Tipo: string
 
 nome completo do idioma do mecanismo de busca
 campo obrigatório se você não especificar language_code
 se você usar este campo, não precisa especificar language_code
 você pode obter a lista de idiomas disponíveis com language_name fazendo uma requisição separada para https://api.dataforseo.com/v3/business_data/google/languages
 exemplo:
 English
- location_code
 Tipo: integer
 
 código do local do mecanismo de busca
 campo obrigatório se você não especificar location_name_or location_coordinate
 se você usar este campo, não precisa especificar location_name ou location_coordinate
 você pode obter a lista de locais disponíveis com location_code fazendo uma requisição separada para o https://api.dataforseo.com/v3/business_data/google/locations
 exemplo:
 2840
- location_coordinate
 Tipo: string
 
 coordenadas GPS de um local
 campo obrigatório se você não especificar location_name_or location_code
 se você usar este campo, não precisa especificar location_name ou location_code
 o parâmetro location_coordinate deve ser especificado no formato "latitude,longitude"
 o número máximo de casas decimais para "latitude" e "longitude": 7
 Observação: se as coordenadas forem usadas para definir um local, a pesquisa ocorrerá no localidade mais próxima
 exemplo:
 53.476225,-2.243572
- location_name
 Tipo: string
 
 nome completo do local do mecanismo de busca
 campo obrigatório se você não especificar location_code ou location_coordinate
 se você usar este campo, não precisa especificar location_code ou location_coordinate
 você pode obter a lista de locais disponíveis com location_name fazendo uma requisição separada para https://api.dataforseo.com/v3/business_data/google/locations
 exemplo:
 London,England,United Kingdom
 Observação: para obter resultados de pesquisa precisos, o location_name especificado será anexado automaticamente à palavra-chave
- max_price
 Tipo: integer | null
 
 preço máximo por noite
 campo opcional
 a moeda deste valor depende do campo currency
 exemplo:
 600
- min_price
 Tipo: integer | null
 
 preço mínimo por noite
 campo opcional
 a moeda deste valor depende do campo currency
 exemplo:
 100
- min_rating
 Tipo: number | null
 
 avaliação mínima
 campo opcional
 você pode usar este campo para especificar uma avaliação dos hóspedes superior a um determinado valor
 exemplo:
 2.5
- search_this_area
 Tipo: boolean | null
 
 mostrar hotéis da área exibida
 campo opcional
 pode assumir os valores: true, false
 valor padrão: true
 se definido como false, o modo search_this_area será desativado
 Observação: se o modo search_this_area estiver desativado, o location_name não será anexado ao keyword durante a pesquisa
 saiba mais sobre este parâmetro na nossa Central de Ajuda
- sort_by
 Tipo: string | null
 
 parâmetros de ordenação dos resultados
 campo opcional
 você pode usar este campo para ordenar os resultados
 tipos de ordenação possíveis:
 relevance – ordenar por mais relevante
 lowest_price – ordenar pelo menor preço
 highest_rating – ordenar pela maior avaliação
 most_reviewed – ordenar por mais avaliados
 valor padrão: relevance
- stars
 Tipo: array string[] | null
 
 estrelas do hotel
 campo opcional
 defina este campo como [5] se quiser obter apenas a lista de hotéis 5 estrelas
 exemplo:
 [3,4,5]
- tag
 Tipo: string | null
 
 identificador de tarefa definido pelo usuário
 campo opcional
 o limite de caracteres é 255
 você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado
 você encontrará o valor de tag especificado no objeto data da resposta

Respostas

200
Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveResponseInfo
cost
Tipo: number | null Formato: double

custo total das tarefas, USD

status_code
Tipo: integer | null

código de status geral você pode encontrar a lista completa dos códigos de resposta aqui

status_message
Tipo: string | null

mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui

tasks
Tipo: array (object | null)[] | null

array de tarefas

Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveTaskInfo
cost
Tipo: number | null Formato: double

custo total das tarefas, USD

data
Tipo: object | null

contém os mesmos parâmetros que você especificou na requisição POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID

path
Tipo: array (string | null)[] | null

caminho da URL

result
Tipo: array (object | null)[] | null

array de resultados

check_url
Tipo: string | null

URL direta para os resultados do mecanismo de busca
você pode usá-la para garantir que fornecemos resultados precisos

datetime
Tipo: string | null

data e hora em que o resultado foi recebido
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:
2019-11-15 12:57:46 +00:00

items
Tipo: array (object | null)[] | null

tipos de item encontrados
tipos de resultados de mecanismos de pesquisa encontrados no array items;
tipos de item possíveis: hotel_search_item

hotel_identifier
Tipo: string | null

identificador exclusivo de uma entidade hotel na pesquisa do Google
exemplo:
CgoI-KWyzenM_MV3EAE

is_paid
Tipo: boolean | null

indica uma ficha de hotel paga
se true, o hotel_search_item relacionado é um anúncio pago
se false, o hotel_search_item relacionado é uma ficha de hotel orgânica

location
Tipo: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo

coordenadas GPS da localização do hotel

latitude
Tipo: number | null

coordenada de latitude do hotel no google maps
exemplo:
"latitude": 51.584091

longitude
Tipo: number | null

coordenada de longitude do hotel no google maps
exemplo:
"longitude": -0.31365919999999997

overview_images
Tipo: array (string | null)[] | null

imagens em destaque de um hotel

prices
Tipo: object | null · Response36Afe1097B20_HotelPriceInfo

preço do hotel

check_in
Tipo: string | null

data e hora do check-in
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:
2019-11-15 12:57:46 +00:00

check_out
Tipo: string | null

data e hora do check-out
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:
2019-11-15 12:57:46 +00:00

currency
Tipo: string | null

moeda do preço
USD é aplicado por padrão, a menos que especificado no array POST

discount_text
Tipo: string | null

texto sobre um desconto aplicado

items
Tipo: array (object | null)[] | null

tipos de item encontrados
tipos de resultados de mecanismos de pesquisa encontrados no array items;
tipos de item possíveis: hotel_search_item

currency
Tipo: string | null

moeda do preço
USD é aplicado por padrão, a menos que especificado no array POST

domain
Tipo: string | null

domínio de terceiros domínio da página do site de terceiros com informações de preços

free_cancellation_until
Tipo: string | null

data até a qual o cancelamento gratuito está disponível no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” equivale a null se o cancelamento gratuito não estiver disponível para as datas selecionadas

is_paid
Tipo: boolean | null

indica uma ficha de hotel paga
se true, o hotel_search_item relacionado é um anúncio pago
se false, o hotel_search_item relacionado é uma ficha de hotel orgânica

offers
Tipo: array (object | null)[] | null

ofertas de preço em destaque

currency
Tipo: string | null

moeda do preço
USD é aplicado por padrão, a menos que especificado no array POST

free_cancellation_until
Tipo: string | null

data até a qual o cancelamento gratuito está disponível no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” equivale a null se o cancelamento gratuito não estiver disponível para as datas selecionadas

max_visitors
Tipo: integer | null

o número máximo de visitantes o número máximo de visitantes para os quais a oferta de preço é válida

offer_images
Tipo: array (string | null)[] | null

imagens da oferta de preço URLs das imagens apresentadas na oferta de preço

price
Tipo: number | null

preço por noite

title
Tipo: string | null

título do hotel

type
Tipo: string | null

tipo de elemento

url
Tipo: string | null

url da oferta de preço URL da página do site onde a oferta de preço aparece

official_site
Tipo: boolean | null
price
Tipo: number | null

preço por noite

title
Tipo: string | null

título do hotel

type
Tipo: string | null

tipo de elemento

url
Tipo: string | null

url da página de terceiros URL da página do site de terceiros com informações de preços

price
Tipo: number | null

preço por noite

price_without_discount
Tipo: number | null Formato: int64

preço total por noite sem desconto aplicado

prices_by_dates
Tipo: array (object | null)[] | null
check_in_date
Tipo: string | null
check_out_date
Tipo: string | null
currency
Tipo: string | null

moeda do preço
USD é aplicado por padrão, a menos que especificado no array POST

price
Tipo: number | null

preço por noite

visitors
Tipo: integer | null

número de visitantes do hotel para este preço

reviews
Tipo: object | null · Response36Afe1097B20_HotelReviewInfo

avaliações e informações de classificação do hotel

mentions
Tipo: array (object | null)[] | null

menções ao hotel
informações sobre avaliações do hotel por critério

negative_count
Tipo: integer | null Formato: int64

contagem de avaliações negativas por critério

positive_count
Tipo: integer | null Formato: int64

contagem de avaliações positivas por critério

positive_score
Tipo: number | null

pontuação positiva por critério

title
Tipo: string | null

título do critério avaliado

total_count
Tipo: integer | null Formato: int64

contagem de todas as avaliações por critério

visible_by_default
Tipo: boolean | null

elemento visível por padrão
indica se o elemento de avaliação é visível por padrão

other_sites_reviews
Tipo: array (object | null)[] | null

avaliações em sites de terceiros
avaliações de sites de terceiros

rating
Tipo: object | null · Response36Afe1097B20_RatingInfo

avaliação na análise
informações sobre a avaliação contida na análise em um site de terceiros

rating_max
Tipo: integer | null

o valor máximo para um rating_type

rating_type
Tipo: string | null

o tipo de avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax

value
Tipo: number | null Formato: double

o valor da avaliação

votes_count
Tipo: integer | null Formato: int64

a quantidade de feedback

review_text
Tipo: string | null

texto da avaliação
texto da avaliação

title
Tipo: string | null

título da avaliação
contém o nome do site de terceiros onde a avaliação apareceu inicialmente

url
Tipo: string | null

URL da avaliação
URL do site de terceiros onde a avaliação apareceu inicialmente

rating_distribution
Tipo: object | null

distribuição de avaliações por votos
a distribuição de votos pela classificação no intervalo de 1 a 5

propertyName
Tipo: integer | null Formato: Int64
value
Tipo: number | null

avaliação geral do hotel com base nos votos dos clientes

votes_count
Tipo: integer | null Formato: int64

número de votos dos clientes
o número de votos de clientes incluídos no cálculo da avaliação do hotel

stars
Tipo: integer | null

classificação por estrelas do hotel
classificação que varia de 1 a 5 estrelas

title
Tipo: string | null

título do hotel

type
Tipo: string | null

tipo de elemento

items_count
Tipo: integer | null Formato: int64

tipos de itens
o número de itens no array items

keyword
Tipo: string | null

palavra-chave recebida em um array POST
a palavra-chave é retornada com %## decodificado (o caractere '+' será decodificado como um espaço)

language_code
Tipo: string | null

código de idioma em um array POST

location_code
Tipo: integer | null

código de localização em um array POST

result_count
Tipo: integer | null Formato: int64

número de elementos no array de resultados

status_code
Tipo: integer | null

código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000 você pode encontrar a lista completa dos códigos de resposta aqui

status_message
Tipo: string | null

mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui

time
Tipo: string | null

tempo de execução, segundos

tasks_count
Tipo: integer | null Formato: int64

o número de tarefas no array de tarefas

tasks_error
Tipo: integer | null Formato: int64

o número de tarefas no array de tarefas retornadas com erro

time
Tipo: string | null

tempo total de execução, em segundos

version
Tipo: string | null

a versão atual da API
application/json
400

Não foi possível processar a requisição. Verifique os parâmetros da requisição.
401

É necessária uma chave de API da Felo válida.
402

A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
403

A conta não tem permissão para realizar esta operação.
429

Um limite de requisições ou de gastos foi atingido.
502

O serviço não pôde concluir a requisição.
503

A API ou o serviço de cobrança está temporariamente indisponível.
504

O serviço atingiu o tempo limite ao processar a requisição.
default

Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

application/json

post/v1/beta/dataforseo/business_data/google/hotel_searches/live

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "New York,New York,United States",
    "keyword": "cheap hotel",
    "check_in": "2023-06-01",
    "check_out": "2023-06-30",
    "currency": "USD",
    "adults": 2,
    "children": [
      "14"
    ],
    "sort_by": "highest_rating",
    "priority": 2,
    "tag": "example"
  }
]'

Mostrar Schema

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "hotel_identifier": null,
              "title": null,
              "stars": null,
              "is_paid": null,
              "location": "[Max Depth Exceeded]",
              "reviews": "[Max Depth Exceeded]",
              "overview_images": [
                "[Max Depth Exceeded]"
              ],
              "prices": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operação bem-sucedida

Tarefas de Google Hotel Searches em tempo real

AutenticaçãoRequired

DataForSEO

Tarefas de Google Hotel Searches em tempo real

Referência de preços