Pinterest: scrapers and the official API, compared

Route map

Each line is one way to get Pinterest data; each stop is a field you probably need. Green lines are catalogue Actors, ranked by the published formula.

Which route for which job

The catalogue Actors for Pinterest return different records. "Only this route" lists the published fields no other Actor in this table returns, which is usually what decides the choice. Cost is the published per-result rate; start events and platform usage are extra.

Field matrix: who returns what

Every tool with a published output schema, against the 7 fields most Pinterest jobs need. A dot means the field name appears in the schema; rows can still leave it empty.

Field dictionary: the exact keys

The same core field has a different key in each Actor's output. Map these before you merge datasets; a dash means the published schema has no matching key. Need a field that is not listed here, such as email? Search every Pinterest Actor by field.

Download this comparison: CSV · JSON (every tool with a published schema, matching keys per core field, price and score).

All 14 tools, scored

Catalogue Actors link to their detail pages; the score (0 to 100) is the published formula, identical for every tool. Other Store tools follow in their own table, for reference. Price is the published primary-result rate per 1,000 (the Free-plan rate where the price is tiered; higher Apify plans pay less); start events and platform usage are excluded.

Other Store tools, for reference

Scored with the same published formula and listed for comparison only; this site does not link or recommend them.

What to check before you choose

Visual research on Pinterest connects pins with their creators, boards and destination links. Editorial and merchandising teams use those connections to organize content ideas, study creator activity and investigate shopping interest.

Broad pin and board collectors suit discovery across public content, while dedicated tools focus on conversations, media files or regional trends. The Pinterest API offers OAuth access to pins, boards, users, ads and analytics, with scopes and rate limits shaping what an application can retrieve.

Checklist

• Check identifier and link meanings before combining results. Published names include pinId and pin_id, while sourceUrl, linkUrl and imageUrl serve different reference needs.
• Choose output that matches the research unit: pins and boards for content discovery, comment records for conversations, or trend records for shopping and keyword research. A media downloader publishes file metadata rather than the same output as a pin collector.
• Review access and charging conditions for the route you choose. The official API has OAuth scopes and rate limits, while event-priced collection tools may charge for starts as well as primary results.

Where the data is incomplete

The broad pins, profiles, boards and idea topics tool publishes detailAvailable and idIsEncrypted. Inspect those values before assuming that every pin has full detail or an identifier ready for matching, and check whether description, boardName and createdAt are populated for the records you need.

Engagement totals do not contain the underlying conversations: commentCount and reactionCounts serve different purposes from comment text and reply relationships. Trend output includes region, trendType and weekOverWeekChange, so retain that context when comparing terms rather than treating a trend result as a platform-wide measure.

Official API route

Terms and personal data

Respect Pinterest's terms and keep collection limited to public content. This is general information, not legal advice.

Read Pinterest's terms. Keep to public data, do not bypass logins or access controls, and check whether personal data is involved before you collect it. The can-I-scrape checklist walks through it.

How to start

1. Choose a narrow public collection target using the documented input options, set the available collection limits, and start the run.
2. Inspect the dataset for pin identifiers, image references and destination links, then export the records that fit your research.

Call Pinterest Pins, Profiles, Boards & Idea Topics Scraper from code

The example input uses the Actor's published defaults; set your own Pinterest query before you run it. You need an Apify API token.

from apify_client import ApifyClient

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

run = client.actor("nimbryxo-studio/pinterest-pins-profiles-boards-and-idea-topics").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "mode": "searchPins",
    "startUrls": [],
    "keywords": [
        "minimalist kitchen"
    ],
    "pinUrls": [
        "https://www.pinterest.com/pin/142567144448888376/"
    ],
    "usernames": [
        "nasa"
    ],
    "boardUrls": [
        "https://www.pinterest.com/nasa/ceres/"
    ],
    "ideaUrls": [
        "https://www.pinterest.com/ideas/beauty/935541271955/"
    ],
    "ideaSlugs": [],
    "maxItems": 1,
    "maxPages": 1,
    "language": "en",
    "verifiedOnly": false,
    "requireOutboundLink": false,
    "imageOnly": false,
    "excludeAds": false,
    "commerceOnly": false,
    "enrichPinDetails": false,
    "includeComments": false,
    "includeIdeaPins": false,
    "maxComments": 10
};

const run = await client.actor("nimbryxo-studio/pinterest-pins-profiles-boards-and-idea-topics").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/actors/nimbryxo-studio~pinterest-pins-profiles-boards-and-idea-topics/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"mode":"searchPins","startUrls":[],"keywords":["minimalist kitchen"],"pinUrls":["https://www.pinterest.com/pin/142567144448888376/"],"usernames":["nasa"],"boardUrls":["https://www.pinterest.com/nasa/ceres/"],"ideaUrls":["https://www.pinterest.com/ideas/beauty/935541271955/"],"ideaSlugs":[],"maxItems":1,"maxPages":1,"language":"en","verifiedOnly":false,"requireOutboundLink":false,"imageOnly":false,"excludeAds":false,"commerceOnly":false,"enrichPinDetails":false,"includeComments":false,"includeIdeaPins":false,"maxComments":10}'

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=nimbryxo-studio/pinterest-pins-profiles-boards-and-idea-topics",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

Video

Your Pinterest topics are already ranked

Play

Questions people ask

More on Pinterest

• Ranked listBest Pinterest scrapers on Apify: Actors ranked by fields and price
• Topic groupSocial media data: every website compared
• ToolWhich Pinterest route fits your job?
• ToolPinterest cost by Apify plan, rows and runs

Related websites

• Instagram4 Actors
• TikTok17 Actors

Sources

• Pinterest Pins, Profiles, Boards & Idea Topics Scraper on Apify Store
• Pinterest Pins, Profiles and Boards Collector with Filters on Apify Store
• Pinterest Rich Pin, Board & Creator Field Scraper on Apify Store
• Pinterest Pin Comments & Activity Extractor on Apify Store
• Pinterest Media Downloader on Apify Store
• Pinterest Trending Topics & Shopping Category Scraper on Apify Store
• Pinterest API v5 documentation
• Pinterest terms