Use Pinterest Pins, Profiles, Boards & Idea Topics Scraper with Python

Collect Pinterest Pins, creator profiles, boards, idea topics, and search results in one actor, with built-in filters for minimum saves, creator followers, verified accounts, shoppable pins, and image-only results.

1. Choose the data you need

Review the published README for supported collection modes, examples, and limits. The recipe below uses the current published input definition.

2. Prepare a source-based input

This JSON contains published prefills and required-field defaults. Review every value for your task before running it; it is not a promise of successful collection.

{
  "boardUrls": [
    "https://www.pinterest.com/nasa/ceres/"
  ],
  "commerceOnly": false,
  "enrichPinDetails": false,
  "excludeAds": false,
  "ideaSlugs": [],
  "ideaUrls": [
    "https://www.pinterest.com/ideas/beauty/935541271955/"
  ],
  "imageOnly": false,
  "includeComments": false,
  "includeIdeaPins": false,
  "keywords": [
    "minimalist kitchen"
  ],
  "language": "en",
  "maxComments": 10,
  "maxItems": 1,
  "maxPages": 1,
  "mode": "searchPins",
  "pinUrls": [
    "https://www.pinterest.com/pin/142567144448888376/"
  ],
  "requireOutboundLink": false,
  "startUrls": [],
  "usernames": [
    "nasa"
  ],
  "verifiedOnly": false
}

Download input.example.json and save your reviewed copy as input.json.

Field	Type	Required	Description
`mode`	string	required	Choose the Pinterest use case. Every mode uses public Pinterest data and needs no login.
`startUrls`	array	optional	Mixed public Pinterest links for mode=`auto`. Unambiguous Pin, profile, board, board-section, idea, and search links are routed to the matching collector; unsupported links are skipped.
`keywords`	array	optional	Words or phrases for search modes, for example `minimalist kitchen`.
`pinUrls`	array	optional	Public Pinterest Pin links or numeric IDs. Used by mode=`pinDetail` and `comments`. Opaque e1_ IDs from feeds are list-only and cannot be opened directly.
`usernames`	array	optional	Pinterest usernames, @usernames, or public profile links.
`boardUrls`	array	optional	Public board links, `username/board-name` paths, or a section link such as `https://www.pinterest.com/krity_s/home-decor/mens/`.
`ideaUrls`	array	optional	Public Pinterest idea-topic links, for example `https://www.pinterest.com/ideas/beauty/935541271955/`.
`ideaSlugs`	array	optional	Idea topic path pairs such as `beauty/935541271955`. Used when `mode=ideas`.
`maxItems`	integer	optional	Maximum rows returned across all supplied inputs.
`maxPages`	integer	optional	Maximum result pages to walk per feed (one page is about 25-50 Pins).
`language`	string	optional	Pinterest UI language. It affects ranked search results and localized labels.
`minSaves`	integer	optional	Keep Pins whose published save count is at least N. Pins without a published count pass through as unknown.
`minCreatorFollowers`	integer	optional	Keep Pins whose public creator follower count reaches N. Unknown counts pass through.
`verifiedOnly`	boolean	optional	Keep only rows where Pinterest explicitly reports a verified creator or profile.
`requireOutboundLink`	boolean	optional	For Pin results, keep only Pins with a public destination URL supplied by Pinterest.
`imageOnly`	boolean	optional	Drop video Pins and keep image Pins only.
`excludeAds`	boolean	optional	Drop Pins that Pinterest explicitly marks as promoted or sponsored.
`commerceOnly`	boolean	optional	Keep only Pins that carry Pinterest product or shopping metadata.
`enrichPinDetails`	boolean	optional	For `userPins` and `boardPins`, visit each numeric Pin page for detail-only fields. Slower but more complete.
`includeComments`	boolean	optional	Add real public comment and activity rows for collected numeric Pins.
`includeIdeaPins`	boolean	optional	When mode=`ideas`, also emit the Pins shown on the idea-topic page.
`maxComments`	integer	optional	Maximum public comment and activity rows per Pin when comments are enabled or mode=`comments`.
`proxyConfiguration`	object	optional	Optional Apify proxy override. The actor automatically falls back to Apify datacenter proxy and direct traffic, so no proxy setup is required.

3. Start an Actor run

Set APIFY_TOKEN in your environment. Python 3.10 or newer is sufficient; this recipe uses no third-party packages.

Execution may incur charges. Review current pricing on Apify. The request asks for a 120-second timeout and a charge limit; these settings are subject to Apify’s pricing and do not guarantee an all-inclusive spending cap.

import json
import os
import urllib.request

# Save the schema-derived example as input.json; review and edit it first.
with open("input.json", encoding="utf-8") as stream:
    actor_input = json.load(stream)

token = os.environ["APIFY_TOKEN"]
request = urllib.request.Request(
    "https://api.apify.com/v2/acts/2Tm4PxTVqHl3vZsV5/runs?timeout=120&maxTotalChargeUsd=0.50",
    data=json.dumps(actor_input).encode("utf-8"),
    headers={"Authorization": "Bearer " + token, "Content-Type": "application/json"},
    method="POST",
)
# This starts a potentially billable run. Do not automatically retry this POST.
with urllib.request.urlopen(request, timeout=40) as response:
    run = json.load(response)["data"]
print("Run ID:", run["id"])
print("Status:", run["status"])
# Inspect and download results in Apify Console once the run succeeds.

4. Inspect the actual results

Open the run in Apify Console and wait for a successful completion. Use the published output schema to locate results and the dataset schema to understand declared views. Missing or optional record fields must not be treated as guaranteed values.

Public Pinterest Pins, profiles, boards, board sections, idea topics, search results, and comments with real media, creator, board, SEO, commerce, and engagement fields. List-only opaque Pins include idIsEncrypted and detailAvailable instead of a broken URL.

Questions before you run

Which inputs are required?

The published required fields are mode

What does this guide verify?

The fields, prefills, and schema links are rendered from the published build. This is a usage recipe, not a paid live extraction test. Source availability and collection results can vary.

What if the run request times out?

Check Apify Console before retrying. The first request may already have created a run. Do not automatically repeat a run-creation POST.

Open on Apify Full Actor reference

Generated from source build 12qyg2ZPNYh1aCBuR and its README and schemas. Source changes regenerate this guide; no third-party editorial claims are inferred.