Pinterest Board Info API
Get a board's details before you collect it: name, description, pin count and its sections.
- 1 credit per call
- Failed calls are free
- Updated
- pinterest.board-info.get
{ "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" } ] }}
| # | 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 |
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. | https://www.pinterest.com/pinterest/aesthetics/ |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| board.sections[].title | string | Happy homebody aesthetic | |
| board.sections[].pin_count | integer | Pins Pinterest reports for the section. | 70 |
| board.sections[].url | string | The section's address on Pinterest. | https://www.pinterest.com/pinterest/aesthetics/happy-homebody-a… |
| board.sections[].board_id | string | 424605139807959315 | |
| board.sections[].id | string | Pinterest's ID for the section. | 5476669214353860495 |
| board.sections[].slug | string | happy-homebody-aesthetic | |
| board.sections[].user_id | string | 424605208526455283 | |
| board | object | The board. | 12 fields |
| board.collaborator_count | integer | How many people can add pins to the board. | 0 |
| board.description | string | The description. | Explore trending aesthetics for every season and mood. |
| board.follower_count | integer | Followers, as Pinterest shows them. | 0 |
| board.id | string | Pinterest's ID for the board. | 424605139807959315 |
| board.is_collaborative | boolean | Whether several people can add pins to the board. | false |
| board.name | string | The board's name. | Aesthetics |
| board.owner | object | The board's owner. | 3 fields |
| board.owner.full_name | string | The account's display name. | |
| board.owner.id | string | Pinterest's ID for the board's owner. | 424605208526455283 |
| board.owner.username | string | The account's username. | |
| board.pin_count | integer | Pins Pinterest reports for the board. | 7760 |
| board.privacy | string | Who can see the board, such as public. | public |
| board.section_count | integer | How many sections the board has. | 133 |
| board.sections | array | The board's sections. | 133 records |
| board.url | string | The board's address on Pinterest. | /pinterest/aesthetics/ |
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-info.get", "input": { "url": "https://www.pinterest.com/pinterest/aesthetics/" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "pinterest.board-info.get", "input": { "url": "https://www.pinterest.com/pinterest/aesthetics/" }}''')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-info.get", "input": { "url": "https://www.pinterest.com/pinterest/aesthetics/" }}),});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, open Pinterest's Aesthetics board (pinterest.com/pinterest/aesthetics) and list its sections with how many pins each has, biggest first.
More from the Pinterest API
The same data from other platforms
Pinterest Board Info API FAQ
The short answers. The docs have the long ones.
How much does the Pinterest Board Info 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-info.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.