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"
]
}
]
}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:impressionsEngajamento
O número total de engajamentos nos seus Pins, incluindo cliques e Pins salvos
pinterest:engagementTaxa 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_rateCliques
Número de cliques em seus pint durante o período de análise.
pinterest:clicksTaxa 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_rateTotal de pins salvos
Número total de vezes que seus pins foram salvos por outros usuários (repins) durante o período analisado.
pinterest:savedTotal de pins
Número total de pins postados na conta.
pinterest:total_pinsPins 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_pinsTotal 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_formatImpressões por plataforma
O número de vezes que seus pins foram vistos por plataforma.
pinterest:impressions_by_platformEngajamento 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:pinsBoards 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.
