Pinterest Ads Scraper

Pinterest Ads Scraper

The Pinterest Ads Scraper is a fast, API-ready Apify actor that collects public ad data from Pinterest’s Ads Library by date range and country. It solves the time-consuming challenge of manually researching Pinterest campaigns by automating bulk discovery and per-ad detail extraction — perfect for marketers, developers, data analysts, and researchers. As a Pinterest ad scraper and Pinterest ad library scraper, it enables scalable competitor tracking, creative analysis, and reporting workflows across markets.

What is Pinterest Ads Scraper?

Pinterest Ads Scraper is a production-ready tool that fetches promoted Pins from Pinterest’s public Ads Library for a chosen country and date range, then saves structured ad details to a dataset for export. It helps teams replace manual research with an automated Pinterest ads spy tool and Pinterest ad creatives scraper workflow, unlocking faster Pinterest competitor ads analysis and trend tracking at scale.

• Built for marketers, agencies, analysts, and developers who need repeatable Pinterest ads research.
• Enables large-scale discovery, monitoring, and export of Pinterest ad data for reporting and optimization.

What data / output can you get?

Each dataset record represents a single ad (Pin) with a unique ID and a comprehensive ad_details object from Pinterest’s Ads Library.

Data type	Description	Example value
pin_id	Unique identifier of the promoted Pin	“1234567890123456789”
ad_details.advertiser_names	List of advertiser display names	["Acme Co."]
ad_details.start_date	Ad start date	“2026-03-05”
ad_details.end_date	Ad end date	“2026-03-12”
ad_details.countries	Targeted countries (ISO codes)	["FR","BE"]
ad_details.user_count_by_country	Audience counts by country	{"FR": 125000, "BE": 18000}
ad_details.image_link	Primary image URL of the creative	"https://i.pinimg.com/.../creative.jpg"
ad_details.pin_data.title	Pin title text	“Spring Collection Sale”
ad_details.pin_data.details	Pin details/description	“Up to 50% off on selected styles.”
ad_details.pin_data	Additional Pin metadata payload	{ ... }

Notes:

• ad_details is passed through from Pinterest’s public Ads Library and may vary per ad. Some nested keys can be missing depending on the campaign.
• Export your dataset to CSV, JSON, or Excel directly from Apify to power BI dashboards, creative reviews, or archives.

Key features

• ⚡️ Bold-scale discovery & detail collection — Efficient two-phase flow: bulk fetch discovers ads, then individual fetch saves rich details. Concurrency set to 5 with batch size 10 for speed and stability.
• 🎯 Precise market & time filters — Filter by country and date range to focus your Pinterest ad intelligence platform on the campaigns that matter.
• 🧠 Smart retries & stability — Automatic retries with incremental delay (up to 3 attempts) help overcome transient network or rate conditions.
• 🧹 Duplicate-safe saves — Built-in deduplication ensures each ad is captured once even across paginated results.
• 📥 Real-time streaming — Ads are pushed to the dataset as they’re collected, enabling live review and incremental exports.
• 📦 Flexible export — Download results as CSV, JSON, or Excel from the Apify dataset UI for analysis, reporting, and archives.
• 🌐 Optional proxy support — Enable proxyConfiguration if you experience access issues for more robust collection.
• 🔌 API-ready — Orchestrate this Pinterest ads crawler from your stack using the Apify API for pipelines and automation.

How to use Pinterest Ads Scraper - step by step

1. Sign in to your Apify account.
2. Open the Pinterest Ads Scraper actor.
3. Set start_date and end_date in YYYY-MM-DD format (e.g., “2026-03-01” to “2026-03-14”).
4. Select the country you want to analyze (e.g., France). The actor will collect ads shown in that market.
5. (Optional) Adjust resultsLimit to control how many ads to fetch (1–10,000; default 100).
6. (Optional) Enable proxyConfiguration if you encounter access issues (useApifyProxy).
7. Click Start. You’ll see logs like “Discovering ads …” and “Collected …” as the Pinterest promoted pins scraper saves items in real time.
8. Download your results from the run’s Dataset tab in CSV, JSON, or Excel — or pull them via the Apify API for downstream analysis.

Pro Tip: Use a small resultsLimit (e.g., 25) to preview your Pinterest ads research tool setup, then increase it for full-scale runs.

Use cases

Use case name	Description
Pinterest competitor ads analysis	Track competitor creatives and messaging by country and date range to inform your positioning and offers.
Creative testing & benchmarking	Compare titles, formats, and visuals with a Pinterest ad creatives scraper to inspire new tests.
Market entry research	Evaluate ad activity in a target country before investing in campaigns.
Campaign monitoring	Schedule periodic runs to scrape Pinterest sponsored posts and observe changes in creative or targeting over time.
E‑commerce trend insights	Analyze seasonal themes and promotions to guide merchandising and pricing decisions.
BI & dashboard pipelines (API)	Feed the Pinterest ads data extractor into your warehouse and dashboards for ongoing reporting.
Academic & policy research	Study public ad activity across countries and dates using a structured Pinterest ad library scraper dataset.

