On this page5 sections
If your app works with Pinterest content (a mood-board or inspiration tool, a social scheduler, a content-repurposing or AI shorts product, a brand-monitoring dashboard), you need the video file behind the pin links your users paste. Pinterest makes that harder than it looks:
- The official API doesn't give you the video by default. Pinterest's API v5 is built for creating and managing pins. Its developer FAQ says the
video_urlfield on Get Pin is a restricted feature: your organization needs access to it, your token needspins:read, and your app needs access to that asset. Without all three it comes backnull. - Pin pages are built for the player. A video pin plays in Pinterest's web player, so there's no download link to grab from the page.
- It breaks on the server. Code that works from your laptop can get challenged or blocked once it runs from AWS, GCP, Fly or a serverless function, and Pinterest changes the internals unofficial tools rely on.
The official route
If you're a Pinterest partner with the video_url feature, or the pins belong to accounts that connect to your app and you've been granted access to their assets, use the API. Pinterest's FAQ says to ask your Pinterest representative if you're not sure whether your organization has it.
For a few pins on your own machine, an open-source command-line downloader works and costs nothing. What it costs you is upkeep: updating it when Pinterest changes something, and retries and error handling once it runs on a server.
One call with Importly
Importly takes the pin link your user pasted and returns the video as an MP4.
curl https://api.importly.io/import \
-H "Authorization: Bearer $IMPORTLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.pinterest.com/pin/<pin-id>/",
"videoQuality": "1080p",
"webhookUrl": "https://example.com/webhooks/import"
}'Pin links with a title in the path (pinterest.com/pin/<title>--<pin-id>) work the same way. When the job finishes, the webhook (or GET /import/status?id=<jobId>) gives you a signed link to the file plus the title, duration and thumbnail. The link lasts 7 days; set "store": true to have the file copied into your own S3, R2 or B2 bucket instead.
A few things worth knowing:
- Video pins only. An image pin has no video to download. Paste a pinterest.com link into the link check on the homepage to see what it does before you build around it. Failed imports aren't charged.
- Audio only: set
"includeVideo": falseto get just the audio track, for a voiceover or a transcript. - Transcripts: most video pins have no captions, so add
"includeTranscript": truewith"transcriptProvider": "importly"for AI speech-to-text at $0.01 a minute, or callPOST /transcribeon the link if you only need the text. - Check before you pay:
POST /metadata/basicreturns the title and duration for $0.003.
What it costs
Downloads are $0.002 per MB, with a $0.01 minimum per import. Most video pins are under a minute: a 30-second pin at 720p is roughly 10 MB, about $0.02. Transcribing it with AI adds $0.01. New accounts get $3 of free credit, no card. See pricing for the full list.
Have your AI agent build it in
Connect https://mcp.importly.io/mcp to Claude Code, Cursor or another coding agent and ask it to add Pinterest video imports to your app. It gets working code for your stack, writes the integration and tests real calls with your API key, and your backend uses the same key. The steps are in Have your agent build Importly into your app.
FAQ
Can I download a Pinterest video with the official API?
Only with access Pinterest grants. Get Pin can return a video_url, but Pinterest's developer FAQ calls it a restricted feature that needs organization access, the pins:read scope and access to the asset. Without that, the field is null.
Why does the Pinterest API return a null video URL?
Usually because your organization doesn't have the restricted video_url feature, or your app hasn't been granted access to that pin's video. Pinterest's FAQ says to check the scope with the Token Debugger and then ask your Pinterest representative or Support.
Can I get a transcript of a Pinterest video?
Yes. Call POST /transcribe on the pin link with "provider": "importly" for AI speech-to-text at $0.01 a minute, or add "includeTranscript": true to the import to get the file and the transcript together.
Why does my Pinterest downloader work locally but fail on my server?
Pinterest treats requests from cloud and datacenter IPs differently from a home connection, so a script that works on your laptop can get challenged or blocked on AWS, Vercel or Fly. Importly works from your server without you managing any of that.
Related: Video downloader API, TikTok video download API, Downloads, Supported sites.