Pinterest API · Endpoint
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.
- 1 credit per call
- Failed calls are free
- Updated
- pinterest.board-full.get
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 board's link, such as https://www.pinterest.com/pinterest/aesthetics/. | https://www.pinterest.com/pinterest/home-decor-… |
| collection_mode | boolean | no | Return the response in the format the managed collection uses. | |
| cursor | string | no | Pass pagination.next_cursor from the last response, with the same link, to get the next chunk. | |
| max_pins | integer | no | At most this many pins in this response; each response holds up to 1,000. Leave it out for the full chunk. | 25 |
| max_sections | integer | no | Fetch the pins of only the first this many sections. Every section is still listed. | 20 |
| page_size | integer | no | How many pins to read from Pinterest at a time: up to 250 for a board and 50 for a section. | 100 |
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.board-full.get", "input": { "max_pins": 25, "max_sections": 0, "page_size": 25, "url": "https://www.pinterest.com/PinterestPredicts/gimme-gummy/" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "pinterest.board-full.get", "input": { "max_pins": 25, "max_sections": 0, "page_size": 25, "url": "https://www.pinterest.com/PinterestPredicts/gimme-gummy/" }}''')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.board-full.get", "input": { "max_pins": 25, "max_sections": 0, "page_size": 25, "url": "https://www.pinterest.com/PinterestPredicts/gimme-gummy/" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
With Upscrape, get the Pinterest full board for max pins "25", max sections "0" and page size "25". Tell me what it costs before you run it, then show the results as a table.
More from the Pinterest API
Pinterest Full Board API FAQ
The short answers. The docs have the long ones.
How much does the Pinterest Full Board 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.board-full.get, checks its price and runs it with the same credits as the REST API.
Your first Pinterest call is free.
Up to 100 free credits to start, no card needed.