> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_pinterest

# 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`](https://parel.si/docs/tools/search_google_images.md) for Google's image results, [`search_instagram_reels`](https://parel.si/docs/tools/search_instagram_reels.md) 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

```bash
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:

```json
{
  "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

- [`search_google_images`](https://parel.si/docs/tools/search_google_images.md)
- [`search_instagram_reels`](https://parel.si/docs/tools/search_instagram_reels.md)
