📌 Pinterest Pins, Videos & Search Scraper Plus

Scrape Pinterest pins, videos, boards, profiles and search results with real URL routing, deterministic paging, and full data extraction. This is an enhanced build of the Pinterest scraper that fixes the original's silent data loss and fake URL routing, and harvests dozens of fields the base actor discarded.

What it scrapes

Give it any mix of:

• Keywords — cat, minimalist kitchen → Pinterest search
• Pin URLs — https://www.pinterest.com/pin/60376016447291956/ → that exact pin
• Board URLs — https://www.pinterest.com/username/board-name/ → that board's pins
• Profile URLs — https://www.pinterest.com/username/ → that profile's pins

URLs are routed to the correct Pinterest endpoint — they are NOT reduced to a keyword search (a common bug in other scrapers). The output mode field tells you how each input was routed.

Key features

• ✅ Real routing: pin / board / profile / search mode detection
• ✅ Deterministic bookmark/cursor paging — reaches maxItems without dropping results
• ✅ Processes all intercepted responses (fixes the base actor's last-10-responses data loss)
• ✅ Canonical pinUrl for every pin
• ✅ Save/repin count + comment count, labeled reactions + total. A pin URL returns counts for free; for keyword/board/profile feeds enable includeCounts to fetch each pin's counts (one extra page load per pin). Counts come from the pin's public closeup page (no login). Save counts are near-100%; comment counts are best-effort (left null if unavailable, never faked).
• ✅ All image sizes (orig, 736x, 564x, 474x, 236x …) with correct width/height, plus a selectable primary imageUrl
• ✅ Video pins: duration, has_audio, all variants (MP4 + HLS), thumbnail/cover, selectable primary videoUrl
• ✅ Board object (name, url, id, privacy, pin/follower counts)
• ✅ Pinner object (id, username, url, verified, follower count)
• ✅ Parsed hashtags and pin tags
• ✅ is_video / is_repin flags, scrapedAt, type / isChild labels
• ✅ Global cross-target de-duplication
• ✅ Automatic proxy fallback (none → datacenter → residential)

Input

{
  "searchTerms": [
    "cat",
    "https://www.pinterest.com/pin/60376016447291956/",
    "https://www.pinterest.com/nasa/"
  ],
  "maxItems": 50,
  "filtre": "All",
  "imageSize": "orig",
  "videoFormat": "auto",
  "proxyConfiguration": { "useApifyProxy": false }
}

Field	Description
searchTerms (required)	Keywords and/or pin/board/profile URLs.
maxItems	Max pins per target (1–1000). A single pin URL returns 1. Default 50.
filtre	All (pins + videos) or Videos (video pins only).
imageSize	Which variant fills the primary imageUrl (orig/736x/564x/474x/236x). All variants are always in images.
videoFormat	Primary videoUrl variant: auto/mp4/hls. All variants are always in videoVariants.
proxyConfiguration	Optional proxy; auto-fallback if blocked.

Output (per pin)

{
  "type": "pin",
  "isChild": false,
  "pinId": "60376016447291956",
  "pinUrl": "https://www.pinterest.com/pin/60376016447291956/",
  "mode": "search",
  "title": "silly kitty",
  "description": "...",
  "imageUrl": "https://i.pinimg.com/originals/....jpg",
  "imageSize": "orig",
  "width": 736, "height": 1104,
  "images": { "236x": {"url": "...", "width": 236, "height": 354}, "orig": {"...": "..."} },
  "saveCount": 120, "commentCount": 3,
  "reactionCounts": {"1": 1877},
  "reactionsLabeled": {"love": 1877},
  "totalReactions": 1877,
  "isVideo": false, "isRepin": false,
  "videoUrl": null, "videoDuration": null, "videoVariants": {},
  "board": {"id": "...", "name": "Cats", "url": "https://www.pinterest.com/user/cats/", "pinCount": 240},
  "pinner": {"id": "...", "username": "user", "url": "https://www.pinterest.com/user/", "verified": false, "follower_count": 4},
  "hashtags": ["cats"],
  "pinTags": [],
  "searchTerm": "cat",
  "sourceUrl": "cat",
  "scrapedAt": "2026-07-02T00:00:00Z"
}

Notes & limitations

• Deep child endpoints are not included in this build: pin comments, related pins, full board/section enumeration, user's board lists, and media download to key-value store. Board and profile URLs return the pins that Pinterest's own feed serves for that container.
• Pinterest may rate-limit (HTTP 429/403). The actor retries via datacenter and residential proxies.

Compliance

• Collects only publicly available data. No private/password-protected content.
• The end user is responsible for legal compliance and for respecting Pinterest's Terms of Service and rate limits.