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)

{
  "pin_enabled": true,
  "pin_urls": [
    "https://www.pinterest.com/pin/294774738130378037/",
    "https://www.pinterest.com/pin/627407791878104059/"
  ]
}

Example 2: Download User Pins with Pagination

{
  "user_enabled": true,
  "username": "katea",
  "max_pages": 10
}

Example 3: Combined Download (Pins + User)

{
  "pin_enabled": true,
  "pin_urls": [
    "https://www.pinterest.com/pin/294774738130378037/"
  ],
  "user_enabled": true,
  "username": "viratkohli",
  "max_pages": 5
}

---

Example Outputs 📤

Video Pin Output

{
  "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

{
  "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

{
  "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

{
  "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

---