Social Media

Pinterest API scraper API

The Pinterest API returns public Pinterest data — pins, boards, profiles and search — as clean JSON.

13 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search_pins endpoint returns pins with id, URL, title, description, image, link, domain, repin count, video flag and pinner, and you can also search videos, users and boards, pull a pin and its comments, related pins, a profile and user boards. It is built for content research, trend analysis and social-marketing tools that need public Pinterest data without a login or a scraper. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search_pins, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/pinterest/v1/search_pins",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "minimalist home office",
    "limit": 10
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "pinterest",
    "endpoint": "search_pins",
    "mode": "live",
    "latency_ms": 3197.4,
    "record_count": 12,
    "bytes": 1077369,
    "cache_hit": false,
    "method": "internal_resource_json"
  },
  "data": {
    "pins": [
      {
        "id": "[redacted-phone]",
        "url": "https://www.pinterest.com/pin/[redacted-phone]/",
        "title": "Explore featured boards",
        "is_video": false
      },
      {
        "id": "[redacted-phone]",
        "url": "https://www.pinterest.com/pin/[redacted-phone]/",
        "is_video": false,
        "pinner": {
          "username": "pinterestman",
          "follower_count": 9095,
          "is_verified_merchant": false,
          "avatar_url": "https://i.pinimg.com/75x75_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg"
        }
      },
      {
        "id": "[redacted-phone]",
        "url": "https://www.pinterest.com/pin/[redacted-phone]/",
        "is_video": false,
        "pinner": {
          "username": "homedecor",
          "follower_count": 26494,
          "is_verified_merchant": false,
          "avatar_url": "https://i.pinimg.com/75x75_RS/20/ee/75/20ee75eb55a815f82f1fa6617233d83d.jpg"
        }
      }
    ],
    "bookmark": "Y2JVSG81V2sxcmNHRlpWM1J5VFVaU2NscEhSbE5XYlhjeVZsZHpNVlV4U25Sa1JGSlhVak5TVkZreWMzZGtNRFZYVm14V1YxSldjRkZXVjNSclZHMVJlRlZzV2xaaVJYQnhWbTEwYzA1R1ZuUmpNMmhWVWpCd01WZFVUbTlXVlRGWVZXdGtZVlpXVlRGV2JGcEhWbFpTZEZKdGJGZGhNVlkwVm10YWIyUXhiRmhTYmtwUFYwWktXVlpyVm5kVU1WcHhVVzFHYWxKc1JqUldWM1IzVkRGS2RHVklhRmROYWtaNlYxWmFZVkpzV25GVWJGWnBVakZLU0ZaR1dsWk5WbHBYVTJ4c2FsSXdXbGhVVm1RelRWWlplRmRzVG1oTmEzQlhWREZhVjFZeVNsaGxSVGxoVmpOU00xbHFSbE5XYkZaelUyczFVMVpGV2pSV2FrWnZZVEZTZEZOc1drOVdlbXhXVkZWYVMyVnNiSE5YYmtwc1ZteGFXbGt3VlRWVWJVcEdWMVJHV0dKWVVsZFVWbHBMWXpGa1dXTkhkR3hoYTBVMVdtdGFWMU5YU2paVmJYaFRWMGRvUmxkc1ZsZGhNV1J6"
  }
}

Actions

What the Pinterest API scraper API does

Action	Description	Concrete use case	Key params
search_pins	Search Pinterest pins by keyword. Returns pin id/title/description/image/link/save-count with the pinner. Paginate with meta.bookmark.	Ops teams call search_pins to search Pinterest pins by keyword.	query, limit, bookmark
search_videos	Search Pinterest video pins (Idea Pins / video) by keyword. Same shape as search_pins but scoped to video content (image_url + video_url). Paginate with meta.bookmark.	Developer tools call search_videos to search Pinterest video pins (Idea Pins / video) by keyword.	query, limit, bookmark
search_users	Search Pinterest users/creators by keyword. Returns username/profile stats/avatar.	Validation workflows call search_users to search Pinterest users/creators by keyword.	query, limit, bookmark
search_boards	Search Pinterest boards by keyword. Returns board name/url/description/pin-count/owner.	Data-quality teams call search_boards to search Pinterest boards by keyword.	query, limit, bookmark
suggestions	Autocomplete / typeahead search suggestions for a partial query — the dropdown Pinterest shows as you type. Great for keyword research.	Ops teams call suggestions to get autocomplete / typeahead search suggestions for a partial query.	query
pin	Full detail for one pin: title, description, image, video, outbound link/domain, save & comment & share counts, reactions, hashtags, board, dominant color, product/price (when a shopping pin) and the pinner. Provide pin_id or pin_url.	Developer tools call pin to get full detail for one pin.	pin_id, pin_url, id
pin_comments	Public comments & 'Tried it' notes on a pin: text, like/helpful counts, commenter and whether the pin owner highlighted it. Provide pin_id or pin_url. Paginate with meta.bookmark.	Validation workflows call pin_comments to get public comments & 'Tried it' notes on a pin.	pin_id, pin_url, id, limit, bookmark
related_pins	'More like this' pins related to a source pin. Provide pin_id or pin_url.	Data-quality teams call related_pins to get 'More like this' pins related to a source pin.	pin_id, pin_url, id, limit, bookmark
profile	Public profile for a username: name, bio, follower/following/board/pin counts, avatar, website.	Ops teams call profile to get public profile for a username.	username
user_boards	Public boards owned by a username: name, url, description, pin-count, cover image.	Developer tools call user_boards to get public boards owned by a username.	username
user_pins	Pins created by a username (their feed). Paginate with meta.bookmark.	Validation workflows call user_pins to get pins created by a username (their feed).	username, limit, bookmark
board	Board metadata: name, description, pin & follower & section counts, cover image, owner. Provide board_url or username + board.	Data-quality teams call board to get board metadata.	board_url, username, board, board_slug
board_pins	Pins inside a board. Provide board_url or username + board. Paginate with meta.bookmark.	Ops teams call board_pins to get pins inside a board.	board_url, username, board, board_slug, limit, ...

