📌 Pinterest Trends & Core Scraper (Unified Engine)

A high-performance, cost-effective, and robust B2B data scraper that extracts Pinterest Trends, keyword metrics, pins, comments, boards, and user profiles into clean structured JSON/CSV datasets.

---

⚡ Unified Hybrid Architecture

This scraper is built with a state-of-the-art Hybrid HTTP + Playwright extraction engine:

1. Pinterest Trends & Volatility (Pure HTTP): Fetches global trends, keyword search volumes, and historical growth metrics (Wow/MoM/YoY) directly using lightweight HTTP REST requests—taking less than 1 second per query with zero browser compute costs.
2. Pin, Board & User Profiles (HTML SSR Extraction): Directly parses pre-rendered React Server-Side Rendered (SSR) data in the page body—recovering 30+ detailed fields (9 image resolutions, comments, saves, and links) without opening heavy browsers.
3. Keyword Search (Playwright Fallback): Launches headless Chromium only when necessary to perform deep infinite-scroll on unauthenticated search results.

---

🪙 Monetization: Pay-Per-Result (PPR)

• Actor Start Fee: $0.05
• Result Fee: $0.001 per data record (Save up to 50% compared to competitor scrapers charging $0.002!)
• Compute Costs: Free/Risk-Free (Compute is fully paid by the platform/user).

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
startUrls	Array	No	-	List of Pinterest URLs to scrape (Pins, boards, profiles, trends).
search	String	No	-	Keyword to search for pins (Playwright) or trends metrics (HTTP).
mode	String	No	"auto"	Mode: auto (auto-detect from URL), trends (force trends), or core.
maxItems	Integer	No	100	Maximum number of results to extract.
proxy	Object	No	-	Apify Proxy configuration (Highly recommended to avoid rate limits).

---

📊 Sample Output Format (Pin Result)

{
  "type": "pin",
  "id": "1096556209247124248",
  "url": "https://www.pinterest.com/pin/1096556209247124248/",
  "title": "Altered Photographs",
  "description": "Whimsical Middle School Altered Photograph Art Project",
  "createdAt": "Sat, 15 Oct 2022 14:56:20 +0000",
  "imageUrl": "https://i.pinimg.com/originals/8a/83/64/8a8364da0e09c9bfd85616f7bdfae8f7.jpg",
  "imageUrls": {
    "236x": "https://i.pinimg.com/236x/8a/83/64/8a8364da0e09c9bfd85616f7bdfae8f7.jpg"
  },
  "saves": 2538,
  "comments": 5,
  "likes": 162,
  "shares": 44,
  "link": "https://smallhandsbigart.com",
  "domain": "smallhandsbigart.com",
  "isVideo": false,
  "pinner": {
    "username": "podailsaves2",
    "fullName": "Podail Saves"
  }
}

---

📈 Sample Output Format (Trends Result)

{
  "type": "trend_top",
  "term": "flowery deltarune",
  "country": "US",
  "date": "2026-07-09",
  "searchCount": 80,
  "normalizedCount": 80,
  "seasonality_score": 0.322,
  "wow_change": -0.09,
  "mom_change": 100.01,
  "yoy_change": 100.01,
  "url": "https://trends.pinterest.com/?terms=flowery%20deltarune"
}

---

💡 Best Practices

• Use Apify Proxy: Pinterest is highly sensitive to scraping. Enabling Apify Proxy ensures zero rate limit blockage.
• Filter by Mode: If you only need Trends research, force mode: "trends" to avoid launching browsers and keep latency to a minimum.
• Control Results with Max Items: Set a precise limit on maxItems to manage results and budget effectively.