Obter resultados de Advanced Google Hotel Info por id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Obter resultados de Advanced Google Hotel Info por id
Recupera por id uma listagem de hotel enfileirada, já analisada. 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.
- Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskGetAdvancedResponseInfo200
- Tipo: number | null Formato: doublecost
custo total das tarefas, USD
- Tipo: integer | nullstatus
_code código de status geral você pode encontrar a lista completa dos códigos de resposta aqui
- Tipo: string | nullstatus
_message mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui
- Tipo: array (object | null)[] | nulltasks
array de tarefas
- Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskGetAdvancedTaskInfo
- costTipo: number | null Formato: double
custo total das tarefas, USD
- dataTipo: object | null
contém os mesmos parâmetros que você especificou na requisição POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID
- pathTipo: array (string | null)[] | null
caminho da URL
- resultTipo: array (object | null)[] | null
array de resultados
- aboutTipo: object | null · Response36Afe1097B20_HotelAboutInfo
informações sobre o hotel
- amenitiesTipo: array (object | null)[] | null
comodidades do hotel
informações sobre as comodidades do hotel- categoryTipo: string | null
categoria padronizada da comodidade
- categoryTipo: string | null
_label rótulo da categoria
- itemsTipo: array (object | null)[] | null
comodidades e detalhes específicos
- amenityTipo: string | null
nome padronizado da comodidade
- amenityTipo: string | null
_label nome da comodidade exibido
- hintTipo: string | null
detalhes padronizados sobre a comodidade
- hintTipo: string | null
_label detalhes exibidos sobre a comodidade
- isTipo: boolean | null
_available indica se a
amenityestá disponível no hotel
- checkTipo: object | null · Response36Afe1097B20_TimeInfo
_in _time horário de check-in do hotel
horário de check-in indicado na listagem do hotel- hourTipo: integer | null
horas no formato de 24 horas
- minuteTipo: integer | null
minutos
- checkTipo: object | null · Response36Afe1097B20_TimeInfo
_out _time horário de check-out do hotel
horário de check-out indicado na listagem do hotel- hourTipo: integer | null
horas no formato de 24 horas
- minuteTipo: integer | null
minutos
- descriptionTipo: string | null
descrição do hotel
a descrição da entidade hoteleira para a qual os resultados são coletados - domainTipo: string | null
domínio do hotel
domínio do site do hotel - fullTipo: string | null
_address endereço completo do hotel
endereço do hotel indicado no formato padronizado - popularTipo: array (object | null)[] | null
_amenities comodidades do hotel
informações sobre comodidades do hotel rotuladas como "populares"- amenityTipo: string | null
nome padronizado da comodidade
- amenityTipo: string | null
_label nome da comodidade exibido
- hintTipo: string | null
detalhes padronizados sobre a comodidade
- hintTipo: string | null
_label detalhes exibidos sobre a comodidade
- isTipo: boolean | null
_available indica se a
amenityestá disponível no hotel
- subTipo: array (string | null)[] | null
_descriptions descrição adicional do hotel
detalhes sobre o hotel fornecidos além da descrição - urlTipo: string | null
url do hotel
URL do site do hotel indicado na listagem
- addressTipo: string | null
endereço do hotel
endereço físico do hotel - checkTipo: string | null
_url URL direta para os resultados do mecanismo de busca
você pode usá-la para garantir que fornecemos resultados precisos - datetimeTipo: 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 - hotelTipo: string | null
_identifier identificador exclusivo do hotel
este campo conterá o parâmetrohotel_identifier;
exemplo:CgoI-KWyzenM_MV3EAE - languageTipo: string | null
_code código de idioma em um array POST
- locationTipo: object | null · Response36Afe1097B20_HotelLocationInfo
informações sobre a localização do hotel
informações sobre o local onde o hotel está situado- latitudeTipo: number | null
latitude do hotel
coordenadas de latitude da localização do hotel
exemplo:39.4806397 - locationTipo: array (object | null)[] | null
_chain elementos da cadeia de localização
parâmetros adicionais de cada elemento da cadeia de localização- cardTipo: string | null
_id identificador do card
- cidTipo: string | null
- featureTipo: string | null
_id - titleTipo: string | null
título do elemento na cadeia de localização
- longitudeTipo: number | null
longitude do hotel
coordenadas de latitude da localização do hotel
exemplo:-106.0512973 - mapsTipo: string | null
_url url da localização do hotel no google maps
- neighborhoodTipo: string | null
nome do bairro onde o hotel está localizado
- neighborhoodTipo: string | null
_description descrição do bairro onde o hotel está localizado
- overallTipo: number | null
_score pontuação geral da localização do hotel
indica a pontuação geral da localização do hotel no intervalo de 1 a 5;
calculada com base em dados de proximidade do hotel a atrações e restaurantes próximos, transporte e aeroportos;
observe que os critérios não têm o mesmo peso na pontuação geral - scoreTipo: object | null
_by _categories pontuações por categoria da localização do hotel
as pontuações da localização do hotel vinculadas às categorias que indicam a proximidade a atrações, restaurantes, transporte e aeroportos próximos;- propertyTipo: number | null Formato: double
Name
- locationTipo: integer | null
_code código de localização em um array POST
- overviewTipo: array (string | null)[] | null
_images imagens exibidas na visão geral do hotel
array contendo URLs de imagens exibidas na visão geral do hotel - phoneTipo: string | null
número de telefone do hotel
número de telefone de contato do hotel - pricesTipo: object | null · Response36Afe1097B20_HotelPriceInfo
detalhes de preço da entidade hotel
contém informações sobre os preços do hotel- checkTipo: string | null
_in 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 - checkTipo: string | null
_out 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 - currencyTipo: string | null
moeda do preço
USDé aplicado por padrão, a menos que especificado no array POST - discountTipo: string | null
_text texto sobre um desconto aplicado
- itemsTipo: array (object | null)[] | null
tipos de item encontrados
tipos de resultados de mecanismos de pesquisa encontrados no arrayitems;
tipos de item possíveis:hotel_search_item- currencyTipo: string | null
moeda do preço
USDé aplicado por padrão, a menos que especificado no array POST - domainTipo: string | null
domínio de terceiros domínio da página do site de terceiros com informações de preços
- freeTipo: string | null
_cancellation _until 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
- isTipo: boolean | null
_paid indica uma ficha de hotel paga
setrue, ohotel_search_itemrelacionado é um anúncio pago
sefalse, ohotel_search_itemrelacionado é uma ficha de hotel orgânica - offersTipo: array (object | null)[] | null
ofertas de preço em destaque
- currencyTipo: string | null
moeda do preço
USDé aplicado por padrão, a menos que especificado no array POST - freeTipo: string | null
_cancellation _until 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
- maxTipo: integer | null
_visitors o número máximo de visitantes o número máximo de visitantes para os quais a oferta de preço é válida
- offerTipo: array (string | null)[] | null
_images imagens da oferta de preço URLs das imagens apresentadas na oferta de preço
- priceTipo: number | null
preço por noite
- titleTipo: string | null
título do hotel
- typeTipo: string | null
tipo de elemento
- urlTipo: string | null
url da oferta de preço URL da página do site onde a oferta de preço aparece
- officialTipo: boolean | null
_site - priceTipo: number | null
preço por noite
- titleTipo: string | null
título do hotel
- typeTipo: string | null
tipo de elemento
- urlTipo: string | null
url da página de terceiros URL da página do site de terceiros com informações de preços
- priceTipo: number | null
preço por noite
- priceTipo: number | null Formato: int64
_without _discount preço total por noite sem desconto aplicado
- pricesTipo: array (object | null)[] | null
_by _dates - checkTipo: string | null
_in _date - checkTipo: string | null
_out _date - currencyTipo: string | null
moeda do preço
USDé aplicado por padrão, a menos que especificado no array POST - priceTipo: number | null
preço por noite
- visitorsTipo: integer | null
número de visitantes do hotel para este preço
- reviewsTipo: object | null · Response36Afe1097B20_HotelReviewInfo
avaliações do hotel por critério
informações sobre as avaliações da entidade hotel- mentionsTipo: array (object | null)[] | null
menções ao hotel
informações sobre avaliações do hotel por critério- negativeTipo: integer | null Formato: int64
_count contagem de avaliações negativas por critério
- positiveTipo: integer | null Formato: int64
_count contagem de avaliações positivas por critério
- positiveTipo: number | null
_score pontuação positiva por critério
- titleTipo: string | null
título do critério avaliado
- totalTipo: integer | null Formato: int64
_count contagem de todas as avaliações por critério
- visibleTipo: boolean | null
_by _default elemento visível por padrão
indica se o elemento de avaliação é visível por padrão
- otherTipo: array (object | null)[] | null
_sites _reviews avaliações em sites de terceiros
avaliações de sites de terceiros- ratingTipo: object | null · Response36Afe1097B20_RatingInfo
avaliação na análise
informações sobre a avaliação contida na análise em um site de terceiros- ratingTipo: integer | null
_max o valor máximo para um rating_type
- ratingTipo: string | null
_type o tipo de avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax
- valueTipo: number | null Formato: double
o valor da avaliação
- votesTipo: integer | null Formato: int64
_count a quantidade de feedback
- reviewTipo: string | null
_text texto da avaliação
texto da avaliação - titleTipo: string | null
título da avaliação
contém o nome do site de terceiros onde a avaliação apareceu inicialmente - urlTipo: string | null
URL da avaliação
URL do site de terceiros onde a avaliação apareceu inicialmente
- ratingTipo: object | null
_distribution distribuição de avaliações por votos
a distribuição de votos pela classificação no intervalo de 1 a 5- propertyTipo: integer | null Formato: Int64
Name
- valueTipo: number | null
avaliação geral do hotel com base nos votos dos clientes
- votesTipo: integer | null Formato: int64
_count número de votos dos clientes
o número de votos de clientes incluídos no cálculo da avaliação do hotel
- starsTipo: integer | null
classificação por estrelas do hotel
classificação que varia de 1 a 5 estrelas e é exibida após as avaliações na ficha resumida do hotel - starsTipo: string | null
_description classificação por estrelas do hotel
classificação que varia de 1 a 5 estrelas e é exibida após as avaliações na ficha resumida do hotel - titleTipo: string | null
título do hotel
o título da entidade hotel para a qual os resultados são coletados
- resultTipo: integer | null Formato: int64
_count número de elementos no array de resultados
- statusTipo: integer | null
_code 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
- statusTipo: string | null
_message mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui
- timeTipo: string | null
tempo de execução, segundos
- Tipo: integer | null Formato: int64tasks
_count o número de tarefas no array de tarefas
- Tipo: integer | null Formato: int64tasks
_error o número de tarefas no array de tarefas retornadas com erro
- Tipo: string | nulltime
tempo total de execução, em segundos
- Tipo: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/task_get/advanced/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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": [
{
"hotel_identifier": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"title": null,
"stars": null,
"stars_description": null,
"address": null,
"phone": null,
"about": {
"description": null,
"sub_descriptions": [
"[Max Depth Exceeded]"
],
"check_in_time": "[Max Depth Exceeded]",
"check_out_time": "[Max Depth Exceeded]",
"full_address": null,
"domain": null,
"url": null,
"amenities": [
"[Max Depth Exceeded]"
],
"popular_amenities": [
"[Max Depth Exceeded]"
]
},
"location": {
"neighborhood": null,
"neighborhood_description": null,
"maps_url": null,
"overall_score": null,
"score_by_categories": null,
"latitude": null,
"longitude": null,
"location_chain": [
"[Max Depth Exceeded]"
]
},
"reviews": {
"value": null,
"votes_count": null,
"mentions": [
"[Max Depth Exceeded]"
],
"rating_distribution": null,
"other_sites_reviews": [
"[Max Depth Exceeded]"
]
},
"overview_images": [
null
],
"prices": {
"price": null,
"price_without_discount": null,
"currency": null,
"discount_text": null,
"check_in": null,
"check_out": null,
"visitors": null,
"items": [
"[Max Depth Exceeded]"
],
"prices_by_dates": [
"[Max Depth Exceeded]"
]
}
}
]
}
]
}