Pinterest Search Scraper

Quickly extract Pinterest pins by search query or filter. Designed for reliable, structured content discovery—get pin titles, images, URLs, type, publish date, and basic pinner info.

Key Features

• Search Pinterest by keyword.
• Filter to videos only.
• Limit number of results.
• Optional dataset reset for dev/testing.
• Infinite-scroll emulation for deeper coverage.
• Returns clean pin metadata ready for downstream usage.

Input Parameters

{
  "query": "wallpaper",
  "filter": "all",             // "all" or "videos"
  "limit": 100,                // max pins to return
  "dev_dataset_clear": false   // true to drop existing dataset before run
}

	•	query (string, required): Search term to find relevant pins.
	•	filter (string, optional): "all" (default) or "videos" to restrict to video pins.
	•	limit (integer, optional): Maximum number of pins to crawl/return.
	•	dev_dataset_clear (boolean, optional): If true, clears previous dataset before execution.

Optional Enhancements

To access some richer or logged-in features (e.g., certain product/detail views), include your Pinterest session cookie _pinterest_sess in additional request headers via advanced input (use with caution and only if you understand the privacy/security implications).

Example Input

{
  "query": "minimalist home office",
  "filter": "all",
  "limit": 50
}

Output Sample

{
  "id": "656188608249555004",
  "url": "https://www.pinterest.com/pin/656188608249555004/",
  "title": "Nov 24, 2024 - Discover (and save!) your own Pins on Pinterest.",
  "type": "pin",
  "imageURL": "https://i.pinimg.com/736x/e3/c6/56/e3c656ad21b8089fff49afb9f50431c6.jpg",
  "pinner": {
    "username": "khairultabunia"
  },
  "date": "2024-11-24"
}

Notes / Tips
	•	The scraper scrolls the search results to queue more pins automatically; you don’t need to manually paginate.
	•	Use limit to control cost and runtime; higher limits may take longer as more content is loaded.
	•	If you see incomplete pinner metadata, the public view may not expose all details—this is expected; core fields like title, imageURL, and url remain reliable.
	•	Running with dev_dataset_clear: true is useful when iterating on inputs during development to avoid mixing old results.

Use Cases
	•	Inspiration mining (wallpapers, design ideas, products)
	•	Content curation and aggregation
	•	Market research on visual trends
	•	Building galleries or previews from Pinterest search results

    Happy Scrapings! 
    Fatih