Felo API PlatformFelo API Platform
Todos os endpoints de DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Google Hotel Info Advanced 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

Google Hotel Info Advanced em tempo real

​

A listagem de um hotel no Google: quartos, comodidades, preços e as opções de reserva que o Google mostra. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. A forma bruta é post_dataforseo_business_google_hotel_info_live_html, e a forma enfileirada, post_dataforseo_business_google_hotel_info_submit. Para encontrar o hotel primeiro, use post_dataforseo_business_google_hotel_searches_live.

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, dois adultos serão usados por padrão
      exemplo:
      1

    • 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;
      o valor não pode ser anterior à data de hoje
      formato de data: "yyyy-mm-dd"
      exemplo:
      "2019-01-15"

    • 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;
      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
      formato de data: "yyyy-mm-dd"
      exemplo:
      "2019-01-15"

    • 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;

      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"

    • hotel_identifier
      Tipo: string

      identificador exclusivo do hotel
      campo obrigatório
      identificador exclusivo de uma entidade hoteleira na busca do Google;
      você pode obter o valor fazendo uma requisição à Advanced Google SERP API (incluído no elemento hotels da resposta) ou ao endpoint Hotel Searches da Business Data API
      exemplo:
      ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE

    • 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

    • load_prices_by_dates
      Tipo: boolean | null

      carregar preços de estadia no hotel por datas
      campo opcional
      se você especificar este parâmetro com true, a resposta incluirá o array prices_by_dates com os preços de estadia no hotel divididos por datas
      se você usar este parâmetro, será cobrado o dobro do preço base por requisição

    • 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 o https://api.dataforseo.com/v3/business_data/google/locations
      exemplo:
      London,England,United Kingdom

    • prices_date_range
      Tipo: string | null

      período predefinido para recuperar dados diários de preços
      campo opcional
      para usar este parâmetro, você deve especificar load_prices_by_dates com true
      se prices_start_date não for especificado, a data inicial será a data de check_in
      valores possíveis: month, three_months, six_months, year
      valor padrão: month

    • prices_end_date
      Tipo: string | null

      data final para carregar preços por datas
      campo opcional
      para usar este parâmetro, você deve especificar load_prices_by_dates com true
      se este parâmetro não for especificado, você receberá os preços por data para o mês
      formato de data: yyyy-mm-dd
      exemplo:
      2025-05-21

    • prices_start_date
      Tipo: string | null

      data inicial para carregar preços por datas
      campo opcional
      para usar este parâmetro, você deve especificar load_prices_by_dates com true
      se este parâmetro não for especificado, a data inicial será a data de check_in
      formato de data: yyyy-mm-dd
      exemplo:
      2025-05-20

    • 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_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo
    • 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_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
        • 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

          • about
            Tipo: object | null · Response36Afe1097B20_HotelAboutInfo

            informações sobre o hotel

            • amenities
              Tipo: array (object | null)[] | null

              comodidades do hotel
              informações sobre as comodidades do hotel

              • category
                Tipo: string | null

                categoria padronizada da comodidade

              • category_label
                Tipo: string | null

                rótulo da categoria

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

                comodidades e detalhes específicos

                • amenity
                  Tipo: string | null

                  nome padronizado da comodidade

                • amenity_label
                  Tipo: string | null

                  nome da comodidade exibido

                • hint
                  Tipo: string | null

                  detalhes padronizados sobre a comodidade

                • hint_label
                  Tipo: string | null

                  detalhes exibidos sobre a comodidade

                • is_available
                  Tipo: boolean | null

                  indica se a amenity está disponível no hotel

            • check_in_time
              Tipo: object | null · Response36Afe1097B20_TimeInfo

              horário de check-in do hotel
              horário de check-in indicado na listagem do hotel

              • hour
                Tipo: integer | null

                horas no formato de 24 horas

              • minute
                Tipo: integer | null

                minutos

            • check_out_time
              Tipo: object | null · Response36Afe1097B20_TimeInfo

              horário de check-out do hotel
              horário de check-out indicado na listagem do hotel

              • hour
                Tipo: integer | null

                horas no formato de 24 horas

              • minute
                Tipo: integer | null

                minutos

            • description
              Tipo: string | null

              descrição do hotel
              a descrição da entidade hoteleira para a qual os resultados são coletados

            • domain
              Tipo: string | null

              domínio do hotel
              domínio do site do hotel

            • full_address
              Tipo: string | null

              endereço completo do hotel
              endereço do hotel indicado no formato padronizado

            • popular_amenities
              Tipo: array (object | null)[] | null

              comodidades do hotel
              informações sobre comodidades do hotel rotuladas como "populares"

              • amenity
                Tipo: string | null

                nome padronizado da comodidade

              • amenity_label
                Tipo: string | null

                nome da comodidade exibido

              • hint
                Tipo: string | null

                detalhes padronizados sobre a comodidade

              • hint_label
                Tipo: string | null

                detalhes exibidos sobre a comodidade

              • is_available
                Tipo: boolean | null

                indica se a amenity está disponível no hotel

            • sub_descriptions
              Tipo: array (string | null)[] | null

              descrição adicional do hotel
              detalhes sobre o hotel fornecidos além da descrição

            • url
              Tipo: string | null

              url do hotel
              URL do site do hotel indicado na listagem

          • address
            Tipo: string | null

            endereço do hotel
            endereço físico do hotel

          • 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

          • hotel_identifier
            Tipo: string | null

            identificador recebido em um array POST
            este campo conterá o parâmetro hotel_identifier especificado ao definir uma tarefa;
            exemplo:
            CgoI-KWyzenM_MV3EAE

          • language_code
            Tipo: string | null

            código de idioma em um array POST

          • location
            Tipo: object | null · Response36Afe1097B20_HotelLocationInfo

            informações sobre a localização do hotel
            informações sobre o local onde o hotel está situado

            • latitude
              Tipo: number | null

              latitude do hotel
              coordenadas de latitude da localização do hotel
              exemplo:
              39.4806397

            • location_chain
              Tipo: array (object | null)[] | null

              elementos da cadeia de localização
              parâmetros adicionais de cada elemento da cadeia de localização

              • card_id
                Tipo: string | null

                identificador do card

              • cid
                Tipo: string | null

                ID de cliente
                saiba mais sobre o identificador neste artigo da central de ajuda

              • feature_id
                Tipo: string | null

                identificador do recurso
                saiba mais sobre o identificador neste artigo da central de ajuda

              • title
                Tipo: string | null

                título do elemento na cadeia de localização

            • longitude
              Tipo: number | null

              longitude do hotel
              coordenadas de latitude da localização do hotel
              exemplo:
              -106.0512973

            • maps_url
              Tipo: string | null

              url da localização do hotel no google maps

            • neighborhood
              Tipo: string | null

              nome do bairro onde o hotel está localizado

            • neighborhood_description
              Tipo: string | null

              descrição do bairro onde o hotel está localizado

            • overall_score
              Tipo: number | null

              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

            • score_by_categories
              Tipo: object | null

              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;

              • propertyName
                Tipo: number | null Formato: double
          • location_code
            Tipo: integer | null

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

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

            imagens exibidas na visão geral do hotel
            array contendo URLs de imagens exibidas na visão geral do hotel

          • phone
            Tipo: string | null

            número de telefone do hotel
            número de telefone de contato do hotel

          • prices
            Tipo: object | null · Response36Afe1097B20_HotelPriceInfo

            detalhes de preço da entidade hotel
            contém informações sobre os preços 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 do hotel por critério
            informações sobre as avaliações da entidade 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 e é exibida após as avaliações na ficha resumida do hotel

          • stars_description
            Tipo: string | 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

          • title
            Tipo: string | null

            título do hotel
            o título da entidade hotel para a qual os resultados são coletados

        • 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
Request Example for post/v1/beta/dataforseo/business_data/google/hotel_info/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/live/advanced \
  --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",
    "hotel_identifier": "CgoI-KWyzenM_MV3EAE"
  }
]'

{
  "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]"
            ]
          }
        }
      ]
    }
  ]
}

Operação bem-sucedida

Live Google Hotel Info Advanced