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"
      ]
    }
  ]
}
Ejemplo: "Impresiones" en octubre, comparado con septiembre.

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:impressions
  • Engagement

    El número total de interacciones en tus Pines, incluyendo clics y Pines guardados.

    pinterest:engagement
  • Tasa 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_rate
  • Clics

    El número de clics en tus pines durante el período de análisis.

    pinterest:clicks
  • Tasa 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_rate
  • Total de Pines Guardados

    Número total de veces que sus pins fueron guardados por otros usuarios (repins) durante el período analizado.

    pinterest:saved
  • Total de Pines

    Número total de pins publicados en la cuenta.

    pinterest:total_pins
  • Pins 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_pins
  • Total 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_format
  • Impresiones por plataforma

    El número de veces que sus pins fueron vistos por plataforma.

    pinterest:impressions_by_platform
  • Interacció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:pins
  • Tableros 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.