Pinterest Board Scraper Pinterest Board Scraper is an Apify Actor that extracts comprehensive data from Pinterest boards. It scrapes pin information including images, descriptions, repins, dates, and external links. Perfect for designers, marketers, and content creators who need to analyze Pinterest content. ## 🚀 Features - ✅ Extracts pin data: Image URLs, descriptions, titles, repins, dates, and external links - ✅ Board metadata: Complete board information including name, description, and total pins - ✅ Infinite scroll handling: Automatically loads more pins by scrolling through the board - ✅ Stealth mode: Uses advanced anti-detection techniques with Playwright - ✅ Proxy support: Configurable proxy settings for reliable scraping - ✅ Batch processing: Efficient data handling with configurable batch sizes - ✅ Structured output: Each pin stored as individual entry in Apify Dataset ## 📥 Input Parameters The Actor accepts the following input parameters: | Parameter | Type | Description | Default Value | |-----------------------|-----------|------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------| | boardUrl | string | Full Pinterest board URL to scrape | "https://www.pinterest.com/username/boardname/" | | maxPins | integer | Maximum number of pins to scrape from the board | 100 | | headless | boolean | Whether to run browser in headless mode | true | | proxyConfiguration | object | Proxy configuration object (recommended: RESIDENTIAL proxies) | { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } | ### Example Input json { "boardUrl": "https://www.pinterest.com/designer/outfit-inspiration/", "maxPins": 200, "headless": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ## 📤 Output The Actor outputs a structured JSON dataset with each pin containing the following fields: ### Pin Data Fields - imageUrl (string): Direct link to the pin image - description (string): Text description of the pin - title (string): Pin title (if available) - pinUrl (string): Direct link to the Pinterest pin - externalLink (string): Any external website link associated with the pin - repins (integer): Number of times the pin has been repinned - date (string): Pin creation date (if available) - boardName (string): Name of the board containing the pin - user (string): Username of the pin creator - index (integer): Position of the pin in the board - scrapedAt (string): Timestamp when the pin was scraped ### Board Information - boardInfo (object): Complete board metadata including: - boardName (string): Name of the board - boardDescription (string): Description of the board - boardUrl (string): URL of the board - totalPins (integer): Total number of pins in the board ### Example Output json [ { "imageUrl": "https://i.pinimg.com/originals/abc123.jpg", "description": "Beautiful summer dress inspiration for 2024", "title": "Summer Style", "pinUrl": "https://www.pinterest.com/pin/123456789/", "externalLink": "https://example.com/product/dress", "repins": 45, "date": "2024-01-15", "boardName": "Fashion Inspiration", "user": "designer", "index": 1, "boardInfo": { "boardName": "Outfit Inspiration", "boardDescription": "Beautiful fashion inspiration for all seasons", "boardUrl": "https://www.pinterest.com/designer/outfit-inspiration/", "totalPins": 1500 }, "scrapedAt": "2024-01-20T10:30:00.000Z" } ] ## ⚙️ How It Works ### Board Processing URL Validation: The Actor validates the provided Pinterest board URL format and ensures it's accessible. Infinite Scroll: Pinterest uses infinite scroll to load content. The Actor automatically scrolls through the board to load the requested number of pins. ### Data Extraction Pin Details: Each pin is extracted from Pinterest's DOM structure. The Actor scrapes: - Image URL: Direct link to the pin image - Description: Text description from pin metadata - Title: Pin title when available - Pin URL: Direct link to the Pinterest pin page - External Link: Any associated external website links - Repins: Number of repins (engagement metric) - Date: Creation date when available - User: Creator username - Board Info: Complete board metadata Output Format: Each pin is stored as an individual object in the Apify Dataset with comprehensive metadata. ## 🎯 Use Cases ### For Designers - Extract design inspiration from curated boards - Analyze trending visual styles and color palettes - Collect reference images for projects ### For Marketers - Research competitor content strategies - Analyze popular pin formats and descriptions - Track trending topics in your niche ### For Dropshippers - Find trending products and styles - Extract product images and descriptions - Research popular product categories ### For Content Creators - Curate content for social media - Find trending topics and hashtags - Analyze successful pin formats ## ⚠️ Important Notes 1. Respect Pinterest's Terms of Service - Use this Actor responsibly and in accordance with Pinterest's policies 2. Rate Limiting - The Actor includes built-in delays to avoid overwhelming Pinterest's servers 3. Proxy Usage - For large-scale scraping, always use residential proxies 4. Data Usage - Ensure you have permission to use scraped data for your intended purpose 5. Public Boards Only - The Actor can only scrape publicly accessible Pinterest boards ## 🛠️ Technical Details - Browser: Firefox with stealth mode enabled - Framework: Playwright with Apify SDK - Language: JavaScript (ES6+) - Architecture: Single-page scraping with infinite scroll handling - Anti-Detection: Advanced stealth techniques including user agent rotation, viewport randomization, and human-like delays ## 📞 Support For issues or questions: 1. Check the Apify console logs for detailed error messages 2. Ensure your Pinterest board URL is publicly accessible 3. Verify your proxy configuration if using proxies 4. Check that the board URL format is correct: https://www.pinterest.com/username/boardname/ ## ⚖️ Legal Disclaimer This project is intended for educational and research purposes only. When using this Actor, please comply with Pinterest's Terms of Service and relevant robots.txt policies. Use this tool responsibly and avoid aggressive scraping that could negatively impact Pinterest's website infrastructure.