Do not store API data
You may not store information accessed through Pinterest Materials, including the API, except campaign analytics for your own account or an account that expressly granted access; call the API each time instead. [4]
Guides · social · Popular APIs
Pinterest API (v5)
Business account, a reviewed app with Trial access, then an upgrade review (with a demo video) for Standard access. Gives an app id and app secret for OAuth 2.
Researched · not yet run liveLast researched 25 October 2026 · Pinterest · provider site
Researched, not yet run live. Built from the provider’s official pages (linked below). A person hasn’t walked this flow end to end yet, so check each step against the source.
Who owns what
A Pinterest business account administers the developer app; apps start in Trial and can be upgraded to Standard.
- Pinterest business account organisation owned by the company (or the person)Used to administer the app; its email must be verified.
- Developer app developer · under Pinterest business accountHas an app id (client id) and app secret; access tier is Trial or Standard.
Have ready
- A Pinterest business account with a verified email
- A clear, detailed app description and use case: A vague description is a listed reason for upgrade denial.
- Privacy policy URL that loads fully, is public, and sits on a domain tied to your company or app · Required in the app request and checked again for the Standard upgrade [2]Needed for: Request Trial access (Connect app), Upgrade to Standard access
- Screen recording of your app completing an action through the API, showing the OAuth user authentication flow and the live integration · Required for the Standard access upgrade; wireframes or generic demos do not qualify, terminal or Postman recordings are accepted [2]Needed for: Upgrade to Standard access
Steps
Steps marked “human step” are ones only you can do: verapli never signs in, submits, pays or accepts terms for you.
Sign in to (or create) a Pinterest business account
You log in or create the business account yourself, then verify its email.
Where: https://www.pinterest.com/business/create/?next=https://developers.pinterest.com/account-setup/
Accept the Developer Terms of Service
In My apps, you read and accept Pinterest's Developer Terms of Service.
Where: https://developers.pinterest.com/apps/
Request Trial access (Connect app)
Select Connect app and complete the request form. The app name needs at least 3 Latin letters or numbers and cannot contain "Pinterest". You press submit; Pinterest reviews it and emails you.
- The provider says
- Pinterest reviews the request and emails you after review; no time stated on the page [to verify] [1]
Where: https://developers.pinterest.com/apps/
Copy the app id and app secret
Once Trial is approved, the app id and app secret appear on My apps (the secret is hidden while pending).
verapli captures
PINTEREST_APP_IDhere by plain code: encrypted in your browser, never shown to AI.Where: https://developers.pinterest.com/apps/
Store the app secret
Copy the app secret from My apps into your env file.
verapli captures
PINTEREST_APP_SECREThere by plain code: encrypted in your browser, never shown to AI.Where: https://developers.pinterest.com/apps/
Add your redirect URI
In My apps > Manage > Configure, add the redirect URI. OAuth requests must use it exactly, and it must not redirect again.
Where: https://developers.pinterest.com/apps/
Upgrade to Standard accessoptional
For production or offering Pinterest features to users, select Upgrade on the app card, confirm your use case and privacy policy link, upload the demo video and submit. Pinterest reviews and emails a decision.
- The provider says
- Upgrade requests are reviewed regularly; decision by email; no time stated [2]
If something goes wrong (3)
- Upgrade denied because the video lacks the authentication flow or a live integration: Re-record showing the full OAuth user authentication flow and a real API action in your app [2]
- Upgrade denied for using login credentials or session cookies: Use OAuth access tokens only [2]
- Denial you think is wrong: Appeal by submitting a ticket through the Help Center and allow a few days before following up [2]
Where: https://developers.pinterest.com/apps/
Terms and gotchas
Plain-English summary, not legal advice. Each card links its source.
No sharing, selling or AI training
Do not share or sell API information with third parties (including other ad services), and do not use Pinterest Materials to train, fine-tune or improve AI without Pinterest's express permission. [4]
Commercial and analytics uses are restricted
Accepted integrations include advertising, merchant, creator and measurement tools. Platform insights, benchmarking or competitor research need explicit written authorization. Ad services must show their own fees separately from Pinterest advertising. Scraping is not allowed and apps for under-13s are not permitted. [4]
Trial is not for production
Trial is limited to 1,000 requests/day per app and Pins/Boards it creates are Sandbox entities visible only to the creator. Standard access is recommended for production. [2]
New apps may lack access to non-business users' Pins and boards
Apps registered on or after 2026-09-14 may get HTTP 403 PINNER_DATA_ACCESS_DENIED when requesting boards or Pins of non-business users without Pinterest's authorization. [2]
Deletion duties
Delete Pinterest data within 30 days of termination, Pinterest's request, or a user revoking consent, and certify deletion if asked. Pinterest may suspend or end access at any time. [to verify against live terms] [5]
What you end up with
| Env var | Secret | Format | What it is |
|---|---|---|---|
PINTEREST_APP_ID | not secret | numeric id, e.g. 15… | App id (also used as OAuth client id) |
PINTEREST_APP_SECRET | secret | hex string, e.g. 3f… | App secret used for the OAuth token exchange |
Pricing
- Free tier: No API fee found; Trial 1,000 requests/day per app, Standard 100 requests/second per user per app
- No Pinterest API price list was found in official docs [to verify].
Source [3]
For agents
The same entry as JSON: /api/v1/entries/pinterest/api · requirements /api/v1/requirements/pinterest/api · terms /api/v1/terms/pinterest/api.
Remote MCP (read-only, no auth)
claude mcp add --transport http verapli https://verapli.com/mcp
> "What do I need for Pinterest API (v5), and how long will it take?"
→ tools/call requirements { "provider_id": "pinterest/api" }Sources
- Pinterest Developers – Connect your app Business account administers the app; verify email; accept Developer Terms in My apps; Connect app request form; app name rules; Pinterest reviews the request and emails the result; app id and app secret shown in My apps once approved for Trial; redirect URIs in Manage > Configure must match exactly with no secondary redirect · accessed 25 October 2026 · official
- Pinterest Developers – Understanding our access tiers Trial vs Standard; upgrade via My apps > Upgrade with use case, privacy policy link and video demo of the OAuth flow and live integration; privacy policy must be public and on your domain; denial reasons; reviewed regularly with email decision; Trial Pins/Boards are Sandbox entities; apps registered on or after 2026-09-14 may get 403 PINNER_DATA_ACCESS_DENIED for non-business users' boards or Pins without authorization · accessed 25 October 2026 · official
- Pinterest Developers – Rate limits Trial 1,000 requests/day per app; Standard 100 requests/second per user per app, with per-category per-minute limits; limits change without notice · accessed 25 October 2026 · official
- Pinterest – Developer guidelines Permitted integration types; no storing API data except own campaign analytics; no sharing or selling API data; no AI training without express permission; no scraping; no apps for under-13s; platform insights or competitor research need written authorization; privacy policy link needed when applying; ad fees shown separately · accessed 25 October 2026 · official
- Pinterest – Developer and API Terms of Service Delete Pinterest data within 30 days of termination, Pinterest request or user revoking consent; written certification on request; Pinterest may suspend or terminate at any time; developer may terminate with 90 days' notice. Page is script-rendered; read via search index [to verify] · accessed 25 October 2026 · official
Provider rules change. This page is generated from verapli registry version 2026.1025.316; spotted something out of date? Tell us. Pinterest is not affiliated with verapli.