Pinterest Downloader - Video & Image Downloader 📌🎥🖼️ Download high-quality Pinterest videos and images effortlessly with this powerful Apify Actor. Extract pins from individual URLs or bulk download from user profiles with automatic pagination. Get direct download links, complete metadata, thumbnails, and more! --- ## Table of Contents 📚 - Features - How It Works - Quick Start - Input Configuration - Example Inputs - Example Outputs - Output Data Structure - Use Cases - Best Practices - FAQ - Troubleshooting - Changelog --- ## Features ✨ | Feature | Description | Benefits | |---------|-------------|----------| | 📌 Individual Pin Download | Download specific Pinterest pins by URL | Get high-quality videos and images with metadata | | 🎥 Video Download | Extract Pinterest videos in 720p quality | Direct MP4 download links with duration info | | 🖼️ Image Download | Download Pinterest images in original quality | Full-resolution images with dimensions | | 👤 User Profile Extraction | Bulk download all pins from any user | Extract hundreds of pins automatically | | 📄 Automatic Pagination | Seamless multi-page fetching | Download complete user collections | | 🔄 Batch Processing | Process multiple pins efficiently | Save time with bulk operations | | 📊 Rich Metadata | Get titles, descriptions, dimensions, thumbnails | Complete pin information for analysis | | ⚡ Fast & Reliable | Built-in retry logic | Consistent performance at scale | | 💾 Structured Output | Clean JSON format in Apify dataset | Easy integration with your workflows | Use Cases: Content archiving, social media management, market research, design inspiration collection, competitor analysis, portfolio building, content curation, backup creation --- ## How It Works 🧠 This Pinterest Downloader uses a reliable API to fetch Pinterest content: 1. API Integration: Connects to Pinterest's data through a robust API endpoint 2. Smart Retry Logic: Automatically retries failed requests. 3. Efficient Batching: Processes pins in batches for optimal performance 4. Pagination Support: Automatically handles pagination for user profiles (20-25 pins per page) 5. Data Extraction: Extracts complete metadata including URLs, dimensions, titles, and more 6. Structured Storage: Saves all data to Apify dataset in clean JSON format --- ## Quick Start ⚡ ### Download Individual Pins 1. Enable "📌 Enable Pin Download" 2. Add Pinterest pin URLs (one per line) 3. Click Start to download ### Download User Pins 1. Enable "👤 Enable User Pins Download" 2. Enter the Pinterest username (without @) 3. Set maximum pages to fetch (5-10 recommended) 4. Click Start to download ### Access Results - View results in the Dataset tab - Export as JSON, CSV, or Excel - Use the Apify API to integrate with your applications --- ## Input Configuration ⚙️ | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | pin_enabled | boolean | No | true | Enable downloading individual pins | | pin_urls | array | Conditional | [] | List of Pinterest pin URLs to download | | user_enabled | boolean | No | false | Enable downloading pins from user profile | | username | string | Conditional | — | Pinterest username (without @ symbol) | | max_pages | integer | No | 5 | Maximum pages to fetch (20-25 pins per page) | * Required if pin_enabled is true ** Required if user_enabled is true --- ## Example Inputs 📥 ### Example 1: Download Individual Pins (Video & Image) json { "pin_enabled": true, "pin_urls": [ "https://www.pinterest.com/pin/294774738130378037/", "https://www.pinterest.com/pin/627407791878104059/" ] } ### Example 2: Download User Pins with Pagination json { "user_enabled": true, "username": "katea", "max_pages": 10 } ### Example 3: Combined Download (Pins + User) json { "pin_enabled": true, "pin_urls": [ "https://www.pinterest.com/pin/294774738130378037/" ], "user_enabled": true, "username": "viratkohli", "max_pages": 5 } --- ## Example Outputs 📤 ### Video Pin Output json { "source": "pin", "input_url": "https://www.pinterest.com/pin/294774738130378037/", "success": true, "type": "video", "pinType": "data", "version": "8.0.0", "cache": false, "pages": null, "width": 720, "height": 1280, "duration": 10433, "url": "https://v1.pinimg.com/videos/mc/720p/37/28/83/37288382999ea6e965e419b535fcfab3.mp4", "thumbnail": "https://i.pinimg.com/originals/8e/19/ae/8e19ae36032fc234e6056492a89b57d0.jpg", "title": "Pinterest Video", "carousel": null } ### Image Pin Output json { "source": "pin", "input_url": "https://www.pinterest.com/pin/627407791878104059/", "success": true, "type": "image", "pinType": "data", "version": "8.0.0", "cache": false, "pages": null, "height": 1913, "width": 1440, "url": "https://i.pinimg.com/originals/3d/1a/b4/3d1ab4ccbd7a5e757b9628a9a79e0b1c.jpg", "thumbnail": "https://i.pinimg.com/originals/3d/1a/b4/3d1ab4ccbd7a5e757b9628a9a79e0b1c.jpg", "title": "Pinterest Image", "carousel": null } ### User Pin Output json { "source": "user", "username": "katea", "page": 1, "id": "46584177392463448", "title": "2 Pink Sofas, 1 Giant Piece of Art", "description": "How a pair of pink velvet sofas transformed our family room.", "type": "image", "url": "https://i.pinimg.com/originals/65/18/f5/6518f5db645c7fdec355da10f5c22fef.jpg", "thumbnail": "https://i.pinimg.com/originals/65/18/f5/6518f5db645c7fdec355da10f5c22fef.jpg", "pinner": { "id": "46584314804043777", "username": "katea", "full_name": "Wit & Delight", "image": "https://i.pinimg.com/30x30_RS/fe/17/a5/fe17a5953e49b5252ec5ba34d6f7c4dd.jpg", "type": "user" }, "board": { "id": "46584246084928155", "name": "Life Hacks", "image": "https://i.pinimg.com/140x140_RS/fe/17/a5/fe17a5953e49b5252ec5ba34d6f7c4dd.jpg" }, "carousel": null } ### Summary Output json { "success": true, "requests_count": 12, "total_items": 287, "fetched_at": "2025-11-07T06:41:38.000Z", "resultsMeta": { "pin_urls": ["https://www.pinterest.com/pin/294774738130378037/"], "user_pins": [{"username": "katea", "max_pages": 10}], "cursor_used": [{"page": 1, "cursor": "P2M0NjU4NDE3NzM5MjQ1OTQzMy4xNzYy..."}] } } --- ## Output Data Structure 📊 ### Common Fields | Field | Type | Description | |-------|------|-------------| | source | string | Source type: "pin" or "user" | | type | string | Media type: "video" or "image" | | url | string | Direct download URL (MP4 for videos, JPG/PNG for images) | | thumbnail | string | Thumbnail image URL | | title | string | Pin title | | description | string | Pin description (user pins only) | ### Video-Specific Fields | Field | Type | Description | |-------|------|-------------| | width | integer | Video width in pixels | | height | integer | Video height in pixels | | duration | integer | Video duration in milliseconds | ### Image-Specific Fields | Field | Type | Description | |-------|------|-------------| | width | integer | Image width in pixels | | height | integer | Image height in pixels | ### User Pin Additional Fields | Field | Type | Description | |-------|------|-------------| | id | string | Unique pin ID | | username | string | Pinterest username | | page | integer | Page number where pin was found | | pinner | object | User information (id, username, full_name, image) | | board | object | Board information (id, name, image) | --- ## Use Cases 💡 ### 1. Content Archiving Archive your favorite Pinterest content for offline access and backup purposes. ### 2. Social Media Management Download Pinterest videos and images for reposting on other social platforms. ### 3. Market Research Analyze trending content, popular pins, and user engagement patterns. ### 4. Design Inspiration Collect design references, mood boards, and creative inspiration systematically. ### 5. Competitor Analysis Monitor competitor Pinterest strategies and content performance. ### 6. Portfolio Building Curate and download content for portfolio presentations and client pitches. ### 7. Content Curation Build content libraries organized by themes, topics, or campaigns. ### 8. Educational Resources Gather educational content, tutorials, and infographics for teaching materials. --- ## Best Practices 🎯 ### ✅ Do's - Start Small: Test with 2-3 pins or 1-2 pages before scaling up - Use Valid URLs: Ensure Pinterest URLs are complete and accessible - Set Reasonable Limits: Use max_pages between 5-10 for optimal performance - Monitor Usage: Check your API key limits and usage regularly - Export Data: Download results as JSON/CSV for backup and analysis - Respect Copyright: Only download content you have rights to use ### ❌ Don'ts - Don't Overload: Avoid setting max_pages too high (>20) in single runs - Don't Use Invalid URLs: Check URLs are properly formatted Pinterest links - Don't Ignore Errors: Review failed requests and adjust inputs accordingly --- ## FAQ ❓ ### Q: Do I need a Pinterest account? A: No, this actor works without requiring a Pinterest account. However, ### Q: What video quality do I get? A: Videos are downloaded in 720p quality (MP4 format) with original audio. ### Q: What image quality do I get? A: Images are downloaded in their original resolution and quality. ### Q: How many pins can I download? A: There's no hard limit. For user profiles, each page contains 20-25 pins. Set max_pages according to your needs. ### Q: Where do the results go? A: All results are saved to the Apify dataset for your actor run. Access them via the Dataset tab or Apify API. ### Q: Can I download private pins? A: No, this actor only works with publicly accessible Pinterest content. ### Q: What if a pin fails to download? A: The actor will log warnings for failed pins and continue processing others. Check the logs for specific error messages. ### Q: Can I download carousel pins? A: Yes, carousel pin data is included in the output. Check the carousel field for multi-image pins. ### Q: How long does it take? A: Individual pins: ~1-2 seconds each. User profiles: ~3-5 seconds per page (20-25 pins). ### Q: Can I schedule automatic downloads? A: Yes! Use Apify's scheduling feature to run the actor automatically at specified intervals. ### Q: Is there a rate limit? A: Rate limits depend on your subscription plan. The actor includes retry logic and key rotation for reliability. --- ## Troubleshooting 🔧 ### Issue: Pin download fails Solution: - Verify the URL is a valid Pinterest pin URL - Check if the pin is publicly accessible - Ensure your API key has remaining quota ### Issue: User profile returns no results Solution: - Verify the username is correct (without @ symbol) - Check if the user profile is public - Try with a different username to test ### Issue: Pagination stops early Solution: - This is normal if the user has fewer pins than expected - Check the Cursor field in results to see if pagination ended naturally --- ## Changelog 🗓️ ### v1.0.0 (2025-11-07) - ✨ Initial release - 📌 Individual pin download support (videos & images) - 👤 User profile pin extraction with pagination - 🔄 Automatic retry logic - 📊 Rich metadata extraction - 💾 Structured JSON output to Apify dataset - ⚡ Batch processing for optimal performance --- ## Support & Contact 💬 Need help? Have questions? - 📖 Check the FAQ section - 🐛 Report issues through Apify platform - 💡 Suggest features for future updates --- Keywords:* Pinterest Downloader, Pinterest Video Downloader, Pinterest Image Downloader, download Pinterest videos, download Pinterest images, Pinterest media downloader, Pinterest bulk downloader, save Pinterest content, Pinterest scraper, Pinterest data extractor, Pinterest API, download pins, Pinterest video download tool, Pinterest image download tool ---