Fornecido por DataForSEO
Consulta a visão geral mensal da classificação de um domínio no Google com o DataForSEO
Ler como as classificações e o tráfego de um domínio no Google variaram ao longo dos meses de um intervalo de datas, em uma localização e idioma. Informe um domínio e as datas inicial e final; cada linha corresponde a um mês com a distribuição de classificações do domínio, o tráfego orgânico e pago estimado e as contagens de palavras-chave novas, que subiram, que caíram e perdidas. Os domínios são lidos um por vez. 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/dataforseo_labs/google/historical_rank_overview/live on Glasser.glasser run -p dataforseo -e '/v3/dataforseo_labs/google/historical_rank_overview/live' -i '{"target":"dataforseo.com","date_to":"2025-06-01","date_from":"2025-01-01","language_code":"en","location_code":2840}' --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/dataforseo_labs/google/historical_rank_overview/live","input":{"target":"dataforseo.com","date_to":"2025-06-01","date_from":"2025-01-01","language_code":"en","location_code":2840},"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 analisar o desempenho de SEO de um domínio, você pode reunir as métricas disponíveis em um panorama para suas notas de pesquisa.
Copie este prompt no seu agente para preparar um panorama de SEO do seu domínio.
Use dataforseo:/v3/dataforseo_labs/google/historical_rank_overview/live on Glasser.
Pull returned SEO metrics for my domain into a research snapshot.Estrutura do endpoint
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"target",
"date_from",
"date_to"
],
"properties": {
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"target": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"date_to": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"correlate": {
"type": "boolean"
},
"date_from": {
"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"
},
"ignore_synonyms": {
"type": "boolean"
},
"include_clickstream_data": {
"type": "boolean",
"description": "Add clickstream-based metrics. DataForSEO doubles the price of the call."
}
},
"additionalProperties": false
}{
"target": "dataforseo.com",
"date_to": "2025-06-01",
"date_from": "2025-01-01",
"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. | $0.138 |
|---|---|---|
| Máximo por Run | A cobrança total não excederá este valor. | $0.276 |
| Nenhum dado correspondente | O provedor de dados respondeu: nada correspondeu. | $0.12 |
| 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 |