Skip to content
Schedule Social Media

Press Esc to close.

New feature Pinterest Severity: medium

Pinterest adds a multiple Pin analytics endpoint for up to 100 Pins per request

AnnouncedMar 2024
EffectiveMar 2024
PlatformPinterest

What changed

Pinterest's changelog lists Multiple Pin analytics under pins and boards in March 2024. The endpoint, GET /v5/pins/analytics (multi_pins/analytics), first appears in Pinterest's public OpenAPI spec in v5.13.0, published April 23, 2024. It returns metrics for up to 100 Pin IDs over a date range starting no more than 90 days back, and the spec still describes it as in beta and not available to all apps. The organic analytics guide calls it Pinterest's most performant option for Pin metrics at scale. The changelog entry text was not readable, so the launch day is not stated.

What it means

Analytics tools can fetch organic metrics for up to 100 Pins in one call instead of one call per Pin, but the endpoint is still marked beta and not available to all apps.

Who is affected

Schedulers and reporting tools that show per-Pin organic performance, and agencies that report on many Pins at once.

What to do by Mar 2024

If your app has access, switch per-Pin loops to GET /v5/pins/analytics with up to 100 pin_ids. Keep the single Pin endpoint as a fallback for apps without beta access.

What this means for you

Apps that show how your Pins are doing used to ask Pinterest about each Pin one at a time. Since 2024, they can ask about up to 100 Pins at once. That makes reports faster and less likely to hit Pinterest's limits on how often an app can ask. Not every app is allowed to use it yet, so your tool may still load Pin stats the slow way.

The details

  • Endpoint: GET /v5/pins/analytics, operation multi_pins/analytics.
  • Required parameters: pin_ids (1 to 100 IDs), start_date and end_date (YYYY-MM-DD, UTC; the start date cannot be more than 90 days back) and metric_types. Optional: app_types (ALL, MOBILE, TABLET, WEB) and ad_account_id for Business Access.
  • Metrics (v5.28.0): IMPRESSION, OUTBOUND_CLICK, PIN_CLICK, SAVE, SAVE_RATE, TOTAL_COMMENTS, TOTAL_REACTIONS, USER_FOLLOW, PROFILE_VISIT and the video metrics VIDEO_MRC_VIEW, VIDEO_10S_VIEW, QUARTILE_95_PERCENT_VIEW, VIDEO_V50_WATCH_TIME, VIDEO_START, VIDEO_AVG_WATCH_TIME.
  • Scopes: boards:read and pins:read, with an OAuth user token or a Client Credentials token.
  • Rate limit category: org_analytics, which the rate limits page sets at 60 requests per minute per user per app on Standard access and 1,000 per day on Trial access.
  • Access: the spec says "This endpoint is currently in beta and not available to all apps", both in v5.13.0 and in v5.28.0 (June 2026).
  • Lifetime metrics: for Pins created before 2023-03-20, lifetime metrics are only available for Video and Idea Pins.
  • Single Pin endpoint: GET /v5/pins/{pin_id}/analytics (pins/analytics) remains.

What to do next

  • Business owners: Nothing.
  • Marketers and agencies: If Pin reports in your tool are slow or patchy, ask whether it uses Pinterest's multiple Pin analytics endpoint.
  • Developers: Batch Pin IDs in groups of up to 100 where you have access, and fall back to pins/analytics for apps that lack beta access.

Primary sources

Checked against the source 7 Nov 2026

Get an email when a new API change is added

Follow new entries with the RSS feed. Each platform also has its own feed, for example X or Meta.