Metrics

Métricas do Google Search Console pela API

Seu cliente conecta a conta do Google Search Console e seu produto consulta 12 métricas pelo mesmo endpoint das outras plataformas. Cada métrica tem um identificador (reference_key) que vai na chamada.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "comparison_start": "2026-09-01",
  "comparison_end": "2026-09-30",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "search_console:clicks",
      "component": "number_v1",
      "metrics": [
        "clicks"
      ]
    }
  ]
}
Exemplo: "Cliques" em outubro, comparado a setembro.

Mais exemplos de chamadas no Google Search Console

O mesmo endpoint para cada tipo de métrica. Os campos metrics e dimensions de cada item vêm do catálogo da plataforma (GET /api/metrics/{integration_slug}).

Gráfico

Evolução da Posição e CTR

Esse gráfico mostra a evolução da posição e do CTR durante o período analisado.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "search_console:ctr_and_position_over_time",
      "component": "chart_v1",
      "metrics": [
        "ctr",
        "position"
      ],
      "dimensions": [
        "date"
      ]
    }
  ]
}

Tabela

Palavras-chave em Destaque

Estatísticas do seu site, agrupadas pela busca e ordenadas pelos cliques. Essas são as palavras-chaves que retornaram seu site como resposta de uma busca do Google.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "search_console:query",
      "component": "datatable_v1",
      "metrics": [
        "clicks",
        "impressions",
        "ctr",
        "position"
      ],
      "dimensions": [
        "query"
      ]
    }
  ]
}

Número

Impressões

Quantos links para o seu site os usuários viram na página de resultados do Google.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "search_console:impressions",
      "component": "number_v1",
      "metrics": [
        "impressions"
      ]
    }
  ]
}

Números

4 métricas

  • Cliques

    Número de cliques na página de resultados do Google que levaram para seu site.

    search_console:clicks
  • Impressões

    Quantos links para o seu site os usuários viram na página de resultados do Google.

    search_console:impressions
  • CTR (Taxa de Cliques)

    Click-through rate: o número de cliques dividido pela quantidade de impressões.

    search_console:ctr
  • Posição Média

    A posição média do resultado mais alto da página de resultados que leva para o seu site.

    search_console:position

Gráficos

5 métricas

  • Evolução da Posição e CTR

    Esse gráfico mostra a evolução da posição e do CTR durante o período analisado.

    search_console:ctr_and_position_over_time
  • Evolução de Cliques e Impressões

    Esse gráfico mostra a evolução dos cliques e das impressões durante o período analisado.

    search_console:clicks_and_impressions_over_time
  • Cliques e Impressões por Hora

    O gráfico descreve os cliques e as impressões hora a hora. O Search Console fornece dados por hora apenas dos últimos 10 dias, no horário do Pacífico, e as horas mais recentes ainda podem estar incompletas.

    search_console:clicks_and_impressions_by_hour
  • Cliques por Dispositivo

    Número de cliques, agrupados pelo dispositivo que a pessoa estava usando.

    search_console:clicks_by_device
  • Impressões por Dispositivo

    Número de impressões, agrupadas pelo dispositivo que o usuário estava usando.

    search_console:impressions_by_device

Tabelas

3 métricas

  • Palavras-chave em Destaque

    Estatísticas do seu site, agrupadas pela busca e ordenadas pelos cliques. Essas são as palavras-chaves que retornaram seu site como resposta de uma busca do Google.

    search_console:query
  • Páginas em Destaque

    Estatística do seu site, agrupadas pelas páginas e agrupadas pelos cliques. A página é o destino de um link do resultado de uma busca do Google.

    search_console:pages
  • Países em Destaque

    Estatísticas do seu site, agrupadas por país.

    search_console:country

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.