Fornecido por DataForSEO
Obter detalhes de um hotel no Google usando um identificador de hotel com DataForSEO
Ler a entrada do Google Hotels de um hotel, identificada pelo identificador do hotel, para uma localização e idioma, opcionalmente para datas de check-in e check-out e quantidade de hóspedes informadas. A resposta é esse único hotel: nome, categoria de estrelas, endereço, descrição, site, comodidades, bairro, pontuações de localização para atividades, restaurantes, transporte público e acesso ao aeroporto, coordenadas no mapa, pontuação de avaliações com contagem de votos e distribuição das classificações, além de imagens gerais. Uma solicitação por chamada, cobrada conforme a tabela de preços do próprio fornecedor; um conjunto de resultados vazio é informado como nenhum resultado.
Como executar
Etapa 1Configurar
Uma vez: cole isto no chat do seu agente. O Skill instala a CLI e faz login sozinho. Para um agente que não pode usar um shell, conecte-o pelo MCP.
set up https://glasser.ai/SKILL.md
Show me how to use the DataForSEO endpoint /v3/business_data/google/hotel_info/live/advanced on Glasser.glasser run -p dataforseo -e '/v3/business_data/google/hotel_info/live/advanced' -i '{"language_code":"en","location_code":1023191,"hotel_identifier":"CgoI-KWyzenM_MV3EAE"}' --endpoint-version 2Usa a versão 2 do endpoint. Consulte o preço atual antes de executar. Instale e faça login primeiro em Get Started.
Uma vez por Run:
IDEMPOTENCY_KEY=$(uuidgen)Execute e copie este mesmo bloco para enviá-lo novamente:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"dataforseo","endpoint":"/v3/business_data/google/hotel_info/live/advanced","input":{"language_code":"en","location_code":1023191,"hotel_identifier":"CgoI-KWyzenM_MV3EAE"},"endpoint_version":2}'Reutilize a mesma Idempotency-Key para enviar novamente: o segundo envio é uma leitura do primeiro Run. Uma nova chave cria um novo Run e um novo Charge. Usa a versão 2 do endpoint; consulte o preço atual antes de executar.
Etapa 2Experimente uma tarefa de exemplo específica
Quando precisar qualificar potenciais clientes, você pode comparar as informações das empresas com seus critérios de cliente ideal para decidir quais contas pesquisar em seguida.
Copie este prompt no seu agente para analisar empresas com base nos seus critérios de cliente ideal.
Use dataforseo:/v3/business_data/google/hotel_info/live/advanced on Glasser.
Check the returned company data against my ideal-customer criteria.Estrutura do endpoint
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"hotel_identifier"
],
"properties": {
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"adults": {
"type": "integer"
},
"check_in": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"children": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"maxItems": 100,
"minItems": 1
},
"currency": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"check_out": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_code": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_name": {
"type": "string"
},
"location_code": {
"type": "integer"
},
"location_name": {
"type": "string"
},
"prices_end_date": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"hotel_identifier": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"prices_date_range": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"prices_start_date": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"location_coordinate": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"load_prices_by_dates": {
"type": "boolean"
}
},
"additionalProperties": false
}{
"language_code": "en",
"location_code": 1023191,
"hotel_identifier": "CgoI-KWyzenM_MV3EAE"
}Este endpoint não publica um esquema de saída. Você recebe o corpo da resposta do próprio provedor de dados, sem alterações — não garantimos um formato que não podemos assegurar.
Como funciona a cobrança
| Dados retornados ou nenhuma correspondência | O mesmo preço com ou sem dados correspondentes. | $0.004 |
|---|---|---|
| Erro do provedor de dados | O provedor de dados não conseguiu responder. | $0.00 |
| Tempo limite excedido | O Run excedeu seu limite de tempo. | $0.00 |
| Falha interna | Um erro interno impediu a conclusão. | $0.00 |