Pinterest Scraper

Search public Pinterest pins, inspect pin metadata, list a user's public boards, or return a public board's pins.

Socialv0.2.0~1 credit/runSource on GitHub

Workspace

Configure

Inputs stay here while results become exportable artifacts.

Start from an example

Results

Preview, inspect, copy, or export the complete output.

Your result will become an artifact

Run the tool to inspect structured rows, raw JSON, execution details, and downloadable JSON, CSV, and Markdown files.

modepinscounttitlewidthboardshandleheight

Overview

Pinterest Scraper unifies four public Pinterest retrieval surfaces in one tool. Search mode renders public pin results, pin mode uses Pinterest's official oEmbed endpoint, and user_boards or board mode parse Pinterest's public server-rendered pages.

Last validated: Jul 15, 2026

Input

urlstring (uri)

Public pin, profile, or board URL depending on mode.

mode"pin" | "search" | "user_boards" | "board"

Capability to run. Defaults to pin for backward compatibility.

querystring

Search query for search mode.

handlestring

Pinterest profile handle for user_boards mode.

pin_urlstring (uri)

Public Pinterest pin URL.

max_resultsintegerdefault: 25

Output

modestringrequired

pinsobject[]

countinteger

titlestring

widthinteger

boardsobject[]

handlestring

heightinteger

pin_urlstring

pin_countinteger

author_urlstring

embed_htmlstring

source_urlstringrequired

author_namestring

thumbnail_urlstring

thumbnail_widthinteger

thumbnail_heightinteger

Examples

pinterest-pin

{
  "mode": "pin",
  "pin_url": "https://www.pinterest.com/pin/99360735500167749/"
}

pinterest-search

{
  "mode": "search",
  "query": "Italian Pot Roast",
  "max_results": 10
}

pinterest-user-boards

{
  "mode": "user_boards",
  "handle": "broadstbullycom",
  "max_results": 10
}

pinterest-board

{
  "url": "https://www.pinterest.com/lizmrodgers/moms-night/",
  "mode": "board",
  "max_results": 10
}

Use cases

Visual research

Search public pins or resolve a pin URL into a clean title, image, creator, and canonical URL.

Creator intelligence

List the public boards exposed on a Pinterest creator profile.

Board monitoring

Return normalized public pin cards and visible board metadata from a board URL.

FAQ

Does this require a Pinterest account?

No. All four modes use public Pinterest surfaces.

What does search return?

Search returns the public pin id, title, canonical pin URL, and visible thumbnail for each rendered result.

Can it access private boards?

No. Only boards and pins visible on public Pinterest pages are supported.

Use it anywhere

MCP (Claude, ChatGPT, Codex)

# After connecting https://betterfetch.co/api/mcp, ask your AI to:
1. Call search_tools for "Pinterest Scraper"
2. Call run_tool with:
   name: "pinterest_scraper"
   input: {"mode":"pin","pin_url":"https://www.pinterest.com/pin/99360735500167749/"}

REST

curl -sS -X POST "https://betterfetch.co/api/tools/pinterest_scraper/run" \
  -H "Authorization: Bearer bf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"input": {"mode":"pin","pin_url":"https://www.pinterest.com/pin/99360735500167749/"}}'

Run locally

git clone https://github.com/better-fetch/tools/tree/main/tools/pinterest-scraper && cd pinterest-scraper && npm i
BETTER_FETCH_API_KEY=bf_your_key_here npx bf-tool run --input '{"mode":"pin","pin_url":"https://www.pinterest.com/pin/99360735500167749/"}'