Pinterest Downloader

File links for Pinterest pins.

Pick an action and fill in its fields — the Actor stores the answer in the dataset. Without action it runs getLinks: pass a link and get file links.

Input

action defaults to getLinks (also when it is empty) and selects what to fetch.

Each action uses only its own fields: fields of other actions are ignored and not sent. A key that is not a field of this Actor (e.g. a typo) fails the run. Required fields are checked before any request; an empty or whitespace-only string counts as a missing value.

Action	What it returns	Required	Optional
getLinks	Get file URLs	url	—

Field	Type	Description
url	string	A Pinterest pin link.

Example:

{"action":"getLinks","url":"https://www.pinterest.com/pin/99360735500167749/"}

Output

getLinks

One dataset item per resource found at the link (usually one; a post with several media can give several):

{
  "urls": [
    { "url": "https://...", "name": "MP4", "subName": "720", "type": "mp4", "extension": "mp4", "quality": "720p" }
  ],
  "meta": { "title": "...", "sourceUrl": "https://...", "duration": "1:02" },
  "pictureUrl": "https://...",
  "service": "..."
}

• urls — available files; fields such as filesize, audio, quality are present when the service provides them.
• A business error (no downloadable files, private or missing page) is stored as one dataset item as-is and the run still succeeds. It has one of two forms: { "response": 4, "response_type": "link not found", "success": false, "message": "..." } or { "info": "...", "code": ... }.
• A link that is not a Pinterest link fails the run before any request is made.
• Direct CDN links can be bound to the IP address of the Actor run and may return 403 when opened from another machine: the Actor does not pass your IP address to the service. Download such links soon after the run, from the same environment if possible.

Errors

• The run fails without storing data when the input is invalid (checked before any request), the request is rejected or gets an unexpected answer, or the service is still unavailable (an error or no answer within 30 seconds) after retries — about 90 seconds in the worst case.

Pricing

This Actor uses pay-per-event pricing: you pay for the Actor start and for each result, platform usage (compute) is included. The prices are on the Actor's page in Apify Store.

A result is one dataset item with data:

• getLinks: each resource found at the link (a post with several media gives several).

Only the Actor start is charged for:

• a business error item;
• an answer with no items;
• a run that fails.

With a maximum cost per run set, the Actor stores only as many items as the limit covers: the rest of the answer is not stored.

Run via API

curl -X POST \
  "https://api.apify.com/v2/acts/logical_variety~pinterest/run-sync-get-dataset-items?token=<APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"action":"getLinks","url":"https://www.pinterest.com/pin/99360735500167749/"}'