POST /v1/pinterest/boardPinterest Board Scraper API
A public Pinterest board: name, description, pin/follower/section counts, owner and cover image, plus its first pins with images, links and engagement counts.
- Cost
- 2 credits
- Failed requests
- Refunded
- Cache hits
- Free
- Response fields
- 4
- Limits
- First 25 or so pins
What the Pinterest Board Scraper API does
The Pinterest Board Scraper API returns a public Pinterest board with its name, description, pin, follower and section counts, owner and cover image, plus the board's first pins in board order. The pins have the same fields as the pins endpoint: image, title, description, outbound link and domain, video URL for video pins, board, pinner and the available engagement counts. Send the board URL, or the owner's username together with the board slug; a board name with spaces is converted to a slug. Logged-out Pinterest serves only the first 25 or so pins of a board, so fewer pins than your limit can come back, and has_more tells you when the board holds more. Each request costs 2 credits.
What you get
Top-level fields of the response. Every field is typed and documented; nullable fields are null when the platform does not show them.
| Field | Type | Description |
|---|---|---|
board | object | Board details |
pins | array<object> (25 fields each) | Board pins in board order, max limit |
pins_fetched | integer | Number of pins returned |
has_more | boolean | The board has more pins than those returned |
Request example
Send the API key as a Bearer token. The body is a small JSON object.
curl -X POST https://api.scrapeeverything.com/v1/pinterest/board \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.pinterest.com/nasa/learn-with-nasa/","limit":20}'| Parameter | Required | Description |
|---|---|---|
url | No | Board URL: https://www.pinterest.com/<username>/<board>/. |
username | No | Board owner's username, @handle or profile URL; used with board when url is empty. |
board | No | Board slug as in the URL; a board name with spaces is converted to a slug. |
limit | No | Maximum number of pins to return (logged-out Pinterest serves at most about 25 pins of a board). |
What it costs
Each successful request costs 2 credits. Your first 100 credits are free. With credit packs, 1,000 requests to this endpoint cost:
Builder pack
$3.12
25,000 credits for $39.00
Growth pack
$2.38
100,000 credits for $119.00
Scale pack
$1.80
500,000 credits for $449.00
See pricing for all packs and rate limits.
Use cases
- Analyze curated boards in your niche for products, styles and outbound domains.
- Track follower and pin counts of key boards over time.
- Collect the latest ideas saved to competitors' boards.
Limitations: Unofficial API: not affiliated with or endorsed by the platform. Public data only, as a logged-out visitor sees it. Feeds and search return up to 50 pins per request; pins Pinterest hides from logged-out visitors are missing.
- Logged-out Pinterest only serves the first 25 or so pins of a board, so fewer pins than limit can come back. has_more is true when the board has more pins.
- Board pins have the same fields as pinterest.pins.
Questions
Why do I get only about 25 pins?
Logged-out Pinterest serves only the first 25 or so pins of a board. has_more is true when the board has more pins.
Which inputs are accepted?
A board URL (https://www.pinterest.com/<username>/<board>/), or username together with board.
Can I use the board's name instead of the slug?
Yes. A board name with spaces is converted to a slug, for example learn with nasa becomes learn-with-nasa.
How much does the Pinterest Board Scraper API cost?
2 credits per successful request. Credits are bought in one-time packs and never expire. New accounts get 100 free credits. No payment details needed.
Am I charged for failed requests?
No. If the platform blocks the request, it times out or something fails on our side, the credits are refunded automatically. A definitive answer such as "this account does not exist" is billed because the lookup completed.
Can I re-read a result without paying again?
Yes. Send cache_days (1 to 14) and a repeat request for the same target within that window is served from your cache for free.
More Pinterest endpoints
Start with 100 free credits.
Continue with Google, create an API key and send your first request in under a minute.