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.

FieldTypeRequiredDescription
querystringyesThe search text ("minimal skincare shelf").
cursorstringnoThe 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_pinterest"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_pinterest"
Confirmationnot 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.