ZEzernio
Analytics

Get Pinterest account-level insights

Changed on

Returns account-level daily Pinterest metrics, read live from Pinterest's account analytics, plus the follower history from Zernio's daily snapshots.

These are account totals. They include every pin on the account, also pins published long before the account was connected to Zernio, which per-post analytics cannot cover.

  • Response shape matches /v1/analytics/instagram/account-insights.
  • Defaults to the last 30 days. Pinterest serves at most the last 89 days, so a fromDate older than that returns 400.
  • Pinterest reports the latest 1-2 days as still processing. Those days are left out of values and totals until Pinterest settles them.
get/v1/analytics/pinterest/account-insights

Request

Query parameters

accountIdstring required

The Zernio SocialAccount ID for the Pinterest account.

metricsstring

Comma-separated list. Defaults to "impressions,engagements,follower_count".

Live from Pinterest, one value per day:

  • impressions
  • engagements
  • saves
  • pin_clicks
  • outbound_clicks

From Zernio daily snapshots:

  • follower_count (follower count per day; total is the latest)
  • followers_gained (sum of positive daily follower deltas)
  • followers_lost (sum of absolute negative daily deltas)
fromDatestring date

Start date (YYYY-MM-DD). Defaults to 30 days ago. At most 89 days before today.

toDatestring date

End date (YYYY-MM-DD). Defaults to today.

sincestring date

Alias of fromDate, kept for existing callers

untilstring date

Alias of toDate, kept for existing callers

metricType'time_series' | 'total_value'

"total_value" returns one total per metric. "time_series" also returns the daily values.

Response

Account insights data

successboolean
accountIdstring

The Zernio SocialAccount ID

platform'facebook' | 'instagram' | 'youtube' | 'linkedin' | 'tiktok' | 'pinterest'

Platform that served this response.

metricType'time_series' | 'total_value'
breakdownstring

Breakdown dimension used (only present when breakdown was requested)

metricsobject

Object keyed by metric name.

  • For time_series: each metric has "total" (number) and "values" (array of {date, value}).
  • For total_value: each metric has "total" (number) and optionally "breakdowns" (array of {dimension, value}).

Monetary metrics also carry "unit" and "currency". Zernio never rescales money: "total" and every "values[].value" are the platform's raw numbers in the stated unit.

Monetary metrics keep "values" even on metricType=total_value, because their "total" is the sum of the daily buckets the platform returned over the range. Keep the series to reconcile that sum against the platform's own reporting before invoicing on it.

A metric that could not be served is absent from this object and listed in "unavailableMetrics" instead, so an unavailable metric is never reported as a zero.

dataDelaystring

Example response

{
  "success": true,
  "dataDelay": "Data may be delayed up to 48 hours"
}

Changes

  • d568bb00ed73Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 3377f30cc94fRevision changes
    • info

      endpoint added