Pinterest Video Downloader — MP4 + HLS Links

What is Pinterest Video Downloader — MP4 + HLS Links?

Pinterest Video Downloader turns Pinterest pin URLs, pin.it short links, pin IDs, whole boards, profiles or a search keyword into a dataset of video pins, one row per video. Each row has a direct MP4 link, the HLS stream URL, available MP4 resolutions, width, height, duration, thumbnail, title, description, destination link, board, creator and engagement counts. An optional switch saves the MP4 file into Apify storage with a permanent link. Social media managers, content curators, researchers and AI agents use it to collect Pinterest videos without a login.

Why creators and curators use this Pinterest video downloader

• A direct MP4, ready to save. videoUrl points to the progressive MP4, with every resolution listed in mp4Formats.
• HLS for pipelines. hlsUrl gives the adaptive stream for media tools when you turn on includeHls (on by default).
• Whole boards and profiles at once. Paste a board or profile URL in boardOrProfileUrls to collect every video pin on it.
• Keyword discovery. searchQuery gathers video pins on a topic such as cooking recipe.
• Permanent copies on request. saveVideo stores the MP4 in the run's key-value store and adds storedVideoUrl.

Best fit for this Actor

• Designed for public Pinterest video pins: recipes, tutorials, product demos, workouts and inspiration clips.
• Use pinUrls for specific videos, boardOrProfileUrls for collections, and searchQuery for topic discovery.
• When you need image pins, board stats or profile data alongside videos, continue with Pinterest Data Extractor — Pins, Boards, Profiles, Keywords.
• When your list mixes Pinterest with YouTube, TikTok or other video links, pass the other links to Media Downloader - All-in-One Video, Audio and Metadata.

What people and AI agents ask this Actor to do

Download this Pinterest video as an MP4. Get every video from this Pinterest board. Find twenty Pinterest videos about home workouts with their creators. Save these pin videos permanently so the links stay live.

Request	Input to send
One video	{"pinUrls": ["https://www.pinterest.com/pin/351912467391055/"]}
A pin.it short link	{"pinUrls": ["https://pin.it/..."]}
Every video on a board	{"boardOrProfileUrls": ["https://www.pinterest.com/pinterest/home-decor/"], "maxResults": 100}
Videos on a topic	{"searchQuery": "home workout", "maxResults": 20}
Permanent MP4 copies	{"pinUrls": ["..."], "saveVideo": true}

Example workflow: from a topic to a reference library

A recipe brand's social team starts with searchQuery set to holiday drinks and maxResults at 30. The dataset returns each video's videoUrl, durationSeconds, thumbnailUrl, creatorFullName, reactionCount and destinationUrl. The team sorts by reactions, compares the top clips' lengths and hooks against their own content, and exports the shortlist. For the clips they want to study frame by frame, they rerun those pin URLs with saveVideo on so the MP4 files stay in storage, then schedule the search monthly to watch new formats appear.

Input

{
  "pinUrls": ["https://www.pinterest.com/pin/351912467391055/"],
  "maxResults": 50,
  "saveVideo": false,
  "includeHls": true,
  "videoQuality": "best"
}

Field	Type	What it controls
pinUrls	array	Pin URLs, pin.it short links or numeric pin IDs
boardOrProfileUrls	array	Board or profile URLs; collects their video pins
searchQuery	string	Free-text Pinterest search for video pins
maxResults	integer	Cap on videos across all inputs. Default 50
saveVideo	boolean	Save the MP4 into the run's key-value store and add storedVideoUrl. Default false
includeHls	boolean	Include hlsUrl. Default true
videoQuality	string	best, 720p, 480p or 360p for the primary videoUrl. Default best
proxyConfiguration	object	Apify Proxy settings

Output

Field	What it contains
pinId, pinUrl, title, description, destinationUrl, createdAt	Pin identity and content
videoUrl, mp4Formats, hlsUrl	MP4 link, all MP4 resolutions and HLS stream
width, height, durationMs, durationSeconds, thumbnailUrl, dominantColor	Media details
boardName, boardUrl	Board the pin sits on
creatorUsername, creatorFullName, creatorProfileUrl	Pin creator
repinCount, commentCount, reactionCount	Engagement counts
storedVideoUrl	Permanent Apify link to the saved MP4 (with saveVideo)
isVideo, source, scrapedAt	Type flag, input route and collection time

{
  "pinId": "424605071146008238",
  "pinUrl": "https://www.pinterest.com/pin/424605071146008238/",
  "title": "Grapefruit Tea",
  "description": "Holidays in a teapot. Our Grapefruit Tea recipe is easy, nutritious and a burst of juicy flavor.",
  "destinationUrl": "https://nutritiouslife.com/recipes/grapefruit-tea/",
  "createdAt": "2026-09-29T02:06:56.000Z",
  "boardName": "Gifts for the coffee and tea obsessed",
  "boardUrl": "https://www.pinterest.com/pinterest/gifts-for-the-coffee-and-tea-obsessed/",
  "isVideo": true,
  "videoUrl": "https://v1.pinimg.com/videos/mc/720p/be/51/4d/be514d1bcf7cddf77a926f0af559d689.mp4",
  "mp4Formats": [
    {
      "quality": "720P",
      "url": "https://v1.pinimg.com/videos/mc/720p/be/51/4d/be514d1bcf7cddf77a926f0af559d689.mp4",
      "width": 720,
      "height": 1280
    }
  ],
  "hlsUrl": "https://v1.pinimg.com/videos/mc/hls/be/51/4d/be514d1bcf7cddf77a926f0af559d689.m3u8",
  "width": 720,
  "height": 1280,
  "durationMs": 6566,
  "durationSeconds": 6.6,
  "thumbnailUrl": "https://i.pinimg.com/originals/cd/88/8b/cd888b651c7d0ed6b99b5097ef7f8de1.jpg",
  "creatorUsername": "nutritious_life",
  "creatorFullName": "Nutritious Life",
  "creatorProfileUrl": "https://www.pinterest.com/nutritious_life/",
  "repinCount": 0,
  "commentCount": 0,
  "reactionCount": 4,
  "dominantColor": "#874a23",
  "source": "profile",
  "scrapedAt": "2026-10-02T16:55:12.404Z"
}

Pricing

This Actor uses Pay per event with Apify platform usage included in the event price. You pay one Actor Start event per run and one Video downloaded event per video row with a download link. The live Pricing tab on this page shows the current event prices.

Worked example: a board with maxResults at 30 that yields 30 video pins costs 30 Video downloaded events plus one Actor Start event. maxResults caps the total across all inputs, so it is the simplest way to bound the cost of a run.

API example

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~pinterest-video-downloader/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pinUrls": ["https://www.pinterest.com/pin/351912467391055/"]}'

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("khadinakbar/pinterest-video-downloader").call(run_input={
    "searchQuery": "home workout",
    "maxResults": 20,
})
for video in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(video["title"], video["durationSeconds"], video["videoUrl"])

Use with AI agents (MCP)

Connect the Actor through Apify MCP in Claude, ChatGPT or Cursor and ask:

Get the MP4 download link, length and creator for this Pinterest video, and tell me where the pin links to.

The agent passes the link in pinUrls, reads the row with get-dataset-items, and answers from videoUrl, durationSeconds, creatorFullName and destinationUrl. It should cite pinUrl and scrapedAt. Each video row is one event, so agents should keep maxResults small for board, profile and search inputs unless the user asks for a full collection.

Best results

Starting situation	Helpful action	Expected outcome
A video seen in the Pinterest app	Share it, copy the pin.it link, paste it in pinUrls	One video row
A board full of clips	Paste the board URL in boardOrProfileUrls	Every video pin on that board
You need files that stay live	Turn on saveVideo	A permanent storedVideoUrl per video
A media pipeline	Keep includeHls on and use hlsUrl	An adaptive stream for your tools
Smaller files	Set videoQuality to 480p or 360p	A lighter primary MP4 when Pinterest offers it

Builder's note

I built this to return Pinterest's own progressive MP4 link first, because most people want a file that plays anywhere, and to keep the HLS stream beside it for teams with media pipelines. I designed saveVideo as an opt-in so quick lookups stay light, while archives can keep permanent copies in Apify storage.

FAQ

Do I need a Pinterest account?

No. The Actor reads public pins without a login.

Do the MP4 links stay live?

Pinterest's video links are long-lived. For a copy you control, turn on saveVideo.

Does it return image pins?

It focuses on video pins. For image pins and boards, use the Pinterest Data Extractor linked above.

Responsible use

Pinterest videos belong to their creators. Download them for reference, research or content you own or have permission to reuse, credit creators, and respect Pinterest's terms of service and copyright law. Creator names and handles can be personal data under laws such as the GDPR and CCPA. Pinterest is a trademark of its owner, and this independent Actor is not affiliated with it. For questions, open a ticket in the Issues tab.