Fornecido por DataForSEO
Encontre resultados do Google Maps por palavra-chave e localização com DataForSEO
Ler os resultados do Google Maps para uma palavra-chave em uma localização, opcionalmente ao redor de uma coordenada ou dentro da área atualmente visível. As linhas são lugares no mapa. 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/serp/google/maps/live/advanced on Glasser.glasser run -p dataforseo -e '/v3/serp/google/maps/live/advanced' -i '{"keyword":"albert einstein","language_code":"en","location_code":2840}' --endpoint-version 7Usa a versão 7 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/serp/google/maps/live/advanced","input":{"keyword":"albert einstein","language_code":"en","location_code":2840},"endpoint_version":7}'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 7 do endpoint; consulte o preço atual antes de executar.
Etapa 2Experimente uma tarefa de exemplo específica
Quando precisar avaliar um local, você pode comparar os detalhes disponíveis do local ou imóvel com os requisitos do seu projeto.
Copie este prompt no seu agente para analisar um local com base nos seus requisitos.
Use dataforseo:/v3/serp/google/maps/live/advanced on Glasser.
Check the returned place or property details against my location requirements.Estrutura do endpoint
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"keyword"
],
"properties": {
"os": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"url": {
"type": "string",
"description": "Direct search URL, parsed into the request by DataForSEO. Paging inside it is billed per page."
},
"depth": {
"type": "integer",
"maximum": 700,
"minimum": 1,
"description": "Results to collect (1-700, default 100). DataForSEO bills each page of up to 100 results."
},
"device": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"keyword": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"se_domain": {
"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"
},
"search_places": {
"type": "boolean"
},
"max_crawl_pages": {
"type": "integer",
"description": "Search result pages to crawl (max 100). DataForSEO bills each page crawled."
},
"search_this_area": {
"type": "boolean"
},
"location_coordinate": {
"type": "string",
"maxLength": 2048,
"minLength": 1
}
},
"additionalProperties": false
}{
"keyword": "albert einstein",
"language_code": "en",
"location_code": 2840
}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.002 |
|---|---|---|
| Máximo por Run | A cobrança total não excederá este valor. | $1.00 |
| 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 |