Code samples

Call search_pins from your stack

curl -X POST https://api.reefapi.com/pinterest/v1/search_pins \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"minimalist home office","limit":10}'

import requests

r = requests.post(
    "https://api.reefapi.com/pinterest/v1/search_pins",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "minimalist home office",
  "limit": 10
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/pinterest/v1/search_pins", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "minimalist home office",
  "limit": 10
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.pinterest.search_pins with {"query":"minimalist home office","limit":10}.

Use cases

Who uses this API and why

Content and trend teams call search_pins to find top-performing pins and rising visual themes.
Brand-monitoring tools use search_pins by domain to see which of a site's pages get repinned.
Social-marketing tools use profile and user_boards to study a competitor's Pinterest strategy.

FAQ

Questions developers ask before integrating

What is the Pinterest API scraper API?

Pinterest API scraper API is a ReefAPI endpoint group for pinterest api scraper It returns live JSON through POST requests under /pinterest/v1.

Is the Pinterest API scraper API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Pinterest API scraper calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Pinterest API scraper login or account?

No login to Pinterest API scraper is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Pinterest API scraper data?

The page example is captured from a live search_pins call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Pinterest API scraper API use?

Pinterest API scraper actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Pinterest API scraper from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call pinterest actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Pinterest API scraper API a Pinterest API scraper scraper?

It is the managed alternative to a DIY Pinterest API scraper scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same pinterest api scraper back as clean JSON.

Why does my Pinterest API scraper scraper keep getting blocked?

Most Pinterest API scraper scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / pinterest

Pinterest API scraper

base /pinterest/v113 endpoints

post/pinterest/v1/search_pins1 credit

Search Pinterest pins by keyword. Returns pin id/title/description/image/link/save-count with the pinner. Paginate with meta.bookmark.

Parameter		Allowed / range	Description
query	required	—	Free-text search query (a topic, brand, product or idea).
limit = 25	optional	1–100	How many items to return per page (1–100, default 25). Use the returned meta.bookmark to fetch the next page.
bookmark	optional	—	Pagination cursor — pass the previous response's meta.bookmark to get the next page. Omit for page one.

Try in playground →

post/pinterest/v1/search_videos1 credit

Search Pinterest video pins (Idea Pins / video) by keyword. Same shape as search_pins but scoped to video content (image_url + video_url). Paginate with meta.bookmark.

Parameter		Allowed / range	Description
query	required	—	Free-text search query (a topic, brand, product or idea).
limit = 25	optional	1–100	How many items to return per page (1–100, default 25). Use the returned meta.bookmark to fetch the next page.
bookmark	optional	—	Pagination cursor — pass the previous response's meta.bookmark to get the next page. Omit for page one.

Try in playground →

post/pinterest/v1/search_users1 credit

Search Pinterest users/creators by keyword. Returns username/profile stats/avatar.

Parameter		Allowed / range	Description
query	required	—	Free-text search query (a topic, brand, product or idea).
limit = 25	optional	1–100	How many items to return per page (1–100, default 25). Use the returned meta.bookmark to fetch the next page.
bookmark	optional	—	Pagination cursor — pass the previous response's meta.bookmark to get the next page. Omit for page one.

Try in playground →

post/pinterest/v1/search_boards1 credit

Search Pinterest boards by keyword. Returns board name/url/description/pin-count/owner.

Parameter		Allowed / range	Description
query	required	—	Free-text search query (a topic, brand, product or idea).
limit = 25	optional	1–100	How many items to return per page (1–100, default 25). Use the returned meta.bookmark to fetch the next page.
bookmark	optional	—	Pagination cursor — pass the previous response's meta.bookmark to get the next page. Omit for page one.

Try in playground →

post/pinterest/v1/suggestions1 credit

Autocomplete / typeahead search suggestions for a partial query — the dropdown Pinterest shows as you type. Great for keyword research.

Parameter		Allowed / range	Description
query	required	—	Free-text search query (a topic, brand, product or idea).

Try in playground →

post/pinterest/v1/pin1 credit

Full detail for one pin: title, description, image, video, outbound link/domain, save & comment & share counts, reactions, hashtags, board, dominant color, product/price (when a shopping pin) and the pinner. Provide pin_id or pin_url.

Parameter		Allowed / range	Description
pin_id	optional	—	Numeric pin id (the digits in pinterest.com/pin/<pin_id>/). Provide pin_id OR pin_url.
pin_url	optional	—	Full pin URL (alternative to pin_id).

Try in playground →

post/pinterest/v1/pin_comments1 credit

Public comments & 'Tried it' notes on a pin: text, like/helpful counts, commenter and whether the pin owner highlighted it. Provide pin_id or pin_url. Paginate with meta.bookmark.

Parameter		Allowed / range	Description
pin_id	optional	—	Numeric pin id (the digits in pinterest.com/pin/<pin_id>/). Provide pin_id OR pin_url.
pin_url	optional	—	Full pin URL (alternative to pin_id).
limit = 25	optional	1–100	How many items to return per page (1–100, default 25). Use the returned meta.bookmark to fetch the next page.
bookmark	optional	—	Pagination cursor — pass the previous response's meta.bookmark to get the next page. Omit for page one.

Try in playground →

post/pinterest/v1/related_pins1 credit

'More like this' pins related to a source pin. Provide pin_id or pin_url.

Parameter		Allowed / range	Description
pin_id	optional	—	Numeric pin id (the digits in pinterest.com/pin/<pin_id>/). Provide pin_id OR pin_url.
pin_url	optional	—	Full pin URL (alternative to pin_id).
limit = 25	optional	1–100	How many items to return per page (1–100, default 25). Use the returned meta.bookmark to fetch the next page.
bookmark	optional	—	Pagination cursor — pass the previous response's meta.bookmark to get the next page. Omit for page one.

Try in playground →

post/pinterest/v1/profile1 credit

Public profile for a username: name, bio, follower/following/board/pin counts, avatar, website.

Parameter		Allowed / range	Description
username	required	—	Pinterest username (the handle in pinterest.com/<username>/).

Try in playground →

post/pinterest/v1/user_boards1 credit

Public boards owned by a username: name, url, description, pin-count, cover image.

Parameter		Allowed / range	Description
username	required	—	Pinterest username (the handle in pinterest.com/<username>/).

Try in playground →

post/pinterest/v1/user_pins1 credit

Pins created by a username (their feed). Paginate with meta.bookmark.

Parameter		Allowed / range	Description
username	required	—	Pinterest username (the handle in pinterest.com/<username>/).
limit = 25	optional	1–100	How many items to return per page (1–100, default 25). Use the returned meta.bookmark to fetch the next page.
bookmark	optional	—	Pagination cursor — pass the previous response's meta.bookmark to get the next page. Omit for page one.

Try in playground →

post/pinterest/v1/board1 credit

Board metadata: name, description, pin & follower & section counts, cover image, owner. Provide board_url or username + board.

Parameter		Allowed / range	Description
board_url	optional	—	Full board URL (alternative to username + board).
username	optional	—	Pinterest username (the handle in pinterest.com/<username>/).
board	optional	—	Board slug — the segment after the username in a board URL (also accepted as 'board_slug'). Combine with username, or pass board_url.

Try in playground →

post/pinterest/v1/board_pins1 credit

Pins inside a board. Provide board_url or username + board. Paginate with meta.bookmark.

Parameter		Allowed / range	Description
board_url	optional	—	Full board URL (alternative to username + board).
username	optional	—	Pinterest username (the handle in pinterest.com/<username>/).
board	optional	—	Board slug — the segment after the username in a board URL (also accepted as 'board_slug'). Combine with username, or pass board_url.
limit = 25	optional	1–100	How many items to return per page (1–100, default 25). Use the returned meta.bookmark to fetch the next page.
bookmark	optional	—	Pagination cursor — pass the previous response's meta.bookmark to get the next page. Omit for page one.

Try in playground →

Example request · search_pins

curl -X POST https://api.reefapi.com/pinterest/v1/search_pins \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"minimalist home office","limit":10}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}