Pinterest API · Endpoint
Pinterest Section Pins API
List a section's pins, up to 50 a page.
- 1 credit per call
- Failed calls are free
- Updated
- pinterest.section-pins.list
Response
completed
{ "pagination": { "has_more": true, "retrieved_total": 44 }, "section": { "title": "K-Pop aesthetic", "board_id": "424605139807959315", "id": "5309417731219572412", "pin_count": 181, "slug": "k-pop-aesthetic", "url": "https://www.pinterest.com/pinterest/aesthetics/k-pop-aesthetic/", "user_id": "424605208526455283" }, "items": [ { "title": "grwm ~ kpop inspired outfit", "description": " ", "domain": "pinterest.com", "favorite_count": 0, "has_products": false, "id": "424605071136820896", "is_native": false, "is_promoted": false, "is_repin": true, "is_story_pin": true, "is_video": true, "media_detection": "confirmed", "media_type": "video", "page_count": 1, "repin_count": 0, "save_count": 397, "board": { "name": "Aesthetics", "follower_count": 0, "collaborator_count": 0, "id": "424605139807959315", "is_collaborative": false, "pin_count": 0, "privacy": "public", "section_count": 0, "url": "/pinterest/aesthetics/" }, "pinner": { "full_name": "Pinterest", "username": "pinterest", "id": "424605208526455283", "verified_identity": { "verified": true } } }, { "title": "🩷 Perfect for Cute people", "description": "🏡 aespa’s house - Room Details", "domain": "youtube.com", "favorite_count": 0, "has_products": false, "id": "424605071136660577", "is_native": false, "is_promoted": false, "is_repin": true, "is_story_pin": false, "is_video": false, "media_detection": "unverified", "media_type": "unknown", "repin_count": 0, "save_count": 352, "board": { "name": "Aesthetics", "follower_count": 0, "collaborator_count": 0, "id": "424605139807959315", "is_collaborative": false, "pin_count": 0, "privacy": "public", "section_count": 0, "url": "/pinterest/aesthetics/" }, "pinner": { "full_name": "Pinterest", "username": "pinterest", "id": "424605208526455283", "verified_identity": { "verified": true } } } ]}
| # | 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 |
Input
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 section's link. | https://www.pinterest.com/pinterest/aesthetics/… |
| cursor | string | no | Pass the cursor from the last response to get the next page. | |
| limit | integer | no | How many pins to return in this page, up to 50. | 50 |
Response
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].title | string | The pin's title. | grwm ~ kpop inspired outfit |
| items[].media_type | string | The kind of media, such as video, when Pinterest says. | video |
| items[].save_count | integer | Saves, as Pinterest shows them. | 397 |
| items[].is_repin | boolean | Whether the pin was saved from another board. | true |
| items[].id | string | Pinterest's ID for the pin. | 424605071136820896 |
| items[].board.name | string | The board's name. | Aesthetics |
| items[].pinner.full_name | string | The account's display name. | |
| items[].board.follower_count | integer | Followers, as Pinterest shows them. | 0 |
| items[].pinner.username | string | The account's username. | |
| items[].board | object | The board the pin is saved to. | 9 fields |
| items[].board.collaborator_count | integer | How many people can add pins to the board. | 0 |
| items[].board.id | string | Pinterest's ID for the board. | 424605139807959315 |
| items[].board.is_collaborative | boolean | Whether several people can add pins to the board. | false |
| items[].board.pin_count | integer | Pins Pinterest reports for the board. | 0 |
| items[].board.privacy | string | Who can see the board, such as public. | public |
| items[].board.section_count | integer | How many sections the board has. | 0 |
| items[].board.url | string | The board's address on Pinterest. | /pinterest/aesthetics/ |
| items[].description | string | The pin's description. | |
| items[].domain | string | The website the pin comes from. | pinterest.com |
| items[].favorite_count | integer | Times the pin was marked as a favourite. | 0 |
| items[].has_products | boolean | Whether the pin shows products to buy. | false |
| items[].is_native | boolean | Whether the pin was created on Pinterest rather than saved from a site. | false |
| items[].is_promoted | boolean | Whether the pin is an ad. | false |
| items[].is_story_pin | boolean | Whether it is an idea pin with several pages. | true |
| items[].is_video | boolean | Whether the pin is a video. | true |
| items[].media_detection | string | Whether the media type was confirmed or not yet verified. | confirmed |
| items[].page_count | integer | How many pages the idea pin has. | 1 |
| items[].pinner | object | The account that saved the pin. | 4 fields |
| items[].pinner.id | string | Pinterest's ID for the account that saved the pin. | 424605208526455283 |
| items[].pinner.verified_identity | object | Pinterest's verification details for the account. | 1 fields |
| items[].repin_count | integer | Times the pin was saved to other boards. | 0 |
| items | array | The section's pins. | 44 records |
| pagination | object | Paging details for this answer. | 2 fields |
| pagination.has_more | boolean | Whether more pins are available. | true |
| pagination.retrieved_total | integer | How many pins were read for this answer. | 44 |
| section | object | The section. | 7 fields |
| section.board_id | string | Pinterest's ID for the board. | 424605139807959315 |
| section.id | string | Pinterest's ID for the section. | 5309417731219572412 |
| section.pin_count | integer | Pins Pinterest reports for the section. | 181 |
| section.slug | string | The section's name as it appears in its link. | k-pop-aesthetic |
| section.title | string | The section's title. | K-Pop aesthetic |
| section.url | string | The section's address on Pinterest. | https://www.pinterest.com/pinterest/aesthetics/k-pop-aesthetic/ |
| section.user_id | string | Pinterest's ID for the board's owner. | 424605208526455283 |
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.section-pins.list", "input": { "limit": 50, "url": "https://www.pinterest.com/pinterest/aesthetics/k-pop-aesthetic/" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "pinterest.section-pins.list", "input": { "limit": 50, "url": "https://www.pinterest.com/pinterest/aesthetics/k-pop-aesthetic/" }}''')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.section-pins.list", "input": { "limit": 50, "url": "https://www.pinterest.com/pinterest/aesthetics/k-pop-aesthetic/" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
In your AI agent
Claude · Cursor · any MCP client
1Add the Upscrape MCP server
2Ask for the data in plain words
The agent finds the endpoint, shows you the price, and runs it with your credits.
https://data.upscrape.com/mcp
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.
Pinterest
More from the Pinterest API
Questions
Pinterest Section Pins 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 Section Pins 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.section-pins.list, 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.