CaptapiCaptapi
Pinterest · Guide

How to run a Pinterest search

TL;DR
To run a Pinterest search, sign up for a free Captapi key, then send one GET request to /v1/pinterest/search with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. Keyword pin search — offset cursor, search window 40, flat 2 credits.
Get your free API keyAPI reference

How to run a Pinterest search (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the Pinterest Search API

    Send an authenticated GET request to /v1/pinterest/search with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/pinterest/search?q=living%20room%20decor" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "requested": 200,
    "totalReturned": 2,
    "listingHits": 40,
    "hasMore": false,
    "nextCursor": null,
    "results": [
      {
        "platform": "pinterest",
        "id": "e1_AfqPShxcd8FI1Mzk_H6iLpBKJtreSMD_6BzVlc4ovgbxb_MiiQmvVw",
        "url": "https://www.pinterest.com/pin/e1_AfqPShxcd8FI1Mzk_H6iLpBKJtreSMD_6BzVlc4ovgbxb_MiiQmvVw/",
        "title": "Sage Green Living Room Inspiration with Warm, Layered Textures",
        "description": "There's something so inviting about a living room built around warm, earthy tones. Sage green walls, a floating media console, and a sunken wood shelving nook create depth, while a jute rug, knit throw, and rust-toned pillows add softness and texture. A beautifully layered space worth saving for inspiration.",
        "seoAltText": "Living room with sage green accent wall, wood built-in shelf, round wood coffee table, and sectional sofa with knit throw.",
        "domain": "Uploaded by user",
        "image": "https://i.pinimg.com/736x/f1/b3/01/f1b30118a60baca76da9baa452d10d82.jpg",
        "images": {
          "170x": {
            "url": "https://i.pinimg.com/236x/f1/b3/01/f1b30118a60baca76da9baa452d10d82.jpg",
            "width": 236,
            "height": 354
          },
          "236x": {
            "url": "https://i.pinimg.com/236x/f1/b3/01/f1b30118a60baca76da9baa452d10d82.jpg",
            "width": 236,
            "height": 354
          },
          "474x": {
            "url": "https://i.pinimg.com/474x/f1/b3/01/f1b30118a60baca76da9baa452d10d82.jpg",
            "width": 474,
            "height": 711
          },
          "736x": {
            "url": "https://i.pinimg.com/736x/f1/b3/01/f1b30118a60baca76da9baa452d10d82.jpg",
            "width": 736,
            "height": 1104
          },
          "orig": {
            "url": "https://i.pinimg.com/originals/f1/b3/01/f1b30118a60baca76da9baa452d10d82.png",
            "width": 1024,
            "height": 1536
          }
        },
        "dominantColor": "#735a3e",
        "reactionCount": 109,
        "createdAt": "2026-10-01T22:05:34Z",
        "board": {
          "name": "Living Room",
          "url": "https://www.pinterest.com/aryaspaces/living-room/",
          "pinCount": 31,
          "collaborative": false
        },
        "author": {
          "id": "1111052307980091292",
          "username": "aryaspaces",
          "displayName": "Arya Spaces | Home Décor & Organization",
          "followers": 22,
          "avatar": "https://i.pinimg.com/30x30_RS/77/09/be/7709be34f4f774a96ac0fe2ecf4e8506.jpg",
          "avatarMedium": "https://i.pinimg.com/75x75_RS/77/09/be/7709be34f4f774a96ac0fe2ecf4e8506.jpg",
          "avatarLarge": "https://i.pinimg.com/140x140_RS/77/09/be/7709be34f4f774a96ac0fe2ecf4e8506.jpg",
          "isVerifiedMerchant": false
        },
        "imageOriginal": "https://i.pinimg.com/originals/f1/b3/01/f1b30118a60baca76da9baa452d10d82.png",
        "link": null,
        "richPinType": null
      },
      {
        "platform": "pinterest",
        "id": "e1_AfqPShwaTkPtRbl_y7gih9_iOTVOMHb7_t2_K470HNTikTWOx00b",
        "url": "https://www.pinterest.com/pin/e1_AfqPShwaTkPtRbl_y7gih9_iOTVOMHb7_t2_K470HNTikTWOx00b/",
        "title": "Bright Living Room: Cozy, Light-Filled Space",
        "description": "Discover a stylish living room with abundant natural light and spacious windows. Explore cozy furniture layouts, premium textures, and airy design ideas to elevate your home",
        "seoAltText": "a living room filled with furniture and lots of windows",
        "domain": "Uploaded by user",
        "image": "https://i.pinimg.com/736x/01/ef/c8/01efc833665d9f08b5a7527d5037e002.jpg",
        "images": {
          "170x": {
            "url": "https://i.pinimg.com/236x/01/ef/c8/01efc833665d9f08b5a7527d5037e002.jpg",
            "width": 236,
            "height": 348
          },
          "236x": {
            "url": "https://i.pinimg.com/236x/01/ef/c8/01efc833665d9f08b5a7527d5037e002.jpg",
            "width": 236,
            "height": 348
          },
          "474x": {
            "url": "https://i.pinimg.com/474x/01/ef/c8/01efc833665d9f08b5a7527d5037e002.jpg",
            "width": 474,
            "height": 699
          },
          "736x": {
            "url": "https://i.pinimg.com/736x/01/ef/c8/01efc833665d9f08b5a7527d5037e002.jpg",
            "width": 736,
            "height": 1085
          },
          "orig": {
            "url": "https://i.pinimg.com/originals/01/ef/c8/01efc833665d9f08b5a7527d5037e002.jpg",
            "width": 1206,
            "height": 1779
          }
        },
        "dominantColor": "#79583c",
        "reactionCount": 9,
        "createdAt": "2026-10-08T21:35:33Z",
        "board": {
          "name": "Living room",
          "url": "https://www.pinterest.com/avislegros346/living-room/",
          "pinCount": 602,
          "collaborative": false
        },
        "author": {
          "id": "919367848839946069",
          "username": "avislegros346",
          "displayName": "Avis Legros",
          "followers": 73,
          "avatar": "https://i.pinimg.com/30x30_RS/0a/2f/80/0a2f8011271fc0134625e77546bb6f11.jpg",
          "avatarMedium": "https://i.pinimg.com/75x75_RS/0a/2f/80/0a2f8011271fc0134625e77546bb6f11.jpg",
          "avatarLarge": "https://i.pinimg.com/140x140_RS/0a/2f/80/0a2f8011271fc0134625e77546bb6f11.jpg",
          "isVerifiedMerchant": false
        },
        "imageOriginal": "https://i.pinimg.com/originals/01/ef/c8/01efc833665d9f08b5a7527d5037e002.jpg",
        "link": null,
        "richPinType": null
      }
    ],
    "truncatedReason": "search-window",
    "query": "living room decor"
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
qstring YesKeywords or search query (min 2 characters).
limitintegerNoMax items to return (default 25, max 200). Flat 2 credits per call.
cursorstringNoPagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the search window (max 40).
cachebooleanNoSet true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Frequently asked questions

What does the Pinterest Search API do?

The Pinterest Search API lets you search and return matching results from a public Pinterest query using one GET request to /v1/pinterest/search. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Pinterest Search API cost?

Each successful call costs 2 credits. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a Pinterest API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle access, rate limits, retries, and authentication for you.

Is the Pinterest Search API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

Ready to run a Pinterest search?

Start free with 100 credits — no credit card required.

Get your free API key