CaptapiCaptapi
Pinterest
GET /v1/pinterest/search

Pinterest Search API

Search Pinterest programmatically and get structured, ranked results.

13 credits per request (0.5 per result)
Get your API key — freeRead the docs
TL;DR
The Pinterest Search API (Pinterest) returns search Pinterest programmatically and get structured, ranked results. It's a single authenticated GET request to /v1/pinterest/search that responds with clean JSON, costs 13 credits, and is cached for 24 hours (repeat calls are free). Start with 100 free credits — no credit card.

What is the Pinterest Search API?

The Pinterest Search API lets you search and return matching results from Pinterest with a single REST call. No OAuth, no scraping infrastructure, and no platform SDKs — send the URL, get clean structured JSON back. Results are cached for 24 hours, so repeat lookups are instant and free.

What you get

  • Ranked, structured result list
  • Title, URL, author, and thumbnail per result
  • Engagement metrics where available
  • Configurable result limit

Try it

Fill in the parameters below and copy a ready-to-run request in your language of choice.

Parameters

curl "https://api.captapi.com/v1/pinterest/search?q=skincare" \
  -H "Authorization: Bearer capt_live_..."

Edit the parameters and the code updates instantly. Switch languages and hit copy.

Example response

{
  "success": true,
  "cached": false,
  "creditsUsed": 13,
  "data": {
    "query": "living room decor",
    "totalReturned": 5,
    "results": [
      {
        "platform": "pinterest",
        "id": "422281212828530",
        "url": "https://www.pinterest.com/pin/422281212828530/",
        "title": "a living room filled with lots of furniture next to a wall mounted book shelf and lamp",
        "description": null,
        "destinationUrl": null,
        "image": "https://i.pinimg.com/originals/51/a2/0e/51a20efe23e50376920012d832a191a2.webp",
        "saves": 493,
        "comments": null,
        "publishedAt": "Wed, 10 Jun 2026 11:31:28 +0000",
        "board": {
          "name": "Sala",
          "url": "https://www.pinterest.com/camilarmoutinho/sala/"
        },
        "author": {
          "username": "camilarmoutinho",
          "displayName": "Camila Moutinho",
          "followers": 7
        }
      },
      {
        "platform": "pinterest",
        "id": "8022105582740391",
        "url": "https://www.pinterest.com/pin/8022105582740391/",
        "title": "a living room with wooden slats and white vases",
        "description": null,
        "destinationUrl": null,
        "image": "https://i.pinimg.com/originals/f9/55/70/f955705b720e07af776824615f92690e.jpg",
        "saves": 1534,
        "comments": null,
        "publishedAt": "Mon, 26 Jan 2026 10:52:45 +0000",
        "board": {
          "name": "Downstairs space",
          "url": "https://www.pinterest.com/nicolelind68/downstairs-space/"
        },
        "author": {
          "username": "nicolelind68",
          "displayName": "Nicole Lind",
          "followers": 120
        }
      },
      {
        "platform": "pinterest",
        "id": "385198574402777183",
        "url": "https://www.pinterest.com/pin/385198574402777183/",
        "title": "the living room is clean and ready for us to use it's lighting fixtures",
        "description": "Discover modern home decor, elegant interiors, cozy living spaces, organization tips, and decorating inspiration for every room in your home.",
        "destinationUrl": null,
        "image": "https://i.pinimg.com/originals/b3/0e/5c/b30e5cb8fb5203e1c89ebe1e7b4793e7.png",
        "saves": 10,
        "comments": null,
        "publishedAt": "Wed, 24 Jun 2026 20:58:41 +0000",
        "board": {
          "name": "Home",
          "url": "https://www.pinterest.com/rmiu/home/"
        },
        "author": {
          "username": "rmiu",
          "displayName": "Roxana Miu",
          "followers": 71
        }
      },
      {
        "platform": "pinterest",
        "id": "844493676270632",
        "url": "https://www.pinterest.com/pin/844493676270632/",
        "title": "Modern Living Room Decor Ideas to Transform Your Home",
        "description": "Transform your living room with modern décor ideas that blend style, comfort, and trending Amazon must-have items. Explore chic furniture, warm lighting, and smart accessories to create a cozy and stylish space. Perfect inspiration for home décor lovers!",
        "destinationUrl": null,
        "image": "https://i.pinimg.com/originals/1f/6f/8f/1f6f8f98e43574874e6e23c2caef6de7.jpg",
        "saves": 465,
        "comments": null,
        "publishedAt": "Tue, 23 Dec 2025 18:36:14 +0000",
        "board": {
          "name": "Living",
          "url": "https://www.pinterest.com/monylosol/living/"
        },
        "author": {
          "username": "monylosol",
          "displayName": "MoniLoveSol",
          "followers": 6654
        }
      },
      {
        "platform": "pinterest",
        "id": "492649955089158",
        "url": "https://www.pinterest.com/pin/492649955089158/",
        "title": "Iron shelves, wooden coffee table and wicker chandeliers",
        "description": "Essential elements of a cozy and vintage home feel...☀️ Do not forget to check my profile for links to other products.🙏 #ad #commissionsearned",
        "destinationUrl": "https://www.amazon.com/HealSmart-Moving-Easily-Organizer-Shelves/dp/B09CCM1FT6/ref=sr_1_3?crid=3KIFIQ1RAI2TJ&dib=eyJ2IjoiMSJ9.jawCDFWaKabvRYL8hQ17JyMWsHrpR5gcMlcJvD5C7WLiTki7p9uHbXL0VvAFV544K7LcPO6cQaQkGh43pC7EyeHsteRiZCflUHoK3MzZrdWRWgPTgxC5IV_X5EwMlLZW2jqGCS2GQXS5KLoKLZekke7f9lOYHO6b_-zYw4MGPHqZ1wIFgiJok9QxORQ06q5CgaV-Ancll4NbTEQpsPZWsHnMxNXx4ed77NEvJpBJoLiKAuByIqpe40jL3_PeJ1SIFbAneoHFENSrEqaqpFr8jmjdGB91eFPwY15SM5TVwuo.uhqFv0baMs51bBZCCpMoghN95wpq1qpSGzVMhyHQJZA&dib_tag=se&keywords=iron%2Bshelf&qid=1777054851&sprefix=iron%2Bshelf,aps,285&sr=8-3&th=1",
        "image": "https://i.pinimg.com/originals/06/99/72/0699729b104e252466df7f25df397f19.jpg",
        "saves": 801,
        "comments": null,
        "publishedAt": "Sat, 13 Jun 2026 21:58:12 +0000",
        "board": {
          "name": "My Dream Home",
          "url": "https://www.pinterest.com/morganrianna/my-dream-home/"
        },
        "author": {
          "username": "morganrianna",
          "displayName": "Morgan Rianna",
          "followers": 155
        }
      }
    ]
  }
}

Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Result

  • totalNumber of results returned.

Each result

Each item in results contains:

  • titleResult title.
  • urlDirect URL to the content.
  • authorCreator handle.
  • viewsView count where available.

Parameters

NameTypeRequiredDescription
qstringYesKeywords or search query (min 2 characters).
limitintegerNoMax items to return (default 25, max 200). Billed per result.

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 13 credits — billed per result, so the exact amount scales with how many items you request. Repeat calls for the same request are served from cache for free (metrics refresh within ~1 hour).

Using an AI agent? This endpoint is the MCP tool pinterest_search via @captapi/mcp. Set it up →

How it works

  1. 1. Sign up — get 100 free credits, no card required.
  2. 2. Create a key from your dashboard.
  3. 3. Send one request to /v1/pinterest/search and parse the JSON response.

Use cases

Trend Discovery

Find trending content by keyword or hashtag.

Content Sourcing

Build feeds and playlists programmatically.

Monitoring

Track topics, brands, and competitors.

Research

Sample large sets of content for analysis.

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 scraping setup required.

How many credits does the Pinterest Search API cost?+

Each successful call costs 13 credits. Responses are cached for 24 hours, and cached results cost 0 credits. 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, and Rumble. We handle proxies, 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, automatic retries, and a shared 24-hour cache. Use it for RAG pipelines, analytics, monitoring, and content automation.

More Pinterest APIs

Pinterest Pin Details APIPinterest User Pins APIPinterest Board APIPinterest User Boards API

Ready to use the Pinterest Search API?

Sign up, grab your key, and make your first call in 60 seconds.

Get started free