Pinterest Easy Scraper

Pinterest Easy Scraper

Collect bounded public Pinterest profile and Pin data from profile URLs or bare usernames. The HTTP workflow tries Pinterest's public widget endpoint, enriches it with the profile page's public SSR state, and makes a best-effort UserPinsResource request when more Pins are requested than the first tiers provide. Login-only content, private data, and challenge bypasses are out of scope.

Input

startUrls is required by the Store contract and accepts profile URLs or bare usernames. Board, search, category, and individual Pin URLs are rejected and become diagnostic rows.

{
  "startUrls": ["https://www.pinterest.com/nasa/"],
  "maxPinsCnt": 25,
  "widgetFirst": true,
  "fallbackToBrowser": false,
  "minConcurrency": 1,
  "maxConcurrency": 2,
  "minDelayMs": 0,
  "maxDelayMs": 0,
  "maxRequestRetries": 0,
  "requestHandlerTimeoutSecs": 30,
  "includeRaw": false,
  "proxyConfig": { "useApifyProxy": false }
}

maxPinsCnt is the per-profile limit from 1 to 10,000. widgetFirst controls the first public tier; fallbackToBrowser is retained as a compatibility flag and does not launch a browser. Concurrency, delay, retry, timeout, proxy, and user-agent settings are bounded and validated. proxyConfig and proxyConfiguration are accepted aliases. Proxy credentials are never emitted in dataset rows.

When includeRaw is true, a bounded sanitized source copy is written to the profile's key-value-store entry. It is not added to dataset records, so normal rows keep a stable clean contract.

Collection behavior

The actor uses public Pinterest HTTP responses only. The widget tier is followed by HTML SSR parsing and, for larger requests, UserPinsResource bookmark pagination. A successful profile with no public Pins emits the profile plus a diagnostic explaining the empty Pin result. Blocked or unavailable public endpoints emit a minimal diagnostic row.

Output

Normal dataset rows use entityType values pinterest_profile and pinterest_pin. Profile rows contain public identity, biography, profile and cover images, counts, locale, domain, and verification fields. Pin rows contain the Pin ID and URL, title/description, outbound link/domain, image, video metadata, board metadata, public counts, and creation time when supplied.

{
  "entityType": "pinterest_profile",
  "id": "142567281862381039",
  "username": "nasa",
  "fullName": "NASA",
  "profileUrl": "https://www.pinterest.com/nasa/",
  "pinCount": 10549,
  "followerCount": 556378,
  "sourceUrl": "https://www.pinterest.com/nasa/",
  "scrapedAt": "2026-09-08T00:00:00.000Z"
}

{
  "entityType": "pinterest_pin",
  "id": "142567144448897971",
  "profile": "nasa",
  "pinUrl": "https://www.pinterest.com/pin/142567144448897971/",
  "title": "A public Pin",
  "link": "https://www.nasa.gov/",
  "image": { "url": "https://i.pinimg.com/originals/example.jpg", "width": 1080, "height": 1920 },
  "sourceUrl": "https://www.pinterest.com/nasa/",
  "scrapedAt": "2026-09-08T00:00:00.000Z"
}

Diagnostics intentionally contain only the requested URL, sanitized error, stable error code, and timestamp:

{
  "url": "https://www.pinterest.com/nasa/",
  "error": "Public profile metadata was available but no public pins were returned",
  "errorCode": "SOURCE_UNAVAILABLE",
  "scrapedAt": "2026-09-08T00:00:00.000Z"
}

The OUTPUT_SUMMARY key-value record contains run status, data/diagnostic counts, profile and Pin counts, proxy state, source mode, and completion time. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

Responsible use

Use Pinterest data only for lawful, public-data purposes and follow Pinterest's terms, applicable privacy law, and respectful rate limits. Private content, messages, emails, and hidden user data are not collected.