Pinterest API · Endpoint

Pinterest User Boards API

Q: What do I send?

Send url. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds pinterest.user-boards.get, checks its price and runs it with the same credits as the REST API.

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

1 credit per call
Failed calls are free
Updated 16 Oct 2026
pinterest.user-boards.get

Start free, 100 credits API reference

Response completed

{  "boards": [    {      "name": "Cabbage Crush",      "follower_count": 239969,      "created_at": "Mon, 22 Sep 2025 19:19:42 +0000",      "collaborator_count": 2,      "description": "The motto for 2026? Live, laugh, leaf. It’s crunch time, baby.",      "has_custom_cover": true,      "id": "871517034080951175",      "image_cover_hd_url": "https://i.pinimg.com/474x/90/9b/8b/909b8be39e2348288b8c5d1d83f74c97.jpg",      "image_cover_url": "https://i.pinimg.com/custom_covers/200x150/871517034080951175_1764016421.jpg",      "is_collaborative": true,      "node_id": "Qm9hcmQ6ODcxNTE3MDM0MDgwOTUxMTc1",      "pin_count": 126,      "privacy": "public",      "section_count": 0,      "url": "/pinterestpredicts/cabbage-crush/",      "owner": {        "full_name": "Pinterest Predicts",        "follower_count": 291542,        "username": "PinterestPredicts",        "id": "871517102799028482",        "image_medium_url": "https://i.pinimg.com/75x75_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg",        "is_partner": true,        "node_id": "VXNlcjo4NzE1MTcxMDI3OTkwMjg0ODI=",        "verified_identity": {          "verified": true        }      }    },    {      "name": "Cool Blue",      "follower_count": 240491,      "created_at": "Mon, 22 Sep 2025 18:36:43 +0000",      "collaborator_count": 2,      "description": "This icy hue brings subzero sophistication to makeup, fashion and the frostiest of cocktails.",      "has_custom_cover": true,      "id": "871517034080951130",      "image_cover_hd_url": "https://i.pinimg.com/474x/19/a3/e3/19a3e30754e9dd362d32494b161c5685.jpg",      "image_cover_url": "https://i.pinimg.com/custom_covers/200x150/871517034080951130_1764023523.jpg",      "is_collaborative": true,      "node_id": "Qm9hcmQ6ODcxNTE3MDM0MDgwOTUxMTMw",      "pin_count": 199,      "privacy": "public",      "section_count": 0,      "url": "/pinterestpredicts/cool-blue/",      "owner": {        "full_name": "Pinterest Predicts",        "follower_count": 291542,        "username": "PinterestPredicts",        "id": "871517102799028482",        "image_medium_url": "https://i.pinimg.com/75x75_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg",        "is_partner": true,        "node_id": "VXNlcjo4NzE1MTcxMDI3OTkwMjg0ODI=",        "verified_identity": {          "verified": true        }      }    }  ]}

3 rows

#	Name	Follower count	Created at	Collaborator count	Description	Has custom cover	Is collaborative	Pin count	Privacy
1	Cabbage Crush	239,969	Mon, 22 Sep 2025 19:19:42 +0000	2	The motto for 2026? Live, laugh, leaf. It’s crunch time, baby.	true	true	126	public
2	Cool Blue	240,491	Mon, 22 Sep 2025 18:36:43 +0000	2	This icy hue brings subzero sophistication to makeup, fashion a…	true	true	199	public
3	Opera Aesthetic	240,647	Wed, 20 Aug 2025 15:11:08 +0000	1	Enter: the opulent party. Dial up the drama with velvet drapery…	true	true	228	public

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
url	string	yes	The profile's link.	https://www.pinterest.com/pinterest/
cursor	string	no	Pass the cursor from the last page, with page_mode on.
page_mode	boolean	no	Return one page of boards at a time, to continue later with cursor.

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	What it is	Example
boards[].name	string	The board's name.	Cabbage Crush
boards[].owner.full_name	string	The account's display name.	Pinterest Predicts
boards[].follower_count	integer	The board's followers.	239,969
boards[].owner.follower_count	integer	The owner's followers.	291,542
boards[].owner.username	string	The account's username.	PinterestPredicts
boards[].created_at	string	When the board was created.	Mon, 22 Sep 2025 19:19:42 +0000
boards[].collaborator_count	integer	How many people can add pins to the board.	2
boards[].description	string	The board's description.	The motto for 2026? Live, laugh, leaf. It’s crunch time, baby.
boards[].has_custom_cover	boolean	Whether the board has its own cover image.	true
boards[].id	string	Pinterest's ID for the board.	871517034080951175
boards[].image_cover_hd_url	string	Link to the board's cover image, large.	https://i.pinimg.com/474x/90/9b/8b/909b8be39e2348288b8c5d1d83f7…
boards[].image_cover_url	string	Link to the board's cover image.	https://i.pinimg.com/custom_covers/200x150/871517034080951175_1…
boards[].is_collaborative	boolean	Whether several people can add pins to the board.	true
boards[].node_id	string	Pinterest's internal ID for the board or account.	Qm9hcmQ6ODcxNTE3MDM0MDgwOTUxMTc1
boards[].owner	object	The board's owner.	8 fields
boards[].owner.id	string	Pinterest's ID for the owner.	871517102799028482
boards[].owner.image_medium_url	string	Link to the owner's profile picture.	https://i.pinimg.com/75x75_RS/1c/b5/61/1cb561c8e7b9c709f78d110a…
boards[].owner.is_partner	boolean	Whether the owner is a Pinterest partner account.	true
boards[].owner.node_id	string	Pinterest's internal ID for the board or account.	VXNlcjo4NzE1MTcxMDI3OTkwMjg0ODI=
boards[].owner.verified_identity	object	Pinterest's verification details for the account.	1 fields
boards[].pin_count	integer	Pins Pinterest reports for the board.	126
boards[].privacy	string	Who can see the board, such as public.	public
boards[].section_count	integer	How many sections the board has.	0
boards[].url	string	The board's address on Pinterest.	/pinterestpredicts/cabbage-crush/
boards	array	The account's boards.	3 records

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

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.user-boards.get",  "input": {    "url": "https://www.pinterest.com/PinterestPredicts/"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "pinterest.user-boards.get",  "input": {    "url": "https://www.pinterest.com/PinterestPredicts/"  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "pinterest.user-boards.get",  "input": {    "url": "https://www.pinterest.com/PinterestPredicts/"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

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, get the Pinterest user boards for https://www.pinterest.com/PinterestPredicts/. Tell me what it costs before you run it, then show the results as a table.

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

More from the Pinterest API

Same data, other platforms

The same data from other platforms

Greenhouse JobsBoard1 credit

Questions

Pinterest User Boards API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.

Book a call [email protected]

How much does the Pinterest User Boards API cost?

1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.

What do I send?

Send url. The input fields below list every option with its type and limits.

Do I need a Pinterest login?

No. It reads public Pinterest data; nothing runs on your account.

Can my AI agent call it?

Yes, over MCP: the agent finds pinterest.user-boards.get, checks its price and runs it with the same credits as the REST API.

Get started

Your first Pinterest call is free.

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

Start building for free Book a call