Why choose Pinterest Ads Scraper?

The Pinterest Ads Scraper prioritizes precision, automation, and reliability for production workflows.

• 🎯 Accurate, focused extraction from Pinterest’s public Ads Library endpoints.
• ⚡ Fast, concurrent collection (5 parallel requests, batch size 10) with built-in retry logic.
• 📈 Scales to large pulls with resultsLimit up to 10,000 records.
• 🔌 API-ready output with straightforward CSV/JSON/Excel exports from Apify datasets.
• 🧰 Optional proxy for resilient access in stricter environments.
• 🛡️ Stable infrastructure — avoids fragile browser extensions and manual copy-paste.
• 🧾 Clear country and date filters for targeted Pinterest ads spy tool workflows.

In short: a reliable, production-grade Pinterest ads scraper tool for automated, structured insights.

Is it legal / ethical to use Pinterest Ads Scraper?

Yes — when done responsibly. This actor collects data from Pinterest’s public Ads Library endpoints and does not access private or authenticated content.

Guidelines:

• Only use data that is publicly available.
• Comply with applicable regulations (e.g., GDPR, CCPA) and platform terms.
• Avoid scraping personal or sensitive information.
• Use the data for analysis and research — not for spam or misuse.
• Consult your legal team for edge cases or jurisdiction-specific questions.

Input parameters & output format

Example JSON input

{
  "start_date": "2026-03-01",
  "end_date": "2026-03-14",
  "country": "France",
  "resultsLimit": 100,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Parameters

• start_date (string)
  • Description: First day of the period (YYYY-MM-DD). Required.
  • Default: "2026-03-01"
  • Required: Yes
• end_date (string)
  • Description: Last day of the period (YYYY-MM-DD). Required.
  • Default: "2026-03-14"
  • Required: Yes
• country (string)
  • Description: Choose the market you want to analyze — ads shown in this country will be collected.
  • Default: "France"
  • Required: Yes
• resultsLimit (integer)
  • Description: Maximum number of ads to fetch (1–10,000).
  • Default: 100
  • Required: No
• proxyConfiguration (object)
  • Description: Enable if you experience access issues. Most users can leave this disabled.
  • Default: {"useApifyProxy": false} (prefill)
  • Required: No

Example JSON output

{
  "pin_id": "1234567890123456789",
  "ad_details": {
    "advertiser_names": ["Acme Co."],
    "start_date": "2026-03-05",
    "end_date": "2026-03-12",
    "countries": ["FR", "BE"],
    "user_count_by_country": {
      "FR": 125000,
      "BE": 18000
    },
    "image_link": "https://i.pinimg.com/.../creative.jpg",
    "pin_data": {
      "title": "Spring Collection Sale",
      "details": "Up to 50% off on selected styles."
    }
  }
}

Notes:

• Records are pushed in real time via Actor.push_data with fields pin_id and ad_details.
• ad_details is returned as provided by Pinterest’s Ads Library; nested fields may vary by ad and may be absent in some cases.

FAQ

Is there a free tier or trial?

✅ Yes. You can run the Pinterest Ads Scraper on Apify’s platform with pay‑as‑you‑go usage. Start with small resultsLimit values to estimate costs.

Do I need to log in to Pinterest or provide cookies?

❌ No. The scraper uses Pinterest’s public Ads Library endpoints and does not require login or cookies.

Can I use this with Python or an API?

💻 Yes. The actor is API‑ready, and you can orchestrate runs and download datasets via the Apify API from Python or any language.

How many ads can I scrape in one run?

📈 You can configure resultsLimit from 1 to 10,000. The actor runs 5 concurrent requests with batch size 10 for efficient collection.

Which countries are supported?

🌍 You select a country from the predefined list (e.g., France, United States, United Kingdom, Germany, Spain, and more). Ads shown in that market will be collected for your date range.

What ad data does it return?

🧩 Each record includes a pin_id and an ad_details object from Pinterest’s Ads Library. ad_details typically includes advertiser_names, start_date, end_date, countries, user_count_by_country, image_link, and pin_data (title, details, etc.).

Does it support proxies?

🔒 Yes. Enable proxyConfiguration if you experience access issues. By default, useApifyProxy is set to false.

Can I scrape Pinterest sponsored posts for competitor analysis?

✅ Yes. This Pinterest ads monitoring tool is ideal for Pinterest competitor ads analysis and research, enabling you to track creatives by country and date range.

Closing CTA / Final thoughts

Pinterest Ads Scraper is built for structured, scalable Pinterest ad intelligence and monitoring. It delivers fast bulk discovery with per-ad detail, clean dataset exports, and optional proxy support — ideal for marketers, agencies, developers, and researchers.

Use it to export campaigns to CSV/JSON, power dashboards, or automate pipelines via the Apify API. Start running your Pinterest ads spy tool at scale and extract smarter insights for better creative and strategy decisions.