Pinterest API reference
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.
The Pinterest API has 9 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Pinterest in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The input most of them take is url. Prices run from 0.25–5 credits to 0.5 credits per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
pinterest.board-full.get |
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. | 0.25–5 credits |
pinterest.board-pins.list |
List a board's pins, up to 250 a page: title, description, link, saves, and whether each is an image or a video. | 0.25–1.5 credits |
pinterest.board-info.get |
Get a board's details before you collect it: name, description, pin count and its sections. | 0.25 credits |
pinterest.user.get |
Get a public profile from its link: username, display name, followers and whether it is a verified partner. | 0.5 credits |
pinterest.user-boards.get |
List a profile's public boards with their links, pin counts and section counts. | 0.5 credits |
pinterest.pin.get |
Get one pin from its link: title, description, images, and the video link when it is a video. | 0.5 credits |
pinterest.section.get |
Collect every pin in a board section, in chunks of up to 1,000 you continue with a cursor. | 0.25–5 credits |
pinterest.section-pins.list |
List a section's pins, up to 50 a page. | 0.25 credits |
pinterest.board-id.get |
Get a board's numeric ID from its link. | 0.25 credits |
What to know
- Public boards only Every call reads what Pinterest shows to any visitor. Secret boards and anything behind a login are not part of it.
- Sections hold pins too On a board with sections, many pins sit inside them. The full-board endpoint returns those with their section.
- Counts as Pinterest shows them Followers, pin counts and saves are Pinterest's own numbers at the moment of the call.
- Images and videos Pins come with their image links, and a video link when the pin is a video.
Something missing or unclear? Ask the team that builds the Pinterest endpoints.