How do you scrape Pinterest pins via API without getting blocked?
Call ReefAPI's pinterest search_pins action with a query and read pins with title, description, alt text, outbound link, image, dominant colour, board and pinner back as JSON. The thing to code around first: a Pinterest search feed is not a uniform list, and only some of the rows are full pins.
This guide demonstrates the real Pinterest API engine with a captured response from . The example is only published because the engine passed the SEO snapshot gate.
Visual trend research, e-commerce discovery, content curation and audience insight.
Call the live endpoint
- 1
Search, then filter on image_url
Rows without an image are UI modules or stubs. Eight of our fourteen search rows were complete pins. This filter is the difference between clean data and a feed full of furniture.
- 2
Keep link and domain, not just the image
They are what makes a pin commercially readable: which product page and which merchant the attention is pointing at.
- 3
Read alt_text as well as description
description is marketing copy; alt_text is a literal scene description. For classification the alt text is usually less biased.
- 4
Follow related_pins for discovery
Pinterest's own similarity graph from one strong pin surfaces more of a niche than a broader keyword query does.
- 5
Page with bookmark
Every paginated action takes a bookmark cursor from the previous response instead of a page number. Send an empty string for the first page.
Copy the request
These snippets use the captured request params for pinterest/v1/search_pins.
curl -X POST https://api.reefapi.com/pinterest/v1/search_pins \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"minimalist home office","limit":10}'import requests
r = requests.post(
"https://api.reefapi.com/pinterest/v1/search_pins",
headers={"x-api-key": REEF_KEY},
json={
"query": "minimalist home office",
"limit": 10
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/pinterest/v1/search_pins", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "minimalist home office",
"limit": 10
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.pinterest.search_pins with {"query":"minimalist home office","limit":10}.Captured output from ReefAPI
Captured on UTC. The response below is the committed snapshot, including the API envelope and metadata.
{
"method": "POST",
"url": "https://api.reefapi.com/pinterest/v1/search_pins",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "minimalist home office",
"limit": 10
}
}{
"ok": true,
"meta": {
"api": "pinterest",
"endpoint": "search_pins",
"mode": "live",
"latency_ms": 2717.6,
"record_count": 9,
"bytes": 1421368,
"cache_hit": false,
"charged_credits": 1,
"version": "0.2.0"
},
"data": {
"pins": [
{
"id": "5903905836824113669",
"url": "https://www.pinterest.com/pin/5903905836824113669/",
"title": "Find inspiration for a minimalist home office",
"is_video": false
},
{
"id": "1089448966142557972",
"url": "https://www.pinterest.com/pin/1089448966142557972/",
"title": "14 Minimalist Home Office Ideas for a Clean & Organized Workspace",
"description": "Create a calm and clutter-free workspace with these 14 minimalist home office ideas. Discover clean desk setups, neutral colors, simple furniture, smart storage, natural light, and stylish decor ideas for a productive and peaceful home office.",
"link": "https://thebloghome.com/14-home-office-minimalista-ideas-for-a-clean-workspace-guide/",
"domain": "thebloghome.com",
"image_url": "https://i.pinimg.com/originals/d8/a7/3e/d8a73e5d4f2ffaf415219cca3bad0a4e.jpg",
"dominant_color": "#dacec7",
"is_video": false,
"reaction_counts": {},
"created_at": "Fri, 11 Sep 2026 11:01:03 +0000",
"board": {
"id": "1089449034800218081",
"name": "Minimalist Home Office Ideas",
"url": "https://www.pinterest.com/theblogshome/minimalist-home-office-ideas/"
},
"pinner": {
"username": "theblogshome",
"full_name": "The Blog Home | Cozy Decor & Aesthetic Vibes",
"follower_count": 30,
"is_verified_merchant": false,
"avatar_url": "https://i.pinimg.com/75x75_RS/db/e6/c9/dbe6c9f84e7f8378015197f28aa2ca1b.jpg"
}
},
{
"id": "1114359501578700101",
"url": "https://www.pinterest.com/pin/1114359501578700101/",
"title": "Warm Minimalist Home Office with Built-In Shelves",
"description": "Bring warmth into your home with soft neutral tones, curved architectural details, natural wood accents, subtle lighting, and comfortable furnishings. A balanced interior that feels modern, peaceful, and effortlessly cozy.",
"alt_text": "Cozy neutral home interior with curved walls, warm ambient lighting, natural wood furniture, soft curtains, and indoor plants",
"link": "https://in.pinterest.com/cozyhomeorganizer/",
"domain": "in.pinterest.com",
"image_url": "https://i.pinimg.com/originals/fc/07/e5/fc07e55a67438172366443bdb8c81b9f.png",
"dominant_color": "#a18769",
"is_video": false,
"reaction_counts": {
"1": 5
},
"created_at": "Fri, 11 Sep 2026 10:38:15 +0000",
"board": {
"id": "1114359570239076353",
"name": "All Pins",
"url": "https://www.pinterest.com/cozyhomeorganizer/all-pins/"
},
"pinner": {
"username": "cozyhomeorganizer",
"full_name": "cozyhomeorganizer",
"follower_count": 5,
"is_verified_merchant": false,
"avatar_url": "https://i.pinimg.com/75x75_RS/16/45/b6/1645b6062faa79a7c158436cea091d82.jpg"
}
},
{
"id": "345018021476520583",
"url": "https://www.pinterest.com/pin/345018021476520583/",
"title": "Clean Minimal Home Office Setup | Modern Desk Inspiration",
"description": "Create a calm and clutter-free workspace with this clean minimal home office setup. Neutral tones, simple desk organization, soft lighting and modern accessories make this workspace feel elegant, functional and peaceful. Shop the look to recreate this modern minimalist desk setup with my favorite finds.\nAs an Amazon Associate, I earn from qualifying purchases.",
"alt_text": "",
"link": "https://canva.link/9k1mss2vv75ghbv",
"domain": "canva.link",
"image_url": "https://i.pinimg.com/originals/a9/ec/3e/a9ec3e9cceea1f242dbd56f58853c246.png",
"dominant_color": "#a08f7f",
"is_video": false,
"reaction_counts": {},
"created_at": "Sun, 13 Sep 2026 10:02:21 +0000",
"board": {
"id": "345018090143149143",
"name": "Desk organization",
"url": "https://www.pinterest.com/Theeverydaynesting/desk-organization/"
},
"pinner": {
"username": "Theeverydaynesting",
"full_name": "Theeverydaynesting",
"follower_count": 12,
"is_verified_merchant": false,
"avatar_url": "https://i.pinimg.com/75x75_RS/05/20/11/05201105afbb3947224cccbac9fb6b74.jpg"
}
},
{
"id": "1110559589399798988",
"url": "https://www.pinterest.com/pin/1110559589399798988/",
"title": "Minimalist Home Office Ideas for a Calm & Productive Workspace",
"description": "Create a calm, clutter-free workspace with these minimalist home office ideas. Neutral colors, natural wood, cozy lighting, greenery, and smart storage create a stylish and functional home office that feels clean and inviting.",
"alt_text": "Minimalist home office with a light wood desk, beige office chair, laptop, floating shelves, plants, neutral decor, warm lighting, and large window creating a calm Scandinavian-inspired workspace.",
"domain": "Uploaded by user",
"image_url": "https://i.pinimg.com/originals/4d/14/21/4d142104fd011376d605fcf183d17f5a.png",
"dominant_color": "#ac957e",
"is_video": false,
"reaction_counts": {},
"created_at": "Tue, 08 Sep 2026 19:07:37 +0000",
"board": {
"id": "1110559658053288101",
"name": "Pins by you",
"url": "https://www.pinterest.com/luxehomepics/_quick_creates/"
},
"pinner": {
"username": "luxehomepics",
"full_name": "Luxe Home Pics",
"follower_count": 6,
"is_verified_merchant": false,
"avatar_url": "https://i.pinimg.com/75x75_RS/a1/81/52/a18152b4354b776c7e15a8e5e7f567f2.jpg"
}
},
{
"id": "918241811565660117",
"url": "https://www.pinterest.com/pin/918241811565660117/",
"title": "Bright Minimalist Home Office with Natural Light",
"description": "Bright minimalist home office with large window and light wooden desk. Clean and calm workspace ideas.",
"domain": "Uploaded by user",
"image_url": "https://i.pinimg.com/originals/a9/a4/23/a9a423fa74fd76055cc9762c8ce6f61c.png",
"dominant_color": "#90755b",
"is_video": false,
"reaction_counts": {
"1": 1
},
"created_at": "Thu, 10 Sep 2026 15:05:20 +0000",
"board": {
"id": "918241880215199224",
"name": "Cozy Home Office Ideas",
"url": "https://www.pinterest.com/MaksimBulyginUC/cozy-home-office-ideas/"
},
"pinner": {
"username": "MaksimBulyginUC",
"full_name": "Maksim Studio | Cozy House & Desk Setup Ideas",
"follower_count": 5,
"is_verified_merchant": false,
"avatar_url": "https://i.pinimg.com/75x75_RS/17/e6/54/17e654fe15f2741d3b60d6d5ba4714d1.jpg"
}
},
{
"id": "1101341283912224659",
"url": "https://www.pinterest.com/pin/1101341283912224659/",
"title": "Warm Minimalist Home Office",
"description": "A compact workspace can still feel calm, beautiful, and highly functional. Light wood, soft neutrals, greenery, and natural light create a place where focus comes easily.",
"alt_text": "Bright compact home office with a light wood desk, ivory chair, plants, warm lamp, and large city-facing windows.",
"domain": "Uploaded by user",
"image_url": "https://i.pinimg.com/originals/a7/a2/2e/a7a22e9d7a33ef76ff1684baf98f58d4.jpg",
"dominant_color": "#ac8f72",
"is_video": false,
"reaction_counts": {},
"created_at": "Fri, 11 Sep 2026 20:44:41 +0000",
"board": {
"id": "1101341352566296548",
"name": "Warm Minimalist Home Decor",
"url": "https://www.pinterest.com/Modern_sanctuary/warm-minimalist-home-decor/"
},
"pinner": {
"username": "Modern_sanctuary",
"full_name": "Modern Sanctuary",
"follower_count": 1,
"is_verified_merchant": false,
"avatar_url": "https://i.pinimg.com/75x75_RS/4d/22/e8/4d22e83e475b6fbdf0cbfd7b3190683f.jpg"
}
},
{
"id": "961870432941881338",
"url": "https://www.pinterest.com/pin/961870432941881338/",
"title": "Modern Study Room with Floating Shelves | Minimal Home Office Decor",
"description": "Create a stylish and organized workspace with this modern study room idea. A sleek wooden desk, floating shelves, books, greenery, warm lighting, and minimal decor create a cozy yet functional home office. Perfect for small study spaces, work-from-home setups, and modern home decor inspiration. \nmodern study room\nstudy room decor\nfloating shelves decor\nhome office decor\nmodern home office\nminimalist study room\ndesk setup ideas\nworkspace decor\nsmall study room ideas\ncozy home office\nhome office organization \n#StudyRoomDecor #ModernStudyRoom #HomeOfficeDecor #FloatingShelves #MinimalistHome #DeskSetup #WorkspaceDecor #HomeOfficeIdeas #StudyRoomIdeas #ModernHomeDecor",
"domain": "Uploaded by user",
"image_url": "https://i.pinimg.com/originals/46/b8/e4/46b8e4cdc601894874d8f82a1911958e.png",
"dominant_color": "#77624c",
"is_video": false,
"reaction_counts": {
"1": 4
},
"created_at": "Thu, 03 Sep 2026 18:06:59 +0000",
"board": {
"id": "961870501605319300",
"name": "Cozy Home Decor Inspiration",
"url": "https://www.pinterest.com/ayesharaheel275/cozy-home-decor-inspiration/"
},
"pinner": {
"username": "ayesharaheel275",
"full_name": "Ayesha Raheel",
"follower_count": 29,
"is_verified_merchant": false,
"avatar_url": "https://i.pinimg.com/75x75_RS/d1/48/0d/d1480d639d39e18908fa29c43b7f0e3d.jpg"
}
},
{
"id": "480126010299493838",
"url": "https://www.pinterest.com/pin/480126010299493838/",
"title": "Minimalist Office Wall Decor for a Calm Workspace",
"description": "Keep your workspace focused with simple artwork, neutral colors, and clean framing. Perfect for modern home offices and small desks. Shop wall art prints for your home office click the link in the bio. #wallartprint #minimalistofficedecor",
"alt_text": "Keep your workspace focused with simple artwork, neutral colors, and clean framing. Perfect for modern home offices and small desks.\n Shop wall art prints for your home office click the link in the bio.\n#wallartprint #minimalistofficedecor",
"domain": "Uploaded by user",
"image_url": "https://i.pinimg.com/originals/56/97/2a/56972a3b378c385aab131283d0d30a67.png",
"dominant_color": "#a68d72",
"is_video": false,
"reaction_counts": {},
"created_at": "Thu, 10 Sep 2026 20:34:11 +0000",
"board": {
"id": "480126078963899468",
"name": "ideas",
"url": "https://www.pinterest.com/dianaluisresend/ideas/"
},
"pinner": {
"username": "dianaluisresend",
"full_name": "diana resende",
"follower_count": 30,
"is_verified_merchant": false,
"avatar_url": "https://i.pinimg.com/75x75_RS/eb/b7/91/ebb7918000ce137027fa15fe382cff51.jpg"
}
}
],
"bookmark": "Y2JVSG81V2sxcmNHRlpWM1J5VFVaU2NscEhSbE5XYTNCYVdWVlZNVlV4U1hwVWFsWlhVa1ZhVkZsWGMzZGtNRFZaVW0xR2JHSkZjRkZYVm1RMFZqQTFSMVZ1U2xaaVdFSnhWbTEwYzA1R1ZuUmpNMmhWVWpCd01WZHJVbUZXVmxwelUyNUdWVlpzY0hwYVJWcHJWMVp3Ums5WGVHbFNXRUl5Vm10YWFtVkdVbkpOU0dSUFUwZDRWMVpyVlRGaFJteFlZM3BHYW1KR1NuaFZNblJoVkcxR05sWnNXbGRXYkVwWVZrZDRTMUp0U2tWVmJHaFhZa1Z3TVZkclVrZGtNbEpIVm14c2FWSnVRazlaYTFaYVpXeGFSMWR0ZEZkTmExWXpWRlphYjFadFNsbFJiRVpYWVRKU2Rsa3hXbE5qTVZaMFVtMW9WMkpyU2twV1ZFbDRUa1pTYzFkcmFGVldSVXBaV1d4U1IxVkdiRlpYYms1clVteHdNRmxWVlRWV01VcFhZMGhrV0dKWVVsZFVWbHBMWXpGa1dXTkhkR3hoYTBVMVdtdGFWMU5YU2paVmJYaFRWMGRvUmxkc1ZsZGhNV1J6VjFod2FGSkdjRmxaYTJSdVpXeHdWbFpZYUZkV2ExcFdWbTF6TldGSFNsbFVhbHBYVW5wV00xWXljekZTYXpsV1ZteG9WMUpXY0ZCV2JYUmhVbTFXYzFSWWJHdFNNMUpYV1d0YVMxSldhM2RWYlRsVllrWnNNMVpzYUhkV1ZURklWV3QwWVZKRlJqUldNRnBQVjFkT1IxRnNaRk5XVmxreFZtcEtNRlV4VW5KTlZXUnFVbTFvV1ZaclZuZFZSbHB5Vm14a1QxWnRVbHBaTUdNeFZERktWVkpxUWxaaVZFVjNWa2N4VjJOc1dsVlJiR2hYWWtWd1VWZFhkRlpOUjFaWFdraFNUbFpVVmxoVVZWSlhaR3hhU0U1WVpHcGhlbFpJV1d0b1IxZEdXa1pqUjBaWFlURmFhRmt3V2xOa1IwNUlUMWRvVTFaRlZYbFdiR040VFVaV1IxTnJhRnBsYTFwWldWUktVMVV4Y0VWU2JtUlhWbXhhVmxaSGN6VlVhekI1WVVaR1YxWXphR2haVkVFMVVXeENWVTFVYUU1V1JWWXpWREZTV2s1Vk5UWlpla3BRVWtkamVWUnNVa1pOUlRVMVkwVm9WbFpZWkhoYWExSnJZVVU1U0ZadGRHRlNSMUp4VjFSS1NrMHdPVWhVV0d4UFlsWktjVlJyVWxOaFJuQjBVbTEwVDFaRlduUlhhMUpXVFRGc2RGTlljRTlTUmxwd1ZHMXdXazVHY0VoVmJYQk9WakJyZVZSV1pFdGhNWEJWVW0xb1RrMXJjSEZVYTFKV1RVVXhTRk5VVWxCV01YQnhWMWh3WVU5R1VuSldiR2h0VVZRd09XWkVSWGhOUkdzeVQxUmpNMDVxWnpST2FsVjRUa1JqY1ZJeFJrMUxibmh0VFVkTk0xbHFRWGhQUjFwb1drUlpNRTlVVW14Wk1rVTBXVlJKTWs5WFNUUmFSRmt3V1dwU2FGcHRUbWxQVjFWNVRtMVZkMXBxVVRWWlZHY3hXV3BCTTFwcVdYZFplbXh0VFdwcmVWbDZXbXBOVkdkNFprVTFSbFl6ZHowPXxVSG81UTA1NmFHOVRWa1p5VDBka1QxRlVNV1pOVkVKbVRGUkdPRTFVUlhkUFZGazFUbnBqTWs5RVp6Sk9WRVV3VG5sd1NGVlZkM0ZtUkVVMVRVUm9hRTU2VW1wYVJFa3dUbXBqZVU1dFRYbE5NbFpyVGxkU2JVNVhTWHBaYlVwdFRWZGFiVTlFUVhkT01scHBUbTFGTkU5RVRYZFplbWQ0VFZSWmVrNVVaelZaVkVrd1RXcG5lRTB5U210WmVsSTRWR3RXV0daQlBUMD18Tm9uZXwxMTA5Njk3NzY4ODY1MTQ3KkdRTCp8MDY1N2E0ZTQwNjU5YzA3MzM1ZjM2MDNhZjcyNjJiYThiN2ExZGQxMDkzNTgxZTBiM2I2YzdlMTJhYThmYzkwZXxORVd8"
}
}Why this is hard manually
Pinterest's search feed is a mixed grid, and it comes back mixed. Our 'home decor' search returned 14 rows: one was a UI module titled 'Explore featured boards' with no image and no author, five were thin rows carrying only an id, a URL and a pinner, and eight were complete pins with description, alt text, image, board, outbound link and reaction counts. Eight of fourteen is the real yield, and nothing in the row's type says which kind it is.
The field that separates them is image_url. A row without one is not a pin you can use - it is a module or a stub - and filtering on its presence is the one-line fix that turns a noisy feed into a clean dataset. Filtering on title does not work: the UI module had a title and five real rows had title null.
The second thing to know is that Pinterest is a link graph as much as an image board, and the outbound link is the field most people forget to keep.
Why ReefAPI solves it
A full pin carries the fields that make Pinterest useful for commerce research rather than just for pictures: link (the destination, 'https://hadleyjamesathome.com/products/hawthorne-vintage-wall-sconce') and domain ('hadleyjamesathome.com') alongside the image. That pair turns a visual trend feed into a list of merchants who are winning attention in a category - which product pages people are actually pinning, and from whose store.
alt_text and description are different fields and both are worth keeping. description is the pinner's marketing copy; alt_text is the accessibility text and reads like a literal scene description ('antique brass styled in a traditional hallway above a wood console table and mirror'). For training a classifier or matching a visual style, the alt text is usually the cleaner signal because nobody writes it to sell.
dominant_color arrives as a hex value ('#a88f74') computed by Pinterest, which is a free colour-trend axis - grouping a season's pins by hue takes no image processing on your side. created_at is an RFC-822 string, and board comes as an object with id, name and URL, so a promising pin leads straight to board and board_pins without a lookup.
reaction_counts is a map keyed by reaction type rather than a single number - {'1': 299} on our test pin. Read the values rather than assuming a scalar, because the shape changes when a pin collects more than one reaction type.
Profiles are exact where they are populated and one field is not: nike returned follower_count 1,088,701, following_count 3, board_count 10 and is_verified_merchant, but pin_count 0 for an account that plainly has pins. Do not use pin_count as an activity measure - count what user_pins actually returns instead. That is our defect to fix, and it is the kind of thing that only shows up when you check a field against a profile you can eyeball.
Thirteen actions share the engine - search_pins, search_videos, search_users, search_boards, suggestions, pin, pin_comments, related_pins, profile, user_boards, user_pins, board and board_pins - and every paginated one takes a bookmark cursor rather than a page number. related_pins from a single well-performing pin is usually a better discovery path than a broader search query, because it follows Pinterest's own similarity graph instead of its keyword matching. Search took about 10 seconds; profile answered in under a second.
Questions developers ask
Do I need a Pinterest developer account?
No. You send a ReefAPI key and read public content. There is no Pinterest app registration or OAuth flow involved.
Why does my search return rows with no image?
Because Pinterest's search feed mixes real pins with UI modules and thin stubs. Ours returned one module ('Explore featured boards'), five stubs and eight full pins. Filter on image_url - title is not reliable, since the module had one and five real rows did not.
What is dominant_color for?
Pinterest computes it and we pass it through as hex ('#a88f74'). It gives you a colour-trend axis across a category without doing any image processing yourself.
Why is reaction_counts an object?
Because Pinterest tracks reactions by type. Ours came back as {'1': 299}. Sum the values rather than expecting a single number, since the shape grows when a pin collects more than one type.
Is pin_count reliable on a profile?
No, and this one is ours to fix - nike returned pin_count 0 alongside board_count 10 and over a million followers. Use user_pins and count what comes back if you need an activity measure.
What is the difference between description and alt_text?
description is what the pinner wrote to sell the pin; alt_text is the accessibility description of what is in the image. They often disagree, and for anything analytical the alt text is the more literal of the two.
How do I find more of a niche once I have one good pin?
related_pins on that pin's id. It walks Pinterest's own similarity graph, which surfaces material that keyword search misses entirely.