Pinterest adds a multiple Pin analytics endpoint for up to 100 Pins per request
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, operationmulti_pins/analytics. - Required parameters:
pin_ids(1 to 100 IDs),start_dateandend_date(YYYY-MM-DD, UTC; the start date cannot be more than 90 days back) andmetric_types. Optional:app_types(ALL,MOBILE,TABLET,WEB) andad_account_idfor Business Access. - Metrics (v5.28.0):
IMPRESSION,OUTBOUND_CLICK,PIN_CLICK,SAVE,SAVE_RATE,TOTAL_COMMENTS,TOTAL_REACTIONS,USER_FOLLOW,PROFILE_VISITand the video metricsVIDEO_MRC_VIEW,VIDEO_10S_VIEW,QUARTILE_95_PERCENT_VIEW,VIDEO_V50_WATCH_TIME,VIDEO_START,VIDEO_AVG_WATCH_TIME. - Scopes:
boards:readandpins: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/analyticsfor apps that lack beta access.
Primary sources
- Pinterest Developers: Changelog, Multiple Pin analytics (March 2024)
- Pinterest Developers: Organic analytics
- Pinterest API description (GitHub): OpenAPI spec v5.28.0
- Pinterest Developers: Rate limits
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.