BlogCore API

Pinterest Video Download API: Get the File From a Pin Link

Pinterest's API only returns video_url with restricted access. What the official route needs, and one Importly call that turns a video pin link into an MP4 and a transcript.

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_url field on Get Pin is a restricted feature: your organization needs access to it, your token needs pins:read, and your app needs access to that asset. Without all three it comes back null.
  • 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.

bash
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": false to get just the audio track, for a voiceover or a transcript.
  • Transcripts: most video pins have no captions, so add "includeTranscript": true with "transcriptProvider": "importly" for AI speech-to-text at $0.01 a minute, or call POST /transcribe on the link if you only need the text.
  • Check before you pay: POST /metadata/basic returns 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.

Keep reading

Put video and audio links to work in your app

One API for files, transcripts and metadata. Free to try, no card required.

Try free →