Metrics
Métricas de Pinterest con la API
Tu cliente conecta su cuenta de Pinterest y tu producto consulta 14 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.
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"
]
}
]
}Más ejemplos de llamadas a Pinterest
El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Impresiones por formato
El número de veces que sus pins fueron 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"
]
}
]
}Tabla
Pins destacados
Desempeño de los Pins de su cuenta en el período analizado, independientemente de cuándo fueron publicados. Esta tabla muestra datos solo de "sus pins", no incluye "otros 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
Engagement
El número total de interacciones en tus Pines, incluyendo clics y Pines guardados.
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
Impresiones
El número de veces que se vieron tus pines durante el período de análisis.
pinterest:impressionsEngagement
El número total de interacciones en tus Pines, incluyendo clics y Pines guardados.
pinterest:engagementTasa de interaccíon
El total de interacciones con sus Pins dividido por el número total de veces que sus Pins fueron vistos. Las interacciones incluyen Pins guardados, clics en el Pin y clics de salida
pinterest:engagement_rateClics
El número de clics en tus pines durante el período de análisis.
pinterest:clicksTasa de Clics en Pines
El número total de clics en su Pin para acceder a contenido dentro o fuera de Pinterest, dividido por el número total de veces que sus Pins aparecieron en pantalla.
pinterest:clicks_rateTotal de Pines Guardados
Número total de veces que sus pins fueron guardados por otros usuarios (repins) durante el período analizado.
pinterest:savedTotal de Pines
Número total de pins publicados en la cuenta.
pinterest:total_pinsPins publicados
Número de Pins publicados durante el período analizado, considerando solo el contenido visible al público. Los Pins protegidos o con visibilidad restringida no están incluidos.
pinterest:total_period_pinsTotal de Tableros
Número total de tableros creados durante el período analizado.
pinterest:total_boards
Gráficos
3 métricas
Impresiones por formato
El número de veces que sus pins fueron vistos por formato.
pinterest:impressions_by_pin_formatImpresiones por plataforma
El número de veces que sus pins fueron vistos por plataforma.
pinterest:impressions_by_platformInteracción por formato
El número total de interacciones en sus Pins, por formato, incluyendo clics y Pins guardados.
pinterest:engagement_by_pin_format
Tablas
2 métricas
Pins destacados
Desempeño de los Pins de su cuenta en el período analizado, independientemente de cuándo fueron publicados. Esta tabla muestra datos solo de "sus pins", no incluye "otros pins".
pinterest:pinsTableros destacados
Tableros que tuvieron mayor impacto en su audiencia.
pinterest:boards
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
