List the pins saved on one public Pinterest board with images, titles, pinner and board context. Identify the board by board id to keep the request to a single upstream lookup, or by username plus slug. A username plus slug call resolves the board id first; that resolution is cached for an hour on the slug pair and is never billed separately, so one request is always one charge and repeat calls to the same board cost only the pin feed lookup. Advertisements and other non-pin modules are never included.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
5 optional filters available.
string
Optional
Numeric Pinterest board id. Recommended: it keeps the request to one upstream lookup. Without it the board id is resolved from username plus slug first, which is cached for an hour and never billed separately.
1234567890
string
Optional
Board owner username, without the @ prefix.
example
string
Optional
Board slug, as it appears in the board URL.
example
integer
Optional
Number of items to request (max 250). Default: 25.
10
string
Optional
Pagination token from a previous response.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
pins
count
success
board_id
nextBookmark
Common pins fields
id
link
board
likes
{
"pins": [
{
"id": "1900024839723552",
"link": "https://example.com/home-decor",
"board": {
"id": "1900093532251547",
"url": "/haliexo/living-room-inspo/",
"name": "Living room Inspo"
},
"likes": 86,
"saves": 1204,
"title": "Minimalist living room ideas",
"domain": "example.com",
"pinner": {
"id": "1900162251230306",
"source": "closeup_attribution",
"username": "haliexo",
"full_name": "Halie Jo",
"profile_url": "https://www.pinterest.com/haliexo/"
},
"comments": 12,
"hashtags": [
"minimalist",
"livingroom"
],
"is_video": false,
"image_url": "https://i.pinimg.com/736x/92/b0/a0/92b0a0b84696442d78be0737e1d0bf06.jpg",
"description": "Clean lines and neutral tones for a modern living room."
}
],
"count": 1,
"success": true,
"board_id": "1900093532251547",
"nextBookmark": null
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.