# Pinterest Scraper API: 11 Endpoints, Typed JSON | Scrapier (https://scrapier.io/scrapers/pinterest/)

> Pinterest scraper API with 11 endpoints: board pins, pin search and video pins as typed JSON with image links. 1 or 2 credits per call. Get a free API key.

Last updated: 2026-11-10

## Pinterest Scraper API: _11 endpoints_, structured JSON

Board pins, pin search and video pin search, with titles, descriptions, images, outbound links and engagement: every Pinterest endpoint Scrapier ships, each returning typed JSON in the same response envelope. Public data only.

[Get a free API key →](https://app.scrapier.io/sign-up)

Copy for your AI agent

**11**Pinterest endpoints

**1**credit per successful call

**0**credits for a failed call

**3**need no Pinterest login

Quick answerScrapier returns typed JSON from **11 Pinterest endpoints**: board pins, pin search and video pin search, with images, links and engagement. Public data only and no proxies; no Pinterest login needed. 1 credit per successful call; failed calls are free. Last verified 9 Nov 2026

Endpoints

## What data can I extract with Pinterest Scraper?

Pick the data you need. Each endpoint takes a board or pin link, or a keyword, and gives you clean JSON back, for 1 or 2 credits per successful call.

### Board pinsStart here

`**GET**/api/v2/pinterest-boards/`

Every pin on a public board, or one pin by URL: image, title, description, link, repins and board details.

1 credit per call_View →Page soon_

### Pin comments

`**IN**inp`

Comments on a pin, with the commenter, text, like count, helpful count and attached images or videos.

Same API key and JSON envelope

### Pin search

`**GET**/api/v2/pinterest-search/`

Pins that match a keyword, with image size, board, pinner, creator and reaction counts.

1 credit per call_View →Page soon_

### Pins and video search

`**GET**/api/v2/pinterest-pins-videos/`

Pin or video search by keyword; video mode returns only pins with a playable video link.

1 credit per call_View →Page soon_

### Keyword discovery

`**IN**Keywords`

Search suggestions Pinterest shows for a keyword and its variations, one row per suggestion.

Same API key and JSON envelope

### Profile

`**IN**INPUT`

A public profile: about text, pin count, board count, profile image, last pin save time and profile tabs.

Same API key and JSON envelope

### Followers

`**IN**usernames`

The followers of a public profile, with username, full name, profile image and profile URL.

Same API key and JSON envelope

### Following

`**IN**INPUTS`

Accounts a profile follows, with pin and board counts, follower count and verification. Takes a Pinterest session.

Same API key and JSON envelope

### Ad repository

`**IN**country`

Ads shown in a country and date range: advertiser names, run dates, targeted ages, genders and locations.

Same API key and JSON envelope

### Email finder

`**IN**keywords`

Public emails found on Pinterest pages for a keyword, with the page title, description and URL.

Live on the Social media emails page

### Phone number finder

`**IN**keywords`

Public phone numbers found on Pinterest pages for a keyword, with country, dial code and page URL.

Same API key and JSON envelope

Playground

## Try Pinterest Scraper Live

Pick an endpoint, fill in the input and press **Run**. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.

Pinterest**Board pins**Live

Platform

Endpoint

Parameters

### \+ Run live with your API key

Response

Sample dataCatalog sample, run to see live data

Pricing

## How much will scraping Pinterest cost?

Every successful call costs 1 credit, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.

On Pro, 1,000 calls at 1 credit cost $1.58. Scale brings that to $1.20, so 250,000 Pinterest calls a month is $299.

[See all plans →](https://scrapier.io/pricing/)

| Plan | Price / mo | Credits / mo | Per 1,000 calls |
| --- | --- | --- | --- |
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $1.93 |
| Pro | $79 | 50,000 | $1.58 |
| Scale | $299 | 250,000 | $1.20 |

How to

## How do I use Pinterest Scraper?

Built to be easy to start with, even if you've never scraped a website. Here's how to get Pinterest data in a few minutes:

[Get a free API key →](https://app.scrapier.io/sign-up)

1. **Create a free Scrapier account**[Sign up](https://app.scrapier.io/sign-up) with your email and copy your API key.
2. **Pick the endpoint for your data**Board pins, pin search or video pin search.
3. **Add your input**One board or pin URL, or one keyword, per call.
4. **Page through the results**Every Pinterest endpoint returns `next_cursor`; pass it back as `cursor` for the next page.
5. **Search pins or videos**Send a keyword in `queries` to `pinterest-search`; set `content_filter` to `videos` for video pins.
6. **Run the request**One GET with your key in the `X-API-Key` header, or ask your AI agent over MCP.
7. **Save the results**JSON from the API: store it as is, or flatten it to CSV in a few lines.

Input

## Input

Two ways in. Use whichever matches what you already have.

1

### By keyword

You don't know the items yet: find them with a keyword.

Pin search`wallpaper`

Pins and video search`minimalist interior`

Best fordiscovery · plain text, "travel" not "#travel"

2

### By URL

You already have the links to the pages you want.

Board pins`pinterest.com/officialflawliz/cherry-cola-lips/`

Best forknown pages · paste the link as it is

Example requests

// GET /api/v2/pinterest-boards/
{
  "urls": "https://www.pinterest.com/officialflawliz/cherry-cola-lips/"
}

| Send this | Parameter | And you can get |
| --- | --- | --- |
| Board URL | `urls` | Every pin on the board, with image, link, repins and board details |
| Pin URL | `urls` | That pin's image, title, description and link |
| Keyword | `queries` · `content_filter` | Matching pins, or video pins only |
| Keyword, videos only | `queries` · `filter_type` | Pins with a playable video link |

Optional on list endpoints: `cursor` (pass back `next_cursor` for the next page). Auth is one header: `X-API-Key`. Send parameters in the query string (GET) or as a JSON body (POST).

Output

## Output

The one thing to know: **each data type has its own shape**. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.

// GET /api/v2/pinterest-boards/?urls=https://www.pinterest.com/officialflawliz/cherry-cola-lips/
// one item of data.pins · catalog sample
{
  "imageUrl": "https://i.pinimg.com/originals/aa/bb/cc/aabbcc.jpg",
  "description": "Cherry cola lips makeup look",
  "title": "Cherry Cola Lips",
  "pinUrl": "https://www.pinterest.com/pin/1125968710103999/",
  "externalLink": "https://example.com/cherry-cola-lip-combo",
  "repins": 1520,
  "date": "2026-09-28",
  "boardName": "cherry cola lips",
  "user": "officialflawliz",
  "index": 1,
  "boardDescription": "Cherry cola lip combos and inspo",
  "boardUrl": "https://www.pinterest.com/officialflawliz/cherry-cola-lips/",
  "totalPins": 128,
  "input\_url": "https://www.pinterest.com/officialflawliz/cherry-cola-lips/",
  "scrapedAt": "2026-10-06"
}

Every response is `{"success": true, "data": {…}}`: your input echoed back, the result under its own key (`profile`, `posts`, `comments`…) and `next_cursor` for the next page.

Use cases

## What can you do with Pinterest data?

Public Pinterest data powers trend research, product and content ideas, competitor analysis and visual datasets. Here are four common jobs, and the Pinterest scraper endpoints each one chains together.

01

### Trend and content research

Search the keywords of your niche and collect the top pins, their sources and how they are framed. See which styles, colours and formats people save, before you plan a campaign or a product line.

1. _1_search
2. _2_pins-videos
3. Mood board

WeeklySheets, Notion

02

### Competitor board tracking

Pull every pin on a competitor's or a creator's public boards, with repins and the outbound link of each pin. Learn which products and pages they promote, and which pins people save most.

1. _1_boards
2. Benchmark

WeeklyDashboard

03

### Traffic source discovery

Search a topic and group the pins by domain and outbound link to find the sites and shops Pinterest sends traffic to in your market.

1. _1_search
2. _2_boards
3. Domain list

MonthlyCRM, CSV

04

### Visual datasets for AI

Collect pin images with their titles, descriptions, dominant colours and sizes for a keyword, to train or test image models, or to feed a visual search index.

1. _1_search
2. _2_pins-videos
3. Image set

On demandObject storage, LLM

Features

## Features

Pinterest Scraper fetches clean, structured Pinterest data at low cost: built for trend research, competitor tracking, visual datasets and AI agents.

### Live data, every call

Each request reads Pinterest at call time, so pins and counts are current when the call runs.

### Typed, consistent JSON

Same field names on every call, image sizes and counts as integers, ready for code, sheets or an LLM.

### Lists, page by page

Every endpoint returns `next_cursor`; run up to 3 requests in parallel per key.

### Boards, pins and videos

3 live endpoints share the same envelope and auth as every other Scrapier platform.

### MCP-ready for AI agents

The Scrapier MCP server reaches every endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

### Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

### No login, no proxies

Public data only. No Pinterest account, developer app or session cookie needed for the live endpoints.

### Maintained for you

When Pinterest changes its pages, Scrapier updates the scraper; your field names stay the same.

### Pay per successful call

1 or 2 credits per call, however many pins the page holds. Failed calls are never billed.

Why Scrapier

## Why choose this Pinterest Scraper?

The official Pinterest API is built for apps that act for a Pinterest user: their own pins, boards and ads, after you register an app and the user grants access. Scrapier reads any public board or search result with one API key, at a price you know before the call runs.

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

**0**Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

**$1.20**Per 1,000 calls on Scale

At 2 credits a call. Search calls cost 1 credit, half that.

**0**Apps to register

No developer app, OAuth flow or access review before the first call.

**1 key**For 35 platforms

The same key and JSON envelope cover Instagram, TikTok, Etsy, YouTube and more.

| Feature | Scrapier Pinterest Scraper | Pinterest API | DIY scraper |
| --- | --- | --- | --- |
| Whose data | Any public board or search result | Mainly the accounts that authorize your app | Any public board or search result |
| Setup | One API key | Developer app, OAuth, access review | Proxies, browsers, parsers |
| Maintenance | Handled by Scrapier | Token refresh, API version changes | Breaks on layout changes |
| Cost | From $1.20 per 1,000 calls | No fee, within Pinterest's rate limits | Servers, proxies and engineering time |
| AI agents | MCP server included | None | Build your own |

FAQ

## Frequently asked questions

### What Pinterest data can I scrape?

Pins from public boards (image, title, description, outbound link, repins, board name and pin count), and pin search results by keyword with image size, dominant colour, board, pinner and reaction counts. Video search returns only pins with a playable video link.

### Can I scrape a whole Pinterest board?

Yes. Send the board URL in urls to pinterest-boards. It returns the board's pins a page at a time with next\_cursor; pass it back as cursor until next\_cursor is null. A single pin URL works too.

### How do I search only video pins?

Use pinterest-pins-videos with filter\_type set to Videos, or pinterest-search with content\_filter set to videos. Video results include the link\_to\_video field and the is\_video flag.

### Can I scrape private boards?

No. Scrapier reads public data only. Secret boards and private profiles are not returned.

### How many results can I get?

As many as Pinterest shows publicly. Search endpoints take a page\_size (1-100) and return next\_cursor; pass it back as cursor for the next page. Each page is one call at 1 or 2 credits.

### Is it legal to scrape Pinterest?

It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible data only. Pin images are often copyrighted, and usernames can be personal data under GDPR or CCPA, so collect only what you have a legitimate reason to use.

### Can I connect Pinterest data to other tools?

Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header.

### Can I get Pinterest data through an MCP server?

Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the right Pinterest endpoint with search\_endpoints and calls it with run\_scrape, in Claude Code, Cursor or Windsurf.

### Pinterest Scraper not working?

Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If it's still wrong, report it with the request and the response.

### How much does the Pinterest scraper cost?

pinterest-search and pinterest-pins-videos cost 1 credit per successful call and pinterest-boards costs 2, however many pins the page holds. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.

### What are the Pinterest scraper rate limits?

Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed, and long-running endpoints need a client timeout of 210 seconds or more.

### How do I scrape Pinterest with Python?

Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/pinterest-search/", headers={"X-API-Key": key}, params={"queries": "minimalist tattoo"}, timeout=210). The response is JSON, so read r.json()\["data"\]\["pins"\] directly; there is no HTML to parse.

Other platforms

## You might also like

[### Instagram

20 endpoints](https://scrapier.io/scrapers/instagram/)[### TikTok

29 endpoints](https://scrapier.io/scrapers/tiktok/)[### Etsy

6 endpoints](https://scrapier.io/scrapers/etsy/)[### Facebook

19 endpoints](https://scrapier.io/scrapers/facebook/)[### YouTube

17 endpoints](https://scrapier.io/scrapers/youtube/)[### Threads

6 endpoints](https://scrapier.io/scrapers/threads/)

Get started

## Start pulling Pinterest data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.

[Get your API key →](https://app.scrapier.io/sign-up)[Browse all 11 endpoints](#endpoints)

---
Canonical page: https://scrapier.io/scrapers/pinterest/
Site index for AI agents: https://scrapier.io/llms.txt
