↑ ↓ to move ↵ to open
Social & content · REST API · MCP server

Pinterest Scraper API

Get public Pinterest profiles, boards, sections and pins as clean JSON, up to whole boards of thousands of pins. Send a profile, board or pin link. No Pinterest login.

  • 1 credit per call
  • Failed calls are free
  • Updated
pinterest.board-info.get 133 rows completed
# Section Pins Link Slug Board id Id User id
1 Happy homebody aesthetic 70 https://www.pinterest.com/pinterest/aesthetics/happy-homebody-a… happy-homebody-aesthetic 424605139807959315 5476669214353860495 424605208526455283
2 Animal print everything 90 https://www.pinterest.com/pinterest/aesthetics/animal-print-eve… animal-print-everything 424605139807959315 5469776547382628375 424605208526455283
3 Friendsmas 51 https://www.pinterest.com/pinterest/aesthetics/friendsmas/ friendsmas 424605139807959315 5468486241114720865 424605208526455283
4 Fall wallpapers 60 https://www.pinterest.com/pinterest/aesthetics/fall-wallpapers/ fall-wallpapers 424605139807959315 5451983901713021882 424605208526455283
5 2000s fall aesthetic 38 https://www.pinterest.com/pinterest/aesthetics/2000s-fall-aesth… 2000s-fall-aesthetic 424605139807959315 5455817010436961132 424605208526455283
6 Non-traditional nuptials 45 https://www.pinterest.com/pinterest/aesthetics/non-traditional-… non-traditional-nuptials 424605139807959315 5454535542626643918 424605208526455283
7 Clowncore 41 https://www.pinterest.com/pinterest/aesthetics/clowncore/ clowncore 424605139807959315 5421006312586671231 424605208526455283
8 Matching aesthetic 60 https://www.pinterest.com/pinterest/aesthetics/matching-aesthet… matching-aesthetic 424605139807959315 5445653546953405027 424605208526455283
9 Engagement aesthetic 50 https://www.pinterest.com/pinterest/aesthetics/engagement-aesth… engagement-aesthetic 424605139807959315 5453282383696542653 424605208526455283
10 Back to school wallpapers 38 https://www.pinterest.com/pinterest/aesthetics/back-to-school-w… back-to-school-wallpapers 424605139807959315 5446912228257217107 424605208526455283
Endpoints

Pinterest API endpoints

What each one takes and what it returns. Open one for a real response, every input and every field.

Pinterest Full Board API

Collect a whole public board: every pin and which section it sits in, in chunks of up to 1,000 pins you continue with a cursor.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Pinterest Board Pins API

List a board's pins, up to 250 a page: title, description, link, saves, and whether each is an image or a video.

Sendurl Returnsboardfavorite_counthas_productsidimagesis_native
1 credit

Pinterest Board Info API

Get a board's details before you collect it: name, description, pin count and its sections.

Sendurl Returnstitlepin_counturlboard_ididslug
1 credit

Pinterest User API

Get a public profile from its link: username, display name, followers and whether it is a verified partner.

Sendurl Returnsuser
1 credit

Pinterest User Boards API

List a profile's public boards with their links, pin counts and section counts.

Sendurl Returnsnamefollower_countcreated_atcollaborator_countdescriptionhas_custom_cover
1 credit

Pinterest Pin API

Get one pin from its link: title, description, images, and the video link when it is a video.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Pinterest Section API

Collect every pin in a board section, in chunks of up to 1,000 you continue with a cursor.

Sendurl ReturnsJSON; every field is in the API reference
1 credit

Pinterest Section Pins API

List a section's pins, up to 50 a page.

Sendurl Returnstitlemedia_typesave_countis_repinidboard
1 credit

Pinterest Board ID API

Get a board's numeric ID from its link.

Sendurl ReturnsJSON; every field is in the API reference
1 credit
Use cases

What teams build with Pinterest data

Know before you build

How Pinterest data behaves

REST API · MCP server

Call it from your code, or ask your agent

One request shape for every Pinterest endpoint: the endpoint ID and its input. No SDK needed.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "pinterest.board-info.get",  "input": {    "url": "https://www.pinterest.com/pinterest/aesthetics/"  }}'
Response
{  "board": {    "name": "Aesthetics",    "follower_count": 0,    "collaborator_count": 0,    "description": "Explore trending aesthetics for every season and mood.",    "id": "424605139807959315",    "is_collaborative": false,    "pin_count": 7760,    "privacy": "public",    "section_count": 133,    "url": "/pinterest/aesthetics/",    "owner": {      "full_name": "Pinterest",      "username": "pinterest",      "id": "424605208526455283"    },    "sections": [      {        "title": "Happy homebody aesthetic",        "board_id": "424605139807959315",        "id": "5476669214353860495",        "pin_count": 70,        "slug": "happy-homebody-aesthetic",        "url": "https://www.pinterest.com/pinterest/aesthetics/happy-homebody-aesthetic/",        "user_id": "424605208526455283"      },      {        "title": "Animal print everything",        "board_id": "424605139807959315",        "id": "5469776547382628375",        "pin_count": 90,        "slug": "animal-print-everything",        "url": "https://www.pinterest.com/pinterest/aesthetics/animal-print-everything/",        "user_id": "424605208526455283"      }    ]  }}
In your AI agent Claude · Cursor · any MCP client
1Add the Upscrape MCP server
https://data.upscrape.com/mcp
2Ask for the data in plain words

With Upscrape, open Pinterest's Aesthetics board (pinterest.com/pinterest/aesthetics) and list its sections with how many pins each has, biggest first.

Use Upscrape to look up the National Park Service on Pinterest (pinterest.com/natlparkservice). How many followers does it have, and is it a verified partner?

Using Upscrape, list the pins in the K-pop aesthetic section of Pinterest's Aesthetics board, with title, media type and saves, most saved first.

The agent finds the endpoint, shows you the price, and runs it with your credits.
Social & content
Questions

Pinterest Scraper API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.
Is there an official Pinterest API for this data?

Pinterest's own API is for apps acting on behalf of signed-in users and needs approval. Upscrape reads public Pinterest pages, so you can get any public profile, board or pin with one API key.

Can I download a whole board?

Yes. The full-board endpoint returns every pin, sections included, up to 1,000 pins per response with a cursor for the next chunk.

Do I need a Pinterest account?

No. You send a link and get JSON back. Nothing runs on your account, and you share no password or cookie.

What data can I get from Pinterest?

Full board, board pins, board info, user, user boards, pin, section, section pins and board id. Each is its own endpoint with a published input schema, and the response is JSON.

How much does the Pinterest API cost?

Every Pinterest endpoint costs 1 credit per successful call. You buy credits once, with no subscription, and paid credits never expire. New accounts get free credits to try it.

Can an AI agent use the Pinterest API?

Yes. Connect any MCP client to the Upscrape MCP server with OAuth or an API key. The agent finds the Pinterest endpoint, checks its price and runs it with the same credits as the REST API.

Is it legal to scrape Pinterest?

Upscrape reads public pages only and needs no login. How you use the data is yours to decide under the laws that apply to you; we sign a data processing agreement for your legal review.

What happens when Pinterest changes its pages?

We fix the endpoint. Your request and the response fields stay the same.

Get started

Your first Pinterest call is free.

Up to 100 free credits to start, no card needed.