search_pinterest
Pinterest pins for a keyword: title, description, image, linked page and domain, board and pinner. ₹0.28 per page; a result that finds nothing is ₹0.
What it does
Pins on Pinterest matching a keyword: data with each pin's title, description, images, the page it links to and its domain, the board and the pinner, plus a cursor for the next page.
Use it to see how a product category is styled and which sites get pinned; search_google_images for Google's image results, search_instagram_reels for video. Flat price per page; nothing matching is free. Two to five seconds.
India: Indian fashion, food and decor are heavily pinned; add India or a city to the query when the place matters.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
query | string | yes | The search text ("minimal skincare shelf"). |
cursor | string | no | The cursor from the previous answer, for the next page. |
What drives the cost
Flat per page; pass cursor for the next page. Answers are trimmed to the useful fields. A result that finds nothing is class: "ok_free", ₹0. The timeout is 30 seconds.
Price today
| Price today | ₹0.28 per page (cost_paise: 28) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.42 (hold_paise: 42); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0 |
| Timeout | 30 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "search_pinterest" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "search_pinterest" |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |
Request
curl https://api.parel.si/v1/run \
-H "Authorization: Bearer $PAREL_KEY" \
-H "Content-Type: application/json" \
-d '{"tool":"search_pinterest","input":{"query":"minimal skincare shelf"}}'
What comes back
data, as the live check of 2026-11-05 recorded it, trimmed:
{
"pins": [
{
"id": "1049198044453951992",
"url": "https://www.pinterest.com/pin/1049198044453951992",
"description": " ",
"created_at": "Thu, 29 Jan 2026 10:09:54 +0000",
"pinner": {
"node_id": "VXNlcjoxMDQ5MTk4MTgxODQ3NDUwMTc4",
"is_ads_only_profile": false,
"image_large_url": "https://i.pinimg.com/140x140_RS/af/08/d5/af08d519b357ffedf87e52872d496c5d.jpg",
"verified_identity": {
"verified": true
},
"full_name": "a_user_96",
"image_medium_url": "https://i.pinimg.com/75x75_RS/af/08/d5/af08d519b357ffedf87e52872d496c5d.jpg",
"username": "a_user_97",
"follower_count": 108,
"id": "1049198181847450178",
"is_verified_merchant": false,
"image_small_url": "https://i.pinimg.com/30x30_RS/af/08/d5/af08d519b357ffedf87e52872d496c5d.jpg"
},
"images": {
"170x": {
"width": 236,
"height": 353,
"url": "https://i.pinimg.com/236x/ed/e7/d0/ede7d0db245a78da62dad9657905d2e4.jpg"
},
"236x": {
"width": 236,
"height": 353,
"url": "https://i.pinimg.com/236x/ed/e7/d0/ede7d0db245a78da62dad9657905d2e4.jpg"
},
"474x": {
"width": 474,
"height": 709,
"url": "https://i.pinimg.com/474x/ed/e7/d0/ede7d0db245a78da62dad9657905d2e4.jpg"
},
"736x": {
"width": 736,
"height": 1102,
"url": "https://i.pinimg.com/736x/ed/e7/d0/ede7d0db245a78da62dad9657905d2e4.jpg"
},
"orig": {
"width": 736,
"height": 1102,
"url": "https://i.pinimg.com/originals/ed/e7/d0/ede7d0db245a78da62dad9657905d2e4.jpg"
}
}
},
{
"id": "1145673592736380491",
"url": "https://www.pinterest.com/pin/1145673592736380491",
"description": " ",
"created_at": "Mon, 03 Aug 2026 20:38:24 +0000",
"pinner": {
"node_id": "VXNlcjoxMTQ1NjczNzMwMTE1NTI3NDUz",
"is_ads_only_profile": false,
"image_large_url": "https://i.pinimg.com/140x140_RS/45/3a/fc/453afc0207e872fe24719002d987091a.jpg",
"verified_identity": {},
"full_name": "a_user_98",
"image_medium_url": "https://i.pinimg.com/75x75_RS/45/3a/fc/453afc0207e872fe24719002d987091a.jpg",
"username": "a_user_99",
"follower_count": 0,
"id": "1145673730115527453",
"is_verified_merchant": false,
"image_small_url": "https://i.pinimg.com/30x30_RS/45/3a/fc/453afc0207e872fe24719002d987091a.jpg"
},
"images": {
"170x": {
"width": 236,
"height": 314,
"url": "https://i.pinimg.com/236x/00/98/d0/0098d082e96c3c28815a665639c80cc7.jpg"
},
"236x": {
"width": 236,
"height": 314,
"url": "https://i.pinimg.com/236x/00/98/d0/0098d082e96c3c28815a665639c80cc7.jpg"
},
"474x": {
"width": 474,
"height": 631,
"url": "https://i.pinimg.com/474x/00/98/d0/0098d082e96c3c28815a665639c80cc7.jpg"
},
"736x": {
"width": 736,
"height": 981,
"url": "https://i.pinimg.com/736x/00/98/d0/0098d082e96c3c28815a665639c80cc7.jpg"
},
"orig": {
"width": 3008,
"height": 4010,
"url": "https://i.pinimg.com/originals/00/98/d0/0098d082e96c3c28815a665639c80cc7.jpg"
}
}
},
{
"id": "1146869861397317004",
"url": "https://www.pinterest.com/pin/1146869861397317004",
"description": "Love minimalist skincare and clean bathroom aesthetics? 🤍 Discover The Ordinary skincare collection featuring cleansers, hydrating serums, toners, moisturizers, and targeted skincare treatments displayed in a modern shower space.\n\nGet insp…",
"created_at": "Sun, 25 Oct 2026 11:32:46 +0000",
"pinner": {
"node_id": "VXNlcjoxMTQ2ODY5OTk4NzY2NjAxODM0",
"is_ads_only_profile": false,
"image_large_url": "https://i.pinimg.com/140x140_RS/b9/22/6a/b9226abdd588513f1cc7d9a977de75ae.jpg",
"verified_identity": {},
"full_name": "a_user_100",
"image_medium_url": "https://i.pinimg.com/75x75_RS/b9/22/6a/b9226abdd588513f1cc7d9a977de75ae.jpg",
"username": "a_user_100",
"follower_count": 2,
"id": "1146869998766601834",
"is_verified_merchant": false,
"image_small_url": "https://i.pinimg.com/30x30_RS/b9/22/6a/b9226abdd588513f1cc7d9a977de75ae.jpg"
},
"images": {
"170x": {
"width": 236,
"height": 354,
"url": "https://i.pinimg.com/236x/4f/c9/bd/4fc9bd59f6005c5679bf0a3137a3b052.jpg"
},
"236x": {
"width": 236,
"height": 354,
"url": "https://i.pinimg.com/236x/4f/c9/bd/4fc9bd59f6005c5679bf0a3137a3b052.jpg"
},
"474x": {
"width": 474,
"height": 711,
"url": "https://i.pinimg.com/474x/4f/c9/bd/4fc9bd59f6005c5679bf0a3137a3b052.jpg"
},
"736x": {
"width": 736,
"height": 1104,
"url": "https://i.pinimg.com/736x/4f/c9/bd/4fc9bd59f6005c5679bf0a3137a3b052.jpg"
},
"orig": {
"width": 1024,
"height": 1536,
"url": "https://i.pinimg.com/originals/4f/c9/bd/4fc9bd59f6005c5679bf0a3137a3b052.png"
}
}
}
],
"cursor": "Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWlVSbXRXTVVZMldWVlZNVlV4U2xoa1JGSlhVbnBXTTFadGMzZGtNREZXVm14b1YxSldjRkJYVm1Rd1Ztc3hWMVZ1VGxaaVZGWnpXVlJPVTJWV1pISlhhM1JYVm10V05sVldVbE5XVmxwWFUyeGtZVlpzVlhoWk1WcDNUbXhTZEZKc1pGTmlSbFl6Vm1wS01GVXlSbkpOV0U1cFUw…"
}
Notes
- Flat per page; pass cursor for the next page. Answers are trimmed to the useful fields.
- The linked page's domain tells you which sites win the visual search.
- Pinterest always answers something: a vague keyword returns loosely related pins rather than nothing.
Siblings
This page as Markdown: /docs/tools/search_pinterest.md. Something wrong or missing: hello@parel.si.