Metrics

Métricas do Pinterest pela API

Seu cliente conecta a conta do Pinterest e seu produto consulta 14 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": "pinterest:impressions",
      "component": "number_v1",
      "metrics": [
        "impression"
      ],
      "dimensions": [
        "user"
      ]
    }
  ]
}
Exemplo: "Impressões" em outubro, comparado a setembro.

Mais exemplos de chamadas no Pinterest

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

Impressões por formato

O número de vezes que seus pins foram vistos por formato.

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": "pinterest:impressions_by_pin_format",
      "component": "chart_v1",
      "metrics": [
        "impression"
      ],
      "dimensions": [
        "pin_format"
      ]
    }
  ]
}

Tabela

Pins em destaque

Desempenho dos Pins da sua conta no período analisado, independente de quando foram postados. Essa tabela traz dados apenas de "seus pins", não inclui "outros pins".

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": "pinterest:pins",
      "component": "datatable_v1",
      "metrics": [
        "description",
        "impression",
        "save",
        "created_at"
      ],
      "dimensions": [
        "board_pin"
      ]
    }
  ]
}

Número

Engajamento

O número total de engajamentos nos seus Pins, incluindo cliques e Pins salvos

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": "pinterest:engagement",
      "component": "number_v1",
      "metrics": [
        "engagement"
      ],
      "dimensions": [
        "user"
      ]
    }
  ]
}

Números

9 métricas

  • Impressões

    O número de vezes que seus pins foram vistos durante o período de análise.

    pinterest:impressions
  • Engajamento

    O número total de engajamentos nos seus Pins, incluindo cliques e Pins salvos

    pinterest:engagement
  • Taxa de engajamento

    O total de engajamentos com seus Pins dividido pelo número total de vezes que seus Pins foram vistos. Os engajamentos incluem Pins salvos, cliques no Pin e cliques de saída

    pinterest:engagement_rate
  • Cliques

    Número de cliques em seus pint durante o período de análise.

    pinterest:clicks
  • Taxa de clique nos pins

    O número total de cliques no seu Pin para acessar conteúdo dentro ou fora do Pinterest, dividido pelo número total de vezes que seus Pins apareceram na tela.

    pinterest:clicks_rate
  • Total de pins salvos

    Número total de vezes que seus pins foram salvos por outros usuários (repins) durante o período analisado.

    pinterest:saved
  • Total de pins

    Número total de pins postados na conta.

    pinterest:total_pins
  • Pins publicados

    Número de Pins publicados no período analisado, considerando apenas conteúdos visíveis ao público. Pins protegidos ou com visibilidade restrita não são incluídos.

    pinterest:total_period_pins
  • Total de boards

    Número total de boards (quadros) criados durante o período analisado.

    pinterest:total_boards

Gráficos

3 métricas

  • Impressões por formato

    O número de vezes que seus pins foram vistos por formato.

    pinterest:impressions_by_pin_format
  • Impressões por plataforma

    O número de vezes que seus pins foram vistos por plataforma.

    pinterest:impressions_by_platform
  • Engajamento por formato

    O número total de engajamento nos seus Pins, por formato, incluindo cliques e Pins salvos.

    pinterest:engagement_by_pin_format

Tabelas

2 métricas

  • Pins em destaque

    Desempenho dos Pins da sua conta no período analisado, independente de quando foram postados. Essa tabela traz dados apenas de "seus pins", não inclui "outros pins".

    pinterest:pins
  • Boards em destaque

    Boards que tiveram maior impacto em sua audiência.

    pinterest:boards

Veja o Connect aplicado ao seu produto.

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