How to get a Pinterest API key (2026)

How to get a Pinterest API key in 2026: request an app with a business account, Trial vs Standard access, the 1,000-a-day trial cap, and when Social Fetch fits.

Social FetchUpdated

People who search for a "Pinterest API key" usually want one of two things. One is Pinterest's official API, for an app that creates pins, manages boards or reads a business's own analytics. The other is public pins and boards for trend research, product discovery or competitor tracking. Both are covered here, with Pinterest's process as of November 2026.

The short answer: log in with a Pinterest business account, accept the Developer Terms of Service on My apps and select Connect app to request access. If Pinterest approves Trial access, the app ID and app secret appear in My apps. Trial access is capped at 1,000 requests a day. A Social Fetch key is a separate credential for public Pinterest data.

Two different things called a Pinterest API key

Pinterest API v5Social Fetch Pinterest routes
What you getAn app ID and app secret, then OAuth access tokensOne sfk_… key
How you get itRequest an app with a business account; Pinterest reviews itCreate it on the API Keys page
Creating pins, managing boards, adsYes, within your access tierNo
Public pin search, pins and boardsWithin the scopes your users grantYes
Trial limits1,000 requests per day; created pins are sandbox-onlyNot applicable
LimitsDaily (Trial) or per-minute (Standard) by categoryCredits and available service capacity

See the Pinterest platform page for every Social Fetch route, and Pinterest API pricing for a longer cost comparison.

How to get an official Pinterest API key

Pinterest's connect app guide sets out these steps as of November 2026:

  1. Use a business account. Log in to Pinterest with a business account, or create one. This account administers the app. Verify its email address.
  2. Accept the terms. Go to My apps and click through to accept the Developer Terms of Service.
  3. Request the app. Select Connect app and complete the request form. The app name needs at least three Latin letters or numbers and can't contain the word "Pinterest". Submit the request for Trial access.
  4. Wait for review. Pinterest reviews each request and emails you when it's done. It doesn't publish a timeframe.
  5. Copy your credentials. If the app is approved for Trial access, open My apps to find its unique app ID and app secret.

Requests then carry an OAuth access token for the Pinterest user who authorised your app. With a token in PINTEREST_ACCESS_TOKEN:

Request
bash

The app secret is for your server only. Keep it out of browser code and source control, and request only the OAuth scopes your app uses.

Pinterest app ID vs access token

Pinterest doesn't issue one "API key". What tutorials mean is one of:

  • the app ID, which identifies your app in the OAuth flow;
  • the app secret, used server-side to exchange an authorisation code for tokens;
  • an access token, which a Pinterest user grants your app and which authorises each request to api.pinterest.com/v5.

The token reaches what the user granted under the scopes you requested. Your app ID alone does not authenticate a request.

Trial vs Standard access

Pinterest's access tiers page describes two tiers:

  • Trial access comes with an approved app and is meant for exploring the API. Most read and create actions work, but Pins and boards created with Trial access are only visible to their creator, as sandbox entities.
  • Standard access is what Pinterest recommends if you want to offer Pinterest features to your users. Boards and Pins are created with full visibility, and rate limits are higher.

To upgrade, your app must already have Trial access and follow the Developer Guidelines. Record a video of your app completing an action with the Pinterest API, including the OAuth flow (Pinterest asks for this even if you are the only user). Then open My apps, select Upgrade on the app card (it only appears for eligible apps), check your use case and privacy policy link, upload the video and submit. Pinterest names an inaccessible or inaccurate privacy policy as a reason for denial: the link must load fully, be public, and sit on a domain tied to your company or app.

Is the Pinterest API free?

Pinterest's developer docs describe access in tiers granted by review rather than a price per request. The cost is approval: a reviewed app request for Trial access, then a video demo and a working privacy policy for Standard access. Until you have Standard access, anything your app creates stays in sandbox.

Pinterest API rate limits

Pinterest's rate limits page sets these as of November 2026:

CategoryTrial accessStandard access
All API requests1,000 per dayBy category, below
org_read1,000 per day1,000 per minute, per user, per app
ads_read1,000 per day1,000 per minute, per user, per app
org_analytics1,000 per day60 per minute, per user, per app

Responses carry x-ratelimit-limit, x-ratelimit-remaining and x-ratelimit-reset headers so you can slow down before you hit the cap. Pinterest says limits can change without notice.

Social Fetch's Pinterest routes have no daily request quota; requests spend credits. When capacity is full, a request may return 503 temporarily_unavailable with a Retry-After header, which isn't charged. See Credits and Errors.

Get a Social Fetch key for public Pinterest data

Social Fetch's Pinterest routes accept a Social Fetch key, so you don't need a business account, app review or a user's OAuth token. They return public data as JSON. The key does not grant any permission under Pinterest's terms; check those for your use.

  1. Create a free account or sign in.
  2. Open API Keys, type a name for the key and click Create key.
  3. Copy the key from the Save your API key window. It starts with sfk_ and is shown only once.
  4. Try a search in the Playground: the link fills in small kitchen ideas. Click Send. The Playground uses your signed-in workspace and spends its credits; you do not paste a key.
  5. Store the key in an environment variable named SOCIALFETCH_API_KEY and call the routes from your own code. Keep it on your server, out of public repositories and browser code.
Request
bash

Each endpoint page shows what a lookup costs, and successful responses say what they cost in meta.creditsCharged. Lookups that fail (502 lookup_failed, 503 temporarily_unavailable) are free. Plans and credit packs are on Pricing.

The Pinterest routes:

The full list is on the Pinterest platform page and in the Pinterest API reference. These routes read public data only; secret boards and anything that needs a Pinterest login are out of reach.

Which key do you need?

Get a Pinterest developer app when your product works for Pinterest users: publishing pins, managing boards, running ads or showing a business its own analytics. Plan for Trial review, then the Standard upgrade before your users see anything you create.

Use a Social Fetch key when the job is reading public pins and boards: trend and product research, competitor boards, or feeding pin data into a listening dashboard alongside other networks. The same split applies elsewhere; the Reddit API key guide walks through it for Reddit.

FAQ

How do I get a Pinterest API key?

Log in to Pinterest with a business account and verify its email, go to My apps on developers.pinterest.com and accept the Developer Terms of Service, then select Connect app and submit the request form. Pinterest reviews the request and emails you. If it approves Trial access, your app ID and app secret are in your My apps view.

What is the difference between Pinterest Trial and Standard access?

Trial access is for exploring the API: most read and create actions work, but Pins and boards you create are only visible to you as sandbox entities, and all requests are capped at 1,000 per day. Standard access gives full visibility and higher limits. You request it from the Upgrade button in My apps with a video of your app completing an action, including the OAuth flow.

Is the Pinterest API free?

Pinterest's developer docs describe access in tiers granted by review rather than a price per request. The cost is approval: a reviewed app request for Trial access, then a video demo and a working privacy policy for Standard access.

What are the Pinterest API rate limits?

As of November 2026 Pinterest's rate limits page caps Trial access at 1,000 requests per day for all API requests. Standard access limits are per minute, per user and per app, by category; for example org_read is 1,000 per minute and org_analytics 60 per minute.

Do I need a Pinterest developer app to use Social Fetch?

No. Social Fetch's Pinterest routes take a Social Fetch key (it starts with sfk_) in the x-api-key header. They return public pin search results, pins, profile boards and board pins without a Pinterest business account, app review or OAuth, and they cannot create pins or manage boards.

Share this article