# Pinterest Ads Scraper (`scrapier/pinterest-ads-scraper`) Actor Extract Pinterest Ads data quickly with Pinterest Ads Scraper. Collect ad creatives, advertiser details, engagement insights, landing pages, and campaign-related public data for competitor research, ad analysis, lead generation, and marketing intelligence. - **URL**: https://apify.com/scrapier/pinterest-ads-scraper.md - **Developed by:** [Scrapier](https://apify.com/scrapier) (community) - **Categories:** Lead generation, Social media, Automation - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Pinterest Ads Scraper Pinterest Ads Scraper is a fast, production-ready Pinterest ads scraping tool that collects public ad data from Pinterest’s Ads Library by date range and country. It helps you scrape Pinterest ads for competitor research, ad analysis, and marketing intelligence — acting like a Pinterest ad spy tool, Pinterest promoted pins scraper, and Pinterest ad library scraper in one. Built for marketers, developers, data analysts, and researchers, it scales from one-off checks to ongoing pipelines for Pinterest ads intelligence. ### What data / output can you get? Below are the real fields delivered to the Apify dataset. Each item contains a unique ad identifier and the full Pinterest Ads Library payload for that ad. | Data type | Description | Example value | | --- | --- | --- | | pin_id | Unique identifier of the promoted pin (ad) | 1234567890123 | | ad_details | Raw ad details object from Pinterest Ads Library | {...} | | ad_details.advertiser_names | Advertiser display names | ["Acme Co."] | | ad_details.pin_data.title | Ad creative title from the pin data | "Spring Sale — 50% OFF" | | ad_details.start_date | Campaign start date for the ad (if provided by Pinterest) | "2026-03-01" | | ad_details.end_date | Campaign end date for the ad (if provided by Pinterest) | "2026-03-14" | | ad_details.countries | Targeted countries (country codes) | ["FR"] | | ad_details.user_count_by_country | Estimated audience by country (if provided) | {"FR": 48000} | | ad_details.image_link | Primary creative image URL (if provided) | "https://i.pinimg.com/.../creative.jpg" | | ad_details.pin_data | Full pin metadata object (title and more, as available) | {"title": "New arrivals", "...": "..."} | Notes: - Results are stored to the Apify dataset in real time. You can export to JSON, CSV, or Excel. - The ad_details object is returned as provided by Pinterest’s public Ads Library and may include additional metadata beyond the examples above. ### Key features - ⚡ Bold-scale discovery & enrichment Paginated bulk discovery finds ads quickly, then each ad is enriched with a detailed per-ad call — a robust Pinterest ads scraping tool flow for complete coverage. - 🔍 Date- and country-scoped precision Target exactly what you need by specifying a date range and country, making it ideal as a Pinterest competitor ads scraper or Pinterest shopping ads scraper. - 🚀 Concurrent, batched collection Optimized for performance with 5 concurrent requests, batch size 10, and smart retry logic for resilient collection of Pinterest ad examples. - 🎯 Configurable volume control Use resultsLimit (1–10,000) to cap how many ads you collect — perfect for quick spot checks or bulk Pinterest ads intelligence runs. - 🌐 Optional proxy support Built-in Apify Proxy configuration toggle if you experience access issues, ensuring reliable scraping of Pinterest promoted pins. - 🧩 Developer-friendly & automation-ready Runs on Apify with a clean dataset output, easy to integrate via Apify API into pipelines, dashboards, or scripts for a Pinterest ads scraper bot workflow. - 📦 Structured outputs for analytics Each record includes pin_id and ad_details, enabling downstream analysis for a Pinterest ad analytics scraper or creatives downloader workflow. - 🛡️ Production-ready reliability Includes retry handling and real-time streaming to the dataset with logs for transparency — stable alternative to fragile Pinterest ads spy software. ### How to use Pinterest Ads Scraper - step by step 1. Sign up and log in to Apify. 2. Open the Pinterest Ads Scraper actor. 3. Enter your input: - start_date (YYYY-MM-DD) - end_date (YYYY-MM-DD) - country (select from the list, e.g., France) - resultsLimit (optional; default 100; 1–10,000) - proxyConfiguration (optional; enable Apify Proxy if needed) 4. Click Start to run the actor. 5. During the run, the actor discovers ads in bulk and then fetches per-ad details. Progress is logged live. 6. When finished, open the Dataset tab to view results in a table. 7. Export your data to JSON, CSV, or Excel for analysis or downstream tools. Pro Tip: Set resultsLimit to a higher value for deeper discovery, and schedule runs by market to build a Pinterest ads intelligence dataset over time. ### Use cases | Use case name | Description | | --- | --- | | Marketing teams — competitor ad tracking | Monitor advertisers’ creatives and messaging by time window and region to inform campaigns and benchmark performance. | | Agencies — creative research & inspiration | Aggregate Pinterest ad examples across markets for creative reviews and mood boards. | | Growth analysts — audience & market insights | Extract public ad details to analyze trends across countries and date ranges for strategic planning. | | E-commerce — product launch validation | Review Pinterest shopping ads for competing products during key launch periods to refine targeting and positioning. | | Data teams — API pipelines & dashboards | Feed dataset outputs into BI tools or APIs to power dashboards and automated Pinterest ads analytics. | | Researchers — academic & policy studies | Study ad activity in specific markets and windows using reproducible, structured datasets from public sources. | ### Why choose Pinterest Ads Scraper? Pinterest Ads Scraper is built for precision, automation, and reliability — a robust Pinterest ads scraping tool that outperforms manual browsing and unstable extensions. - 🎯 Accurate, scoped collection by date and country for targeted research - ⚡ Efficient bulk discovery + per-ad enrichment with concurrency and batching - 📊 Clean, structured dataset output (pin_id + ad_details) for analytics and pipelines - 🧩 Developer access via the Apify platform and dataset API for integrations - 🌐 Optional proxy support for resilient access in stricter environments - 💸 Scales from quick checks to 10,000-ad pulls per run via resultsLimit - 🛡️ Uses public Ads Library endpoints — dependable vs. brittle browser add-ons Bottom line: a production-ready Pinterest ad spy tool that delivers consistent, structured outputs for teams who need reliable Pinterest ads intelligence. ### Is it legal / ethical to use Pinterest Ads Scraper? Yes — when done responsibly. This actor collects data from Pinterest’s public Ads Library and does not access private or authenticated content. Guidelines for compliant use: - Only use publicly available ad data for legitimate analysis and research. - Respect applicable data protection regulations (e.g., GDPR, CCPA). - Avoid attempting to access private, non-public, or authenticated resources. - Review Pinterest’s terms and consult your legal team for edge cases or commercial distribution. ### Input parameters & output format Example JSON input ```json { "start_date": "2026-03-01", "end_date": "2026-03-14", "country": "France", "resultsLimit": 100, "proxyConfiguration": { "useApifyProxy": false } } ```` Parameters - start\_date (string, required) — First day of the period (YYYY-MM-DD). Default: "2026-03-01" - end\_date (string, required) — Last day of the period (YYYY-MM-DD). Default: "2026-03-14" - country (string, required) — Choose the market you want to analyze — ads shown in this country will be collected. Default: "France" (supports: Austria, Belgium, Brazil, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, Turkey, United Kingdom, United States) - resultsLimit (integer, optional) — Maximum number of ads to fetch (1–10,000). Default: 100 - proxyConfiguration (object, optional) — Enable if you experience access issues. Most users can leave this disabled. Prefill: {"useApifyProxy": false} Example JSON output ```json { "pin_id": "1234567890123", "ad_details": { "advertiser_names": ["Acme Co."], "start_date": "2026-03-01", "end_date": "2026-03-14", "countries": ["FR"], "user_count_by_country": { "FR": 48000 }, "image_link": "https://i.pinimg.com/originals/ab/cd/ef/acme-creative.jpg", "pin_data": { "title": "Spring Sale — 50% OFF" } } } ``` Notes: - Output records are pushed incrementally: {"pin\_id": string, "ad\_details": object}. - Some ad\_details subfields may be missing depending on the ad — for example, pin\_data.title may be empty, and certain metadata (e.g., image\_link) may not be present for all items. ### FAQ #### Do I need a Pinterest account or login to use this? ✅ No. The actor collects public data from Pinterest’s Ads Library and does not require login or cookies. You only need an Apify account to run the actor. #### How many ads can I scrape per run? 📈 You control volume with resultsLimit (1–10,000). Internally, the actor discovers ads in pages of 24 and enriches them in parallel with batching for speed and reliability. #### Which countries are supported? 🌍 You can select one of the following: Austria, Belgium, Brazil, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, Turkey, United Kingdom, United States. #### What data do I get back? 📦 Each record contains pin\_id and ad\_details (the raw Ads Library payload). ad\_details commonly includes advertiser\_names and pin\_data.title, and may include fields like start\_date, end\_date, countries, user\_count\_by\_country, and image\_link when available. #### Can I use this for competitor research and ad inspiration? ✅ Yes. It functions as a Pinterest ad spy tool and Pinterest creatives downloader workflow by exposing advertiser names and creative metadata for promoted pins. #### Can I integrate the results with my BI tools or scripts? 💻 Yes. Results are stored in an Apify dataset, which you can access via the Apify API and export to JSON, CSV, or Excel for pipelines, dashboards, or a Pinterest ad analytics scraper workflow. #### What if I get no results? 🔎 Try expanding the date range or selecting a different country. The actor logs “No ads found for this date range and country” when the Ads Library has no matches for your selection. #### Do I need to enable a proxy? 🔒 Usually not. Most users can leave the proxy disabled. If you experience access issues, enable proxyConfiguration with useApifyProxy to improve reliability. ### Closing CTA / Final thoughts Pinterest Ads Scraper is built to collect structured, public Pinterest ad data by date and country at scale. It delivers clean pin\_id + ad\_details records for marketers, agencies, data analysts, and researchers who need a dependable Pinterest ads scraper bot for insights. Use it to power a Pinterest ad library scraper workflow, export to CSV/JSON for analysis, and plug into your API pipelines. Developers can access results via the Apify dataset API and automate recurring jobs for continuous Pinterest ads intelligence. Start extracting smarter insights from public Pinterest ads and turn them into competitive advantage today. ### What are other Pinterest scraping tools? If you want to scrape specific Pinterest data, you can use any of the dedicated scrapers below for faster and more targeted results. | Scraper Name | Scraper Name | |---|---| | [Pinterest Autocomplete Scraper](https://apify.com/scrapier/pinterest-autocomplete-scraper) | [Pinterest Keywords Discovery](https://apify.com/scrapier/pinterest-keywords-discovery-scraper) | | [Pinterest Boards Scraper](https://apify.com/scrapier/pinterest-boards-scraper) | [Pinterest Lead Scraper](https://apify.com/scrapier/pinterest-lead-scraper) | | [Pinterest Comment Scraper](https://apify.com/scrapier/pinterest-comment-scraper) | [Pinterest Phone Number Scraper](https://apify.com/scrapier/pinterest-phone-number-scraper) | | [Pinterest Email Scraper](https://apify.com/scrapier/pinterest-email-scraper) | [Pinterest Pins/Videos Search Scraper](https://apify.com/scrapier/pinterest-pins-videos-search-scraper) | | [Pinterest Followers Scraper](https://apify.com/scrapier/pinterest-followers-scraper) | [Pinterest Profile Scraper](https://apify.com/scrapier/pinterest-profile-scraper) | | [Pinterest Following Scraper](https://apify.com/scrapier/pinterest-following-scraper) | [Pinterest Search Scraper](https://apify.com/scrapier/pinterest-search-scraper) | # Actor input Schema ## `start_date` (type: `string`): First day of the period (YYYY-MM-DD). Required. ## `end_date` (type: `string`): Last day of the period (YYYY-MM-DD). Required. ## `country` (type: `string`): Choose the market you want to analyze—ads shown in this country will be collected ## `resultsLimit` (type: `integer`): Maximum number of ads to fetch (1–10,000) ## `proxyConfiguration` (type: `object`): Enable if you experience access issues. Most users can leave this disabled. ## Actor input object example ```json { "start_date": "2026-03-01", "end_date": "2026-03-14", "country": "France", "resultsLimit": 100, "proxyConfiguration": { "useApifyProxy": false } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapier/pinterest-ads-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "proxyConfiguration": { "useApifyProxy": False } } # Run the Actor and wait for it to finish run = client.actor("scrapier/pinterest-ads-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "proxyConfiguration": { "useApifyProxy": false } }' | apify call scrapier/pinterest-ads-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapier/pinterest-ads-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Ads Scraper", "description": "Extract Pinterest Ads data quickly with Pinterest Ads Scraper. Collect ad creatives, advertiser details, engagement insights, landing pages, and campaign-related public data for competitor research, ad analysis, lead generation, and marketing intelligence.", "version": "0.2", "x-build-id": "rHMkIMPwpVIKbEEqA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~pinterest-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-pinterest-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapier~pinterest-ads-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-pinterest-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapier~pinterest-ads-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-pinterest-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "start_date", "end_date", "country" ], "properties": { "start_date": { "title": "📅 Start Date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "First day of the period (YYYY-MM-DD). Required.", "default": "2026-03-01" }, "end_date": { "title": "📅 End Date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Last day of the period (YYYY-MM-DD). Required.", "default": "2026-03-14" }, "country": { "title": "🌍 Country", "enum": [ "Austria", "Belgium", "Brazil", "Bulgaria", "Croatia", "Cyprus", "Czech Republic", "Denmark", "Estonia", "Finland", "France", "Germany", "Greece", "Hungary", "Ireland", "Italy", "Latvia", "Lithuania", "Luxembourg", "Malta", "Netherlands", "Poland", "Portugal", "Romania", "Slovakia", "Slovenia", "Spain", "Sweden", "Turkey", "United Kingdom", "United States" ], "type": "string", "description": "Choose the market you want to analyze—ads shown in this country will be collected", "default": "France" }, "resultsLimit": { "title": "🔢 Results Limit", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of ads to fetch (1–10,000)", "default": 100 }, "proxyConfiguration": { "title": "🔒 Proxy (Optional)", "type": "object", "description": "Enable if you experience access issues. Most users can leave this disabled." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```