↑ ↓ to move ↵ to open
Pinterest API · Endpoint

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
Response completed
{  "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"      }    ]  }}
Try it live, free
Input

What you send

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

FieldTypeRequiredWhat it doesExample
url string yes The board's link. https://www.pinterest.com/pinterest/aesthetics/
Response

Fields it returns

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

FieldTypeWhat it isExample
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. Pinterest
board.owner.id string Pinterest's ID for the board's owner. 424605208526455283
board.owner.username string The account's username. pinterest
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/
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.board-info.get",  "input": {    "url": "https://www.pinterest.com/pinterest/aesthetics/"  }}'
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.

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

More from the Pinterest API

Same data, other platforms

The same data from other platforms

Questions

Pinterest Board Info API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.
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.

Get started

Your first Pinterest call is free.

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