v0.2.0-beta

OpenAPI 3.1.0

Obter resultados de Google Hotel Searches por id

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

get/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/{id}

Obter resultados de Google Hotel Searches por id

Recupera por id uma pesquisa do Google Hotels enfileirada. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. ⚠️ O tamanho da resposta foi fixado pelo depth ou limite definido no envio e não pode ser reduzido aqui; se estiver grande demais, reenvie com um valor menor em vez de paginar.

Referência de preços

Medição: Custo da resposta reportado.
Estimativa de referência por requisição: USD 0.012.
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.

Parâmetros de Caminho

id
Tipo: string
obrigatório

identificador da tarefa
identificador exclusivo da tarefa em nosso sistema no formato UUID
você poderá usá-lo por 30 dias para solicitar os resultados da tarefa a qualquer momento

Respostas

200
Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetResponseInfo
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_BusinessDataGoogleHotelSearchesTaskGetTaskInfo
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

array de itens
observação: este campo sempre equivale a null; use-o para facilitar a integração e garantir a interoperabilidade com o endpoint Hotel Info

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);
para obter resultados de pesquisa precisos, o nome do local é anexado automaticamente à palavra-chave

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

get/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

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

Obter resultados de Google Hotel Searches por id

AutenticaçãoRequired

DataForSEO

Obter resultados de Google Hotel Searches por id

Referência de preços