---

README.md

📌 Pinterest Master Scraper: Search, Pins, Comments & Leads

This is a professional-grade, high-performance Pinterest Scraper designed for marketing researchers, lead generation experts, and data analysts. It allows you to extract rich data from Pinterest without the need for an official API.

🚀 Key Features

• Search Keyword Support: Scrape thousands of pins based on any search query.
• Direct URL Scraping: Provide a list of specific Pin URLs to extract detailed data.
• Lead Generation Mode: Specialized Include User Info Only flag to extract creators' data (usernames, follower counts, verified status).
• Deep Comment Extraction: Fetch the latest comments for every pin, including user details of the commenters.
• Rich Media Mapping: Get links to Original, HD, Medium, and Thumbnail image sizes.
• Video Support: Detects and extracts video URLs where available.
• Business Insights: Scrapes external links (e.g., Instagram, Shop links, Blogs) which are perfect for finding influencer contact info.

🛠 Usage & Input Options

The scraper is highly flexible. Below are the main parameters you can configure:

Field	Type	Description
Search	String	Any keyword (e.g., "fitness coach", "modern interior").
Max Items	Integer	Limit the number of pins collected.
Include Comments	Boolean	Deep-scrapes the comment section for every pin.
Include User Info Only	Boolean	Filters out pin data to give you a clean list of creators/leads.
Start URLs	Array	List of direct Pin links to scrape specific items.

📊 Output Data Structure

The scraper provides a comprehensive JSON output. Example fields include:

• id and title
• description (including AI-generated alt text)
• stats (saves, likes, comment count)
• author (ID, username, full name, follower count, profile image, verified merchant status)
• board (name, link, total pin count)
• images (multiple resolutions)
• external_url (the direct link to the creator's website or Instagram)

💡 Use Cases

1. Influencer Outreach: Search for niches like "fashion blogger" and extract their Pinterest profiles and Instagram links.
2. Market Research: Analyze trending styles by extracting descriptions and dominant colors.
3. Content Aggregation: Download high-quality images and descriptions for mood boards or AI training.
4. Competitor Analysis: Monitor boards and engagement (saves/likes) of specific brands.

🔒 Proxy Requirements

For stable performance and to bypass Pinterest's rate limits, it is highly recommended to use Residential Proxies.