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.
Sendurl
ReturnsJSON; every field is in the 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.
| # | 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 |
| # | Pin | Media | Saves | Saved from elsewhere | Pin ID | Description | Domain | Favorite count | Has products | Is native |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | grwm ~ kpop inspired outfit | video | 397 | true | 424605071136820896 | pinterest.com | 0 | false | false | |
| 2 | 🩷 Perfect for Cute people | unknown | 352 | true | 424605071136660577 | 🏡 aespa’s house - Room Details | youtube.com | 0 | false | false |
| 3 | unknown | 558 | true | 424605071136605428 | shffls.com | 0 | false | false | ||
| 4 | K-Pop Concert Girly Outfit Inspo | unknown | 25 | true | 424605071136713555 | pinterest.com | 0 | false | false | |
| 5 | Kpop chrome butterfly nails | unknown | 48 | true | 424605071136820820 | Airbrushed milky chrome edgy asian butterfly nails | instagram.com | 0 | false | false |
| 6 | Styling pieces I've made K-pop edition! | video | 320 | true | 424605071136820805 | Styling my patchwork flannel set, crochet spiral top, crochet s… | pinterest.com | 0 | false | false |
| 7 | Phone | unknown | 4638 | true | 424605071136605502 | Uploaded by user | 0 | false | false | |
| 8 | Kpop Concert Outfit | unknown | 54 | true | 424605071136551981 | Kpop, concert, seventeen fit | Uploaded by user | 0 | false | false |
| 9 | AESPA | unknown | 90 | true | 424605071136787216 | Karina, My world, 3rd mini album, posters, Aespa, KPOP | Uploaded by user | 0 | false | false |
| 10 | life goes on cassette unboxing !🌱🤍 | unknown | 10,873 | true | 424605071136605449 | Uploaded by user | 0 | false | false |
What each one takes and what it returns. Open one for a real response, every input and every field.
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.
Sendurl
ReturnsJSON; every field is in the API reference
List a board's pins, up to 250 a page: title, description, link, saves, and whether each is an image or a video.
Sendurl
Returnsboardfavorite_counthas_productsidimagesis_native
Get a board's details before you collect it: name, description, pin count and its sections.
Sendurl
Returnstitlepin_counturlboard_ididslug
Get a public profile from its link: username, display name, followers and whether it is a verified partner.
Sendurl
Returnsuser
List a profile's public boards with their links, pin counts and section counts.
Sendurl
Returnsnamefollower_countcreated_atcollaborator_countdescriptionhas_custom_cover
Get one pin from its link: title, description, images, and the video link when it is a video.
Sendurl
ReturnsJSON; every field is in the API reference
Collect every pin in a board section, in chunks of up to 1,000 you continue with a cursor.
Sendurl
ReturnsJSON; every field is in the API reference
List a section's pins, up to 50 a page.
Sendurl
Returnstitlemedia_typesave_countis_repinidboard
Get a board's numeric ID from its link.
Sendurl
ReturnsJSON; every field is in the API reference
Collect the boards and sections that track a trend, and see which pins people save most.
Board infoSection pinsBoard pinsFollow brand and publisher profiles: followers, boards and how their boards grow.
UserUser boardsCopy whole boards, sections included, into your own storage, thousands of pins at a time.
Full boardSectionTurn pin links into rows with title, description and image links.
PinBoard pinsOne request shape for every Pinterest endpoint: the endpoint ID and its input. No SDK needed.
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));
{ "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" } ] }}
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.
Use Upscrape to look up the National Park Service on Pinterest (pinterest.com/natlparkservice). How many followers does it have, and is it a verified partner?
Using Upscrape, list the pins in the K-pop aesthetic section of Pinterest's Aesthetics board, with title, media type and saves, most saved first.
The short answers. The docs have the long ones.
Pinterest's own API is for apps acting on behalf of signed-in users and needs approval. Upscrape reads public Pinterest pages, so you can get any public profile, board or pin with one API key.
Yes. The full-board endpoint returns every pin, sections included, up to 1,000 pins per response with a cursor for the next chunk.
No. You send a link and get JSON back. Nothing runs on your account, and you share no password or cookie.
Full board, board pins, board info, user, user boards, pin, section, section pins and board id. Each is its own endpoint with a published input schema, and the response is JSON.
Every Pinterest endpoint costs 1 credit per successful call. You buy credits once, with no subscription, and paid credits never expire. New accounts get free credits to try it.
Yes. Connect any MCP client to the Upscrape MCP server with OAuth or an API key. The agent finds the Pinterest endpoint, checks its price and runs it with the same credits as the REST API.
Upscrape reads public pages only and needs no login. How you use the data is yours to decide under the laws that apply to you; we sign a data processing agreement for your legal review.
We fix the endpoint. Your request and the response fields stay the same.
Up to 100 free credits to start, no card needed.