Fornecido por DataForSEO
Encontre hotéis na Pesquisa de Hotéis do Google com o DataForSEO
Pesquisar no Google Hotels os hotéis listados em uma localização e idioma, opcionalmente para uma frase de pesquisa, com datas de check-in e check-out e quantidade de hóspedes definidas, refinados por categoria de estrelas, avaliação mínima, faixa de preço, cancelamento grátis, aluguéis por temporada ou comodidades, em até 140 hotéis. Uma linha por hotel: seu identificador, nome, categoria de estrelas, indicação de anúncio pago, coordenadas do mapa, pontuação de avaliação com quantidade de votos e imagens de apresentação. Uma solicitação por chamada, com preço 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_searches/live on Glasser.glasser run -p dataforseo -e '/v3/business_data/google/hotel_searches/live' -i '{"language_code":"en","location_code":1023191}' --endpoint-version 6Usa a versão 6 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_searches/live","input":{"language_code":"en","location_code":1023191},"endpoint_version":6}'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 6 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_searches/live 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#",
"properties": {
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"depth": {
"type": "integer",
"maximum": 140,
"minimum": 1,
"description": "Results to collect (1-140, default 18). DataForSEO bills each page of up to 18 results."
},
"stars": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"maxItems": 100,
"minItems": 1
},
"adults": {
"type": "integer"
},
"keyword": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"sort_by": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"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
},
"amenities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"maxItems": 100,
"minItems": 1
},
"check_out": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"max_price": {
"type": "integer"
},
"min_price": {
"type": "integer"
},
"min_rating": {
"anyOf": [
{
"type": "number"
},
{
"enum": [
"Infinity",
"-Infinity",
"NaN"
],
"type": "string"
}
]
},
"language_code": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_name": {
"type": "string"
},
"location_code": {
"type": "integer"
},
"location_name": {
"type": "string"
},
"search_this_area": {
"type": "boolean"
},
"free_cancellation": {
"type": "boolean"
},
"is_vacation_rentals": {
"type": "boolean"
},
"location_coordinate": {
"type": "string",
"maxLength": 2048,
"minLength": 1
}
},
"additionalProperties": false
}{
"language_code": "en",
"location_code": 1023191
}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
| Entrada de tamanho padrão | Entradas maiores e opções pagas variam conforme o uso do provedor de dados. O mesmo preço com ou sem dados correspondentes. | $0.004 |
|---|---|---|
| Máximo por Run | A cobrança total não excederá este valor. | $0.16 |
| 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 |