Pinterest Board Scraper

Pinterest Board Scraper is an Apify Actor that extracts structured data from Pinterest boards.It focuses on reliability and scale by combining network interception, infinite scroll handling, and optional authenticated access via cookies.

It is designed for designers, marketers, and content creators who need to analyze Pinterest boards efficiently.

🚀 Features

✅ Extracts pin data• Pin ID• Pin URL• Image URL (highest available quality)• Description (when available)• Data source indicator (network or DOM)

✅ Board metadata• Board name• Board description• Board URL• Total pin count (when available)

✅ Network interception• Captures Pinterest BoardFeed API responses• More reliable than DOM-only scraping• Faster extraction with fewer scrolls

✅ DOM fallback• Automatically falls back to DOM extraction if network data is limited• Ensures pins are still returned even under restrictions

✅ Infinite scroll handling• Scrolls the board until the requested number of pins is reached• Stops automatically when limits are hit

✅ Access modes• AUTO: uses AUTH if cookies are provided, otherwise PUBLIC• PUBLIC: no cookies, limited by a configurable cap• AUTH: injects Pinterest cookies before navigation for higher limits

✅ Public cap protection• Automatically enforces a max pin limit in PUBLIC mode• Prevents abuse and unexpected failures

✅ Cookie sanitization• Normalizes sameSite values for Playwright compatibility• Filters invalid cookies• Falls back safely to PUBLIC mode if cookies fail

✅ Stealth mode• Firefox + Playwright• User-agent rotation• Viewport randomization• webdriver masking

✅ Proxy support• Fully compatible with Apify Proxy• Residential proxies recommended for stability

✅ Structured output• Each pin stored as an individual Dataset entry• Ready for export (JSON / CSV)

📥 Input Parameters

boardUrlFull Pinterest board URL to scrape

maxPinsMaximum number of pins to extract

headlessRun browser in headless mode

debugScreenshotsSave debug screenshots for troubleshooting

accessModeAUTO, PUBLIC, or AUTHDefault: AUTO

publicMaxPinsCapMaximum number of pins allowed in PUBLIC modeDefault: 50

pinterestCookiesPinterest cookies (JSON string or array)Required for AUTH mode

proxyConfigurationApify proxy configurationResidential proxies recommended

⚠️ ImportantCookies must contain a valid sameSite value (Strict, Lax, or None).Invalid cookies automatically trigger fallback to PUBLIC mode.

🔐 Access Modes

AUTO• Uses AUTH when cookies are provided• Falls back to PUBLIC otherwise

PUBLIC• No cookies required• Enforced pin cap (default 50)• Works on fully public boards

AUTH• Injects Pinterest cookies before navigation• Higher pin limits• More stable BoardFeed access• Better reliability on large boards

📤 Output

Each pin entry contains:

• pinId• pinUrl• imageUrl• description• source (network or dom)• scrapedAt

Each entry also includes boardInfo:

• boardName• boardDescription• boardUrl• totalPins

⚙️ How It Works

1. Validates the Pinterest board URL

2. Detects access mode (AUTO / PUBLIC / AUTH)

3. Launches Firefox with stealth configuration

4. Injects cookies if AUTH mode is active

5. Navigates to the board

6. Intercepts BoardFeed network responses

7. Extracts pins from network data

8. Scrolls until maxPins or limits are reached

9. Falls back to DOM extraction if needed

10. Deduplicates and normalizes pins

11. Stores results in the Apify Dataset

🎯 Use Cases

Designers• Visual inspiration• Moodboard building• Trend analysis

Marketers• Competitor research• Content trend analysis• Creative benchmarking

Dropshippers• Product discovery• Visual trend spotting

Content creators• Content curation• Topic discovery• Inspiration research

⚠️ Important Notes

• Respect Pinterest’s Terms of Service• Use residential proxies for large runs• AUTH mode improves stability, not immunity• Avoid aggressive scraping patterns• Pinterest may change internal APIs at any time

🛠️ Technical Details

Browser: FirefoxFramework: Playwright + CrawleeSDK: ApifyLanguage: JavaScript (ESM)Extraction: Network interception + DOM fallbackAnti-detection: UA rotation, viewport randomization, human delays

⚖️ Legal Disclaimer

This Actor is intended for research and analytical purposes.Users are responsible for complying with Pinterest’s Terms of Service and applicable laws.