Pinterest API

Pins, boards
and profiles

Collect public Pinterest pins, videos, boards and profiles from keyword searches or pasted Pinterest URLs.

Keyword searches or pasted URLs
Pin media, creator and board references
Optional per-pin detail and bookmark continuation

View the Actor Try the sample

Historical recordings · 1 recorded item in the saved sample

POST/acts/meka.im~pinterest-scraper/run-sync-get-dataset-items

Pinterest · minimalist kitchen

Pinterest · recorded sample

1 recorded item

Pinterest pin

The Rental Edit

Video

Shop The Rental Edit on Etsy for renter-friendly styling tips, room-by-room ideas, and budget-friendly sources.

The saved row keeps false for isVideo and the source's own identifier and timestamps.

Recorded Sep 24, 2026Historical sample

Overview

What this API returns

Collect public Pinterest pins, videos, boards and profiles from keyword searches or pasted Pinterest URLs.

queries run keyword searches and startUrls route pin, profile, board and search URLs automatically. type selects whether keyword searches return all pins, videos, boards or profiles, while limit caps delivered rows across every target.

includeDetails adds a per-pin lookup for video files, merchant attribution and product metadata. detail_fetched distinguishes a value the source did not provide from one the run did not look up; missing fields are not filled in.

Input

Queries or Pinterest URLs

Output

Pin, board and profile rows

Send queries or URLs

Provide keyword searches, Pinterest URLs, or both, and choose the record type for keywords.

Read public records

The Actor routes each target and reads the public pin, board or profile records it exposes.

Optionally fetch details

With includeDetails enabled, pin rows add public media, merchant and product metadata when available.

Use cases

Where these records fit

The record is designed to sit inside research and review workflows. The examples below are starting points, not packaged scores.

Inspiration research

Collect public pins for a keyword and review titles, creators and board context.

queries
title
creator

Merchant and product review

Inspect public shopping-pin attribution and outbound links when detail lookup is enabled.

merchant_attribution
pin.domain
pin.link

Content trend tracking

Compare saved pin and video records across searches without treating one run as a complete trend index.

type
media
createdAt

Try it

Inspect a recorded pin

Read a saved public pin row, then inspect the original Dataset item as JSON.

Checking live preview

Enter a Pinterest keyword or public pin, board or profile URL.

POSThttps://api.apify.com/v2/acts/meka.im~pinterest-scraper/run-sync-get-dataset-items

Recorded sampleSep 24, 2026

Rendered

Recorded

1 record

Pinterest pin

The Rental Edit

studiobwithabby.etsy.com

Shop The Rental Edit on Etsy for renter-friendly styling tips, room-by-room ideas, and budget-friendly sources.

Open pin Outbound link

Created

Jun 9, 2026, 17:05:43 UTC

Pin and creator

Pin ID: 218987600628163284

Response details (8 fields)

Pin ID: 218987600628163284
Pin URL: https://www.pinterest.com/pin/218987600628163284/
Title: The Rental Edit
Description: Shop The Rental Edit on Etsy for renter-friendly styling tips, room-by-room ideas, and budget-friendly sources.
Created: Jun 9, 2026, 17:05:43 UTC
Outbound link: https://studiobwithabby.etsy.com/listing/4517763392
Domain: studiobwithabby.etsy.com
Video: No

Only returned fields are shown.

All returned fields

id: 218987600628163284
url: https://www.pinterest.com/pin/218987600628163284/
title: The Rental Edit
description: Shop The Rental Edit on Etsy for renter-friendly styling tips, room-by-room ideas, and budget-friendly sources.
createdAt: 2026-06-09T17:05:43.000Z
link: https://studiobwithabby.etsy.com/listing/4517763392
domain: studiobwithabby.etsy.com
isVideo: false

Recorded Sep 24, 2026 · Historical snapshot · Source: Pinterest

JSON

Recordedapplication/json

1[2  {3    "id": "218987600628163284",4    "url": "https://www.pinterest.com/pin/218987600628163284/",5    "title": "The Rental Edit",6    "description": "Shop The Rental Edit on Etsy for renter-friendly styling tips, room-by-room ideas, and budget-friendly sources.",7    "createdAt": "2026-06-09T17:05:43.000Z",8    "link": "https://studiobwithabby.etsy.com/listing/4517763392",9    "domain": "studiobwithabby.etsy.com",10    "isVideo": false11  }12]

Reference

Request and response contract

POST to the Apify Actor endpoint with a bearer token. Request examples use $APIFY_TOKEN and the current product defaults; response examples come from a saved historical record.

Parameters

Request fields accepted by the Actor. Preview input is sent only when you run a live request.

queriesstring[]

Keywords to search Pinterest for. Each keyword is paginated until the run hits Max results.

Example: ["minimalist kitchen","summer outfit ideas"]

startUrlsstring[]

Paste Pinterest URLs: a pin, a profile, a profile's Created or Saved tab, a board, or a search results page. Each is routed automatically.

Example: ["https://www.pinterest.com/nike/","https://www.pinterest.com/nike/nike-running/","https://www.pinterest.com/pin/633600241367267936/"]

typestring

What keyword searches return. Pins and videos come back as pin records; boards and profiles come back as board and profile records. Default: "all-pins". Accepted: "all-pins", "videos", "boards", "profiles".

limitinteger

Hard cap on delivered rows across every keyword and URL. This is what you pay for. Default: 100. Minimum: 1. Maximum: 100000.

includeDetailsboolean

On by default. Adds one lookup per pin for video files, merchant attribution and product metadata. Turn it off for a faster, list-only run. Default: true.

bookmarkstring

Optional. Paste the lastBookmark from a previous run's output to continue paginating the first target where it stopped.

detailConcurrencyinteger

How many detail batches to fetch in parallel. Default: 2. Minimum: 1. Maximum: 8.

Response

Published response fields are listed below. The saved historical fixture is a flattened public record and is shown unchanged.

typestring

"pin", "video", "board" or "profile".

entity_typestring

The record's entity: pin, board or profile. Videos are pins.

schemaobject

Contract version and entity type.

idstring

Pinterest ID of the pin, board or profile.

Example: 218987600628163284

urlstring | null

Canonical Pinterest URL for the record.

Example: https://www.pinterest.com/pin/218987600628163284/

titlestring | null

Pin title, board name or profile display name.

Example: The Rental Edit

source_urlstring | null

The Pinterest page this record came from.

seed_typestring

"query" when the record came from a keyword, "url" when it came from a pasted URL.

seed_valuestring

The keyword or URL that produced this record.

pinobject | null

Pin fields: title, description, alt_text, created_at, link, domain, dominant_color, is_promoted, is_video, reaction_counts, story, product_metadata_type, rich_summary_type. Present on pin records.

creatorobject | null

The pin's creator: id, username, full_name, follower_count, three avatar sizes, profile url, merchant and identity verification flags.

board_refobject | null

The board the pin sits on: id, name, url, pin_count, section_count, collaborator_count, is_collaborative, cover images and the board owner.

mediaobject | null

images (thumb / small / medium / large / original plus the raw images_by_size table) and video (hls_url, mp4_url, duration_ms, width, height, thumbnail, variants). video is null for still pins.

merchant_attributionobject | null

Merchant attribution block, present on shopping pins once details are fetched.

detail_fetchedboolean

Whether this row went through the per-pin detail lookup. Tells apart "the source has no value" from "we did not look".

boardobject | null

Board record fields, including description and follower_count. Present on board records.

profileobject | null

Profile record fields, including about, pin_count, board_count, following_count and website_url. Present on profile records.

curl -X POST 'https://api.apify.com/v2/acts/meka.im~pinterest-scraper/run-sync-get-dataset-items' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "queries": [
    "minimalist kitchen"
  ],
  "type": "all-pins",
  "limit": 100,
  "includeDetails": true
}'

Recorded sample

1 recorded item · historical sample

[
  {
    "id": "218987600628163284",
    "url": "https://www.pinterest.com/pin/218987600628163284/",
    "title": "The Rental Edit",
    "description": "Shop The Rental Edit on Etsy for renter-friendly styling tips, room-by-room ideas, and budget-friendly sources.",
    "createdAt": "2026-06-09T17:05:43.000Z",
    "link": "https://studiobwithabby.etsy.com/listing/4517763392",
    "domain": "studiobwithabby.etsy.com",
    "isVideo": false
  }
]

Recorded Sep 24, 2026 · historical snapshot

Pricing & access

Usage is billed through the Actor

Published FREE-plan event rates from public Apify metadata. Plan-specific rates and usage terms remain on the Actor's pricing page.

Pricing

Pay per delivered event

Apify FREE-plan rate

$1.00per 1,000 results

Per delivered pin, video, board or profile. Duplicates and empty results are free.

Checked 19 Oct 2026Apify pricing

Access

One POST endpoint

Authenticate with an Apify Bearer token.
Send a JSON body to the posted Actor endpoint.
Read the Dataset items array returned by the run.

https://api.apify.com/v2/acts/meka.im~pinterest-scraper/run-sync-get-dataset-items

FAQ

Questions about the contract

Authentication, response shape, recorded data and availability.

Which record types can keyword searches return?

type all-pins returns pin records, videos returns pin records for videos, boards returns board records and profiles returns profile records. Pasted URLs are routed automatically.

How does bookmark continuation work?

bookmark accepts the lastBookmark from a previous run's output and continues paginating the first target where it stopped.

What does detail_fetched tell me?

It shows whether the row went through the per-pin detail lookup. That helps distinguish a source value that is absent from a field the run did not request.

How do I authenticate requests?

Send an Apify token as a Bearer token in the Authorization header, as shown in the request examples.

Are the results on this page live?

Not by default. Saved samples are historical recordings from the source; each keeps the fields and values from that record and does not verify current availability. Live data is requested directly from the published Apify Actor endpoint with your own token.

Where can I find current pricing?

Current pricing and usage terms are published on the Apify Actor page.