Pinterest Media Downloader: Up to 1,000 Free Results a Month (2026)

Each download record carries 44 fields, including a stable download_url, file size, and the full creator and board metadata Pinterest publishes. This Actor saves public Pinterest images and videos into the run's public key-value store, providing a direct file link alongside engagement stats like saves and reactionCounts. Records include source-backed details such as the file extension and media type, ensuring files are paired with their original context. This is for researchers and designers who need actual media files for local libraries or training sets. It is not for anyone who needs private Pins or restricted content, as the downloader only processes what is publicly accessible.

Try it before you read further. Apify's free plan includes $5.00 of usage every month with no credit card, enough for up to 1,000 results at $0.005 each before platform usage. Open Pinterest Media Downloader on Apify and run the prefilled example.

How reliable is Pinterest Media Downloader in production?

Across the last 30 days of public runs on the Apify platform, Pinterest Media Downloader recorded 258 runs with the following outcomes.

The data shows about 3 in a hundred runs failed or timed out recently.

What does it cost to run Pinterest Media Downloader?

Each result costs $0.005 on Apify's free plan, which is $5.00 per 1,000 results. Starting a run is charged separately at $0.01 per GB of Actor memory. Apify also bills the platform usage each run consumes, at the rates of your Apify plan, on top of these charges.

Worked example: collecting 10,000 results costs $50.00 in result charges before run-start fees and platform usage. With 2.7% of runs failing or timing out in the last 30 days, budget for re-running a portion of those batches rather than assuming every run completes.

The maxItems and searchTerms controls have the largest effect on your bill because they determine the number of results written to the dataset. To find out if this Actor answers your specific question before spending, run a test with one URL and maxItems set to 1.

How do you run Pinterest Media Downloader from the API?

None of its 19 controls is strictly required, so the defaults below produce a valid run on their own. Every value in the payload below comes from the published schema's own prefills, which means you can paste it, swap the token, and get a real result.

Call the synchronous endpoint to start a run and receive dataset items in one request:

curl -X POST "https://api.apify.com/v2/acts/crawlerbros~pinterest-media-downloader/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pinterestUrls":["https://www.pinterest.com/pin/142567144448888376/"],"searchTerms":[]}'

The same run from Python, using the official client:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")

run_input = {
  "pinterestUrls": [
    "https://www.pinterest.com/pin/142567144448888376/"
  ],
  "searchTerms": []
}

run = client.actor("crawlerbros~pinterest-media-downloader").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

And from Node.js:

import { ApifyClient } from 'apify-client'

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' })

const input = {
  "pinterestUrls": [
    "https://www.pinterest.com/pin/142567144448888376/"
  ],
  "searchTerms": []
}

const run = await client.actor('crawlerbros~pinterest-media-downloader').call(input)
const { items } = await client.dataset(run.defaultDatasetId).listItems()
console.log(items)

That endpoint blocks until the run completes. Fine while you are testing a handful of records, risky once a run takes minutes: a dropped connection loses the response even though the run itself finished. Switch to an asynchronous start with polling or a webhook before you schedule anything.

Which Pinterest Media Downloader inputs matter, and which can you skip?

The mode control is the primary setting, allowing you to choose between searching for Pins or fetching details for specific URLs. Most users should start with the auto setting to handle both search terms and direct links.

• pinterestUrls (array): List of Pinterest pin URLs to download media from (e.g. https://www.pinterest.com/pin/123456789/).
• searchTerms (array): List of keywords to search on Pinterest. All media (images and videos) from search results will be downloaded.
• mode (string): Use direct Pin links, search words, or auto-detect both. Default: "auto".
• maxItems (integer): Maximum number of media items to download per search term. Set to 0 for unlimited. Default: 50.
• minSaves (integer): Keep media only when Pinterest supplies at least this many saves.
• minCreatorFollowers (integer): Keep media only when Pinterest supplies this creator follower count.
• verifiedOnly (boolean): Keep only media whose creator is explicitly verified by Pinterest. Default: false.
• requireOutboundLink (boolean): Keep only Pins with a public destination URL. Default: false.
• imageOnly (boolean): Exclude video media. Default: false.
• excludeAds (boolean): Exclude Pins Pinterest marks as promoted. Default: false.
• commerceOnly (boolean): Keep only Pins with source-backed shopping metadata. Default: false.
• includeComments (boolean): When enabled, add real comment/activity rows for every Pin whose media is processed. The public cookieless path is used automatically. Default: false.

The other 7 controls, with their defaults, are listed in the input schema on Pinterest Media Downloader on Apify.

Fixed-choice controls: mode accepts auto (Auto-detect), pinDetail (Direct Pin media), searchPins (Search result media).

What does Pinterest Media Downloader return?

The returned records are ideal for bulk archival because they pair the media file with the creator identity and engagement metrics. They do not contain non-public contact details or data from Pins that do not expose a public, downloadable media URL.

Download record

• record_type
• pin_id
• source_url
• pinterest_url
• media_url
• media_type
• saved_as
• file_extension
• file_size_bytes
• key_value_store_key
• scraped_at
• download_url
• image
• video
• pin
• pinId
• pinUrl
• title
• description
• altText
• createdAt
• domain
• linkUrl
• linkDomain
• imageVariants
• videoVariants
• creator
• board
• saves
• commentCount
• likeCount
• reactionCounts
• isVideo
• isPromoted
• isShoppable
• richMetadata
• id
• username
• fullName
• followerCount
• avatarUrl
• isVerified
• name
• url

Comment/activity records

• includeComments
• comment
• pinActivity
• recordType
• activityType
• pinId
• pinUrl
• commentId
• nodeId
• text
• details
• createdAt
• likeCount
• reactionCounts
• reactionByMe
• helpfulCount
• marked_helpful_by_me
• replyCount
• isEdited
• isHighlightedByPinOwner
• isTranslatable
• tags
• taggedUsers
• media
• author
• sourceUrl
• scrapedAt
• id
• username
• firstName
• fullName
• avatarUrl
• isPrivateProfile
• type
• false

These are the documented fields. Optional ones can be empty on a given record, so measure how often each field your deliverable depends on is populated across a real sample before automating the handoff.

How do you build the workflow end to end?

Open Pinterest Media Downloader and work through these in order. Each step ends with something to check, so a bad configuration surfaces on a small run rather than a scheduled one.

1. Select searchPins or pinDetail within the mode field to define how the scraper identifies assets.
2. Populate the pinterestUrls array with specific Pin identifiers if you have target media already identified.
3. Use the searchTerms control for broader discovery, setting a value for maxItems to control the final result count.
4. Monitor the key_value_store_key and download_url fields in the resulting dataset to verify file storage.
5. Enable includeComments if you need to capture the text and createdAt fields for public Pin activity.
6. Check the media_type value to verify if the saved asset is an image or a video.
7. Apply the minSaves filter to narrow the dataset to Pins with a specific level of public engagement.

How do you apply it? Three worked playbooks

These are Pinterest Media Downloader's own documented use cases, each worked through as an operating pattern rather than a description.

Use case 1: Reference Library Creation

Outcome: Build a local reference library of public Pinterest images and videos.

Configure: Set mode to pinDetail and add several public links to the pinterestUrls array.

Working method: Supply a list of target Pin identifiers and initiate the run to save media to the key-value store. Observe the dataset rows to ensure the saved_as filenames match your expected naming convention. Verify that the file_extension aligns with your local storage requirements.

Deliverable: A collection of media files in the key-value store paired with a dataset containing their original Pinterest metadata.

Stop condition: The dataset contains no records after processing valid public Pin URLs.

Use case 2: Inspiration Archival

Outcome: Download creator or board inspiration at scale.

Configure: Set searchTerms to specific design keywords and toggle verifiedOnly to true.

Working method: Run a search for specific niches and inspect the fullName within the creator object of the first few results. Adjust the maxItems limit to scale the collection once the content quality is confirmed. Use the board name field to categorize the downloaded files.

Deliverable: A dataset of image and video records including full board and creator attribution for every file.

Stop condition: The results return promoted content after the excludeAds flag is enabled.

Use case 3: Research Media Collection

Outcome: Collect media for content, design, recipe, fashion, or product research.

Configure: Set keywords for the research niche and enable commerceOnly to isolate product Pins.

Working method: Execute a keyword-driven search and apply the minSaves filter to identify high-performing content. Analyze the richMetadata and linkUrl fields to connect the media to outbound destination pages. Export the final dataset to map file downloads to their product contexts.

Deliverable: A structured dataset of media files paired with engagement metrics and shopping metadata.

Stop condition: The run times out before reaching the required item count for the research set.

What breaks, and how do you design around it?

• Over the last 30 days, 0.8% of public runs failed and 1.9% timed out. Build retries and alerting around those rates rather than assuming every run completes.

When a Pin is private or deleted, the Actor skips it and does not produce a record. If a Pin exposes only an unsupported stream, the FAQ notes that the Actor does not fabricate a download record.

When should you not use Pinterest Media Downloader?

Do not use this Actor if you only need text metadata without the accompanying media files. For metadata-only tasks, Pinterest Data Extractor or Pinterest Detailed Data Extractor are more appropriate. If your project requires accessing private user boards or managing an account, the official Pinterest API is the correct choice. For high-level regional market analysis without individual downloads, use Pinterest Trends.

What should you check before trusting the output?

• Verify the download_url field is populated; Pins that do not expose a public, downloadable media URL are omitted.
• Check that the file_size_bytes is greater than zero to ensure the media asset was successfully written.
• Confirm the creator object contains a non-null followerCount when the minCreatorFollowers filter is active.
• Inspect the isShoppable boolean to ensure product data is present when commerceOnly is enabled.
• Stop the process if more than three in a hundred runs fail to produce dataset rows for known public URLs.

None of this proves a record is correct. It gives a scheduled Pinterest Media Downloader run defined points where it should stop instead of quietly passing bad data downstream.

Frequently asked questions

What is the cost for 1,000 Pinterest media results?

On Apify's free plan, 1,000 results cost $5.00. This is calculated based on the $0.005 per-result price. Result charges only apply to items written to the dataset, meaning Pins that are skipped because they lack public media do not incur this specific fee. Note that platform usage is billed separately.

Is the success rate sufficient for automated workflows?

The Actor has a 97.3% success rate, with 251 of 258 runs succeeding in the last 30 days. About 3 in a hundred runs failed or timed out. This level of reliability is suitable for automation, though we suggest building alerts to handle the 1.9% timeout rate during high-volume searches.

Where are the downloaded image and video files stored?

Each file is saved in the run's public key-value store. The dataset provides a download_url for each record, which is a stable link to the file on Apify's platform. This link is generally more reliable for long-term use than the original Pinterest source URL, which may expire.

Why were some Pins in my list skipped?

The Actor only generates a record when it can find a public, downloadable media URL. According to the FAQ, if a Pin is private, deleted, or only exposes a media format that cannot be saved as a file, the Actor skips it. This ensures your dataset is not populated with broken or inaccessible links.

Do I need to use login cookies to download Pins?

No, cookies are not required for public Pins. You only need to provide optional cookies if you have a specific, permitted session you need the Actor to use, but the public path is the standard method.

Where to go next

When you are ready to run it, open Pinterest Media Downloader on Apify; the free plan covers up to 1,000 results a month.

Start with the Pinterest Media Downloader Actor page for the current input schema, pricing tier, and run history.

It is part of the Pinterest Scraping Suite, which puts every related Actor on one page with its price and run history.

If you are comparing approaches rather than committing to one Actor, these category pages list every option we publish:

• Video and transcript scrapers covers 48 Actors in this family.

Other Actors we maintain for related data:

• Pinterest Scraper Pro: Scrape Pinterest pins, board pins, user boards, and user profiles.
• Pinterest Data Extractor: Scrape Pinterest pins, profiles, boards, search results, and comments.
• Pinterest Detailed Data Extractor: Scrape Pinterest pins, profiles, boards, search results, and comments.
• Pinterest Comments: Collect public Pinterest comments, Tried It activity, comment authors, and engagement from Pin URLs without requiring login cookies.
• Pinterest Trends: Collect Pinterest public featured trends, editorial trends, shopping categories, and trend time series by region.

Related guides:

• Pinterest Scraper Pro: 3 Practical Use Cases
• Pinterest Data Extractor: Up to 1,000 Free Results a Month (2026)
• Pinterest Detailed Data Extractor: 3 Practical Use Cases
• Social Media Finder: Operating Guide and Cross-Platform Playbooks
• Mixkit Stock Media Scraper: 3 Practical Use Cases and Workflow Guide

Resources

• Actor documentation, input schema, and pricing: verified against the published Actor on 2026-09-25.

• Actor last updated by its maintainers on 2026-09-14.

• Run outcome figures cover the 30 day public window ending 2026-09-25.

• Pinterest Media Downloader on Apify