Pinterest API for pin search, boards and images
Public Pinterest pins as JSON: search pins or videos by keyword, list a board's pins, read profiles and their boards, with the original image, outbound link and creation date. No app review.
Keyword
Endpoint
curl "https://api.toolzerhub.com/v1/pinterest/search/pins?query=kitchen+ideas" \
-H "x-api-key: $TOOLZERHUB_API_KEY"{
"data": {
"results": [
{
"id": "e1_AfqPShz3R431sNW1uDn-eJrr22p4ZLWBaUku450zFRi3SJcINS-rdw",
"type": "pin",
"title": "Cozy Modern Farmhouse Kitchen Ideas",
"description": "Create a warm and inviting kitchen with elegant sage-green cabinets, glowing glass-front storage, beautiful marble countertops, natural wood accents, and cha...",
"link": null,
"domain": "Uploaded by user",
"created_at": "Thu, 01 Oct 2026 05:48:30 +0000",
"reaction_counts": {
"1": 13
},
"auto_alt_text": "a kitchen filled with lots of green cabinets and counter top space next to a window",
"images": {
"orig": {
"width": 672,
"height": 795,
"url": "https://i.pinimg.com/originals/69/06/60/690660fb8a0f21dfdf4aaa54d3223e1e.jpg"
}
},
"videos": null,
"pinner": {
"username": "…",
"follower_count": 51
},
"board": {
"id": "1109293020658371701",
"name": "cozy kitchen home decor",
"url": "/…/cozy-kitchen-home-decor/"
}
},
{
"id": "e1_AfqPShzEznX4GitX2kx2fgvrqMTDXICE5V-spyPZXjgB-mKysqVx",
"type": "pin",
"title": "",
"description": " ",
"link": null,
"domain": "Uploaded by user",
"created_at": "Fri, 09 Oct 2026 09:33:01 +0000",
"reaction_counts": {
"1": 2
},
"auto_alt_text": "a kitchen filled with lots of counter top space",
"images": {
"orig": {
"width": 1198,
"height": 1313,
"url": "https://i.pinimg.com/originals/7f/fb/24/7ffb240ed18d8939378088ceaf8226c9.jpg"
}
},
"videos": null,
"pinner": {
"username": "…",
"follower_count": 34
},
"board": {
"id": "456411812176433165",
"name": "Hus inspo front interiør",
"url": "/…/hus-inspo-front-interi%C3%B8r/"
}
},
{
"id": "e1_AfqPShwHCT9LLs7Puvd82xCQeuGGoId7s4Zm8gpxG2aYnv_8T79wFA",
"type": "pin",
"title": "8 Modern Small Kitchen Decor Tips for a Sleek, Space-Saving Style and Functionality",
"description": "(Paid Link) 🤩 Discover 8 modern small kitchen decor tips that blend sleek style with smart functionality. Learn space-saving layouts, compact storage ideas,...",
"link": "https://www.amazon.com/Latest-Modern-Small-Kitchen-Decor-20260925053700/s?k=modern+kitchen+decor&tag=…",
"domain": "amazon.com",
"created_at": "Sat, 26 Sep 2026 22:48:54 +0000",
"reaction_counts": {
"1": 1
},
"auto_alt_text": "two wooden stools sit in front of an island with white counter tops and wood paneling",
"images": {
"orig": {
"width": 1000,
"height": 1500,
"url": "https://i.pinimg.com/originals/78/5b/f0/785bf018160d26f51a515dfa8165524b.jpg"
}
},
"videos": null,
"pinner": {
"username": "…",
"follower_count": 116
},
"board": {
"id": "1100004346426348499",
"name": "Modern Small Kitchen Decor",
"url": "/…/modern-small-kitchen-decor/"
}
}
],
"bookmark": "Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWlVWbFJX..."
}
}- 1
- 99%
- 0.9 s
- 5
Endpoints
What you can get
One request each, 1 credit per call. Open one to see its parameters and a real response.
- Search pins
/v1/pinterest/search/pins100% · 0.91 s1 creditSearch pins reference (opens in new tab) - Board pins
/v1/pinterest/boards/pins100% · 0.52 s1 creditBoard pins reference (opens in new tab) - Profile boards
/v1/pinterest/profiles/boards100% · 0.63 s1 creditProfile boards reference (opens in new tab) - Profile
/v1/pinterest/profiles/detail100% · 0.26 s1 creditProfile reference (opens in new tab) - Pin details
/v1/pinterest/pins/detail100% · 0.66 s1 creditPin details reference (opens in new tab)
Response
What comes back
Field names and types read off the real responses in the demo above.
- Search pins
/v1/pinterest/search/pins13 fields- idstring"e1_AfqPShz3R431sNW1uDn-…"
- typestring"pin"
- titlestring"Cozy Modern Farmhouse K…"
- descriptionstring"Create a warm and invit…"
- linknullnull
- domainstring"Uploaded by user"
- created_atstring"Thu, 01 Oct 2026 05:48:…"
- reaction_countsobject{ 1 }
- auto_alt_textstring"a kitchen filled with l…"
- Board pins
/v1/pinterest/boards/pins13 fields- idstring"e1_AfqPShz3R431sNW1uDn-…"
- typestring"pin"
- titlestring"Cozy Modern Farmhouse K…"
- descriptionstring"Create a warm and invit…"
- linknullnull
- domainstring"Uploaded by user"
- created_atnullnull
- reaction_countsobject{ 1 }
- auto_alt_textstring"a kitchen filled with l…"
Use cases
What people build with it
- 01Find what gets pinned for a topicSearch pins
- 02Collect reference images for a keywordSearch pinsBoard pins
- 03Read a creator's boards and pinsProfileProfile boardsBoard pins
How it works
From key to JSON
- 01x-api-key••••••••••Get a key
- 02GET/v1/pinterest/search/pinsSend a request
- 03{ data, status }200Get JSON
Pricing
What it costs
Every endpoint on this page costs 1 credit per call. Failed calls cost nothing.
- Free$0
- 10K pack$19
- Starter$29
Per 1,000 credits
Compare
Why not build it yourself
Three ways to get Pinterest data into your app.
| Compare | Toolzer Hub | Pinterest API v5 | Your own scraper |
|---|---|---|---|
| Setup | One API key | App review, OAuth | Proxies, sessions, retries |
| When Pinterest changes | We fix it | Pinterest keeps it working | You fix the parser |
| Cost to start | 100 free credits a month | Public pin search in beta | Proxies and your time |
FAQ
Questions
- Is this the official Pinterest API?
- What does the official Pinterest API allow?
- What data does it return?
- What does it cost?
Guides
Pinterest guides
Tested walkthroughs with real requests and output.
Try the Pinterest API free
Every new workspace gets 100 credits a month. Buy credits only when you need more.