Pinterest Scraper & Monitor

Thirdwatch portfolio: 5K users across 88 public Actors, 2M+ records delivered, and >99% run success. Explore all Thirdwatch Actors.

Scrape public Pinterest search results, pins from user feeds, boards, and individual pins. Collect full-resolution images, destination links, creator and board data, product and video metadata, and public engagement counts. Turn on monitoring to emit only new pins or engagement changes on scheduled runs.

The Actor uses Pinterest's public web resources over HTTP. It does not launch a browser, require a Pinterest login, or add a proxy surcharge.

Why use this Pinterest scraper?

• Four sources in one Actor: keywords, usernames, board URLs, and pin URLs.
• Incremental monitoring: schedule a Task and receive only newly discovered pins or changed public engagement metrics.
• Commercial fields: distinguish the canonical pin_url from the pin's outbound_url, and identify product, price, currency, availability, video, and Story Pin metadata when Pinterest exposes it.
• Research context: every row includes its input source, result position, creator, board, image dimensions, and scrape timestamp.
• Low operating cost: pure HTTP at 256 MB, with pay-per-result pricing from $0.002 down to $0.0012.

Quick start

Search for visual trends:

{
  "searchQueries": ["home office ideas", "summer fashion trends"],
  "maxResults": 100,
  "includeDetails": true
}

Monitor a board for new pins:

{
  "boardUrls": ["https://www.pinterest.com/pinterest/official-news/"],
  "maxResults": 100,
  "monitorMode": "new-pins",
  "monitorStoreName": "official-news-watch"
}

Run the same input on a schedule. The first run establishes a baseline and emits the current pins; later runs emit only pins that were not in that monitor's history.

Input

Provide at least one source. Sources may be combined, and maxResults is the total cap across the run.

Field	Type	Description
searchQueries	string[]	Pinterest keyword searches.
usernames	string[]	Public Pinterest usernames, with or without @.
boardUrls	string[]	Full public Pinterest board URLs.
pinUrls	string[]	Full Pinterest pin URLs for direct lookup.
maxResults	integer	Total pins to collect, from 1 to 10,000. Default: 10.
includeDetails	boolean	Adds public engagement, product, video, Story Pin, hashtag, and SEO fields with one extra HTTP request per pin. Detailed runs support up to 500 results.
monitorMode	string	off, new-pins, or engagement-changes.
monitorStoreName	string	Optional stable identity for a scheduled watch. Reuse it on every run.

engagement-changes automatically enables detailed lookups. Monitoring fails without updating its state if Pinterest returns an incomplete response, so a temporary upstream error does not create false alerts.

Output

One dataset row represents one current pin or one monitoring event.

{
  "pin_id": "123456789",
  "title": "Modern home office setup",
  "description": "A compact workspace with natural light",
  "pin_url": "https://www.pinterest.com/pin/123456789/",
  "outbound_url": "https://example.com/workspace-guide",
  "image_url": "https://i.pinimg.com/originals/...jpg",
  "image_width": 1200,
  "image_height": 1800,
  "pinner_username": "designstudio",
  "pinner_followers": 18400,
  "board_name": "Small Office Ideas",
  "board_pin_count": 342,
  "saves_count": 91,
  "reaction_count": 14,
  "repin_count": 37,
  "comment_count": 3,
  "share_count": 5,
  "is_product": false,
  "is_video": false,
  "source_type": "search",
  "source_value": "home office ideas",
  "position": 1,
  "change_type": "engagement-change",
  "changed_fields": ["saves_count", "repin_count"],
  "scraped_at": "2026-07-20T08:00:00+00:00"
}

Important URL semantics:

• pin_url is always the canonical Pinterest pin page.
• outbound_url, url, and link are the external destination attached to the pin. url and link remain compatibility aliases for existing integrations.

Detailed fields can be absent when Pinterest does not publish them for a pin. likes_count remains a backward-compatible numeric alias and defaults to 0; use nullable saves_count when distinguishing unavailable data from an observed zero. Pinterest's public payload describes this metric as saves, not likes.

Monitoring behavior

Mode	First run	Later scheduled runs
off	Current snapshot	Current snapshot
new-pins	Current pins marked new	Only pin IDs first seen by this monitor
engagement-changes	Current pins marked new	New pins plus changed saves, reactions, repins, comments, or shares

Monitoring history is stored in a dedicated Apify key-value store and capped at 20,000 pin IDs per watch. An evicted pin can be classified as new if it later reappears. State is written only after dataset events are published, providing at-least-once delivery if a run is interrupted. Avoid overlapping runs with the same monitor name; schedule the next run after the previous one can finish.

Use cases

• Track competitor boards and content cadence.
• Discover rising visual, fashion, home, food, wedding, and product trends.
• Monitor engagement movement for campaign and creator reporting.
• Build product-research, moodboard, or creative-brief datasets.
• Find destination domains and product pins in a niche.
• Feed Pinterest research into Sheets, webhooks, Make, Zapier, or your data warehouse.

Pricing

You pay only for rows written to the dataset. A monitoring run with no new or changed pins produces no billable result events.

Tier	Price per result	1,000 results
FREE	$0.0020	$2.00
BRONZE	$0.0018	$1.80
SILVER	$0.0015	$1.50
GOLD	$0.0012	$1.20

There is no separate browser, proxy, or start-event charge from this Actor.

Limitations

• Only data visible through Pinterest's public, logged-out web surfaces is returned. Private boards and account-only data are unavailable.
• Pinterest may omit engagement, product, price, video, or Story Pin fields for individual pins.
• User feeds can include pins a user saved; they are not guaranteed to include only original creations.
• Deleted pins and removals are not emitted as events. Monitoring detects additions and available engagement changes.
• Pinterest CDN URLs can change. Download assets you need to retain long term in accordance with applicable rights and terms.

FAQ

Do I need a Pinterest account or API key?

No. The Actor works with public Pinterest pages and resources.

Can I monitor several boards independently?

Yes. Create one saved Task per watch and give each a distinct monitorStoreName. Schedule the Tasks at the cadence you need.

Why is an engagement count null?

Pinterest does not expose every metric on every pin. The Actor returns a value only when the public payload supplies it and does not turn a temporary omission into a false zero.

Does detailed mode use a browser?

No. It performs one additional HTTP detail request per pin, so it is richer but slower than the default snapshot.

Is this an official Pinterest API?

No. This is an independent scraper for publicly accessible web data and is not affiliated with Pinterest.

Last verified: 2026-07-20

Explore more production scrapers at thirdwatch.dev.