Pinterest Ads Library Scraper

Pinterest Ads Library Scraper turns a bounded search of Pinterest's public Ads Repository into source-linked, normalized dataset records. Use it to research which creative is visible in a supported market, when an ad ran, and which targeting and reach ranges Pinterest publicly discloses. The output is designed around the repository's public creative and disclosure fields.

Best fit and scope

Choose this Actor for a quick competitor creative audit, agency swipe-file refresh, market research, or a reproducible input for an AI workflow. It is best for one supported market and a date window no wider than 31 calendar days. For organic Pin discovery, creator research, or private advertising-account reporting, start with a focused Pinterest Pin or profile workflow that uses the appropriate public source.

Focused standalone workflow

This Actor works as a focused standalone workflow for public ad-repository research. An agency analyst starts with a named advertiser and one market, exports the saved records, then compares source-linked creative, flight dates, and disclosed reach ranges in a reporting sheet. Next, the strategist can feed the resulting creative themes into an approved content brief or media-planning process.

Quick start

{
    "country": "FR",
    "startDate": "2026-08-01",
    "endDate": "2026-08-10",
    "advertiserName": "Tommy Hilfiger",
    "category": "ALL",
    "gender": "ALL",
    "age": "ALL",
    "maxResults": 10
}

country selects the repository market; advertiserName, category, gender, and age are optional public filters. maxResults is capped at 24 because that is the repository page boundary. Start with a narrow date range and a small result cap, inspect the dataset, then repeat an exact input when you need a reproducible comparison.

Output

Each saved item is a validated public ad record. Empty arrays mean that Pinterest did not disclose a field, not that the Actor inferred a value.

Field	Meaning
adId / repositoryUrl	Pinterest public repository identifier and source link.
advertiserName, title, creativeText	Public advertiser and bounded creative copy.
imageUrl, videoUrl	Public creative assets when Pinterest exposes them.
startDate, endDate	Public ad flight dates when disclosed.
targetCountries, targetAgeBuckets, targetGenders, interests	Public targeting disclosures, not inferred targeting.
audienceReachEu, audienceReachByCountry	Publicly disclosed reach ranges.
source, scrapedAt	Provenance and extraction time.

{
    "adId": "4606126974742064000",
    "repositoryUrl": "https://ads.pinterest.com/ads-repository/?pin_id=4606126974742064000",
    "country": "FR",
    "advertiserName": "Tommy Hilfiger",
    "title": "Bottes Western En Cuir À Logo Gaufré",
    "imageUrl": "https://i.pinimg.com/...jpg",
    "startDate": "2026-07-27",
    "endDate": "2026-08-06",
    "targetCountries": ["France"],
    "targetAgeBuckets": ["18+"],
    "targetGenders": ["FEMALE", "MALE"],
    "audienceReachEu": "0 - 10000",
    "source": "pinterest_ads_repository",
    "scrapedAt": "2026-08-10T12:00:00.000Z"
}

The Actor also writes OUTPUT and RUN_SUMMARY to the default key-value store. Read OUTPUT.outcome before downstream automation: COMPLETE means all fetched records were persisted, PARTIAL means usable data with warnings, VALID_EMPTY means the public repository returned no matching rows, and INVALID_INPUT identifies a fixable input issue. An inaccessible public repository with no useful records is reported as UPSTREAM_FAILED rather than a fabricated empty success.

Pricing and cost boundary

Pay per event is enabled with platform usage passed through to the user. An Actor start costs $0.00005 per allocated GB (one-event minimum), and every validated saved ad costs $0.006. A ten-ad example has at most $0.06005 in named event charges before Apify platform usage. The Actor logs this cap before the first record event; check the live Pricing tab for the current platform component.

Run through the Apify API

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~pinterest-ads-library-scraper/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"country":"FR","startDate":"2026-08-01","endDate":"2026-08-10","advertiserName":"Tommy Hilfiger","maxResults":10}'

AI-agent prompt

Use this Pinterest Ads Library Scraper AI agent workflow to collect up to 10 public Pinterest Ads Repository records for France. Keep repositoryUrl, source, and scrapedAt with the dataset export, read OUTPUT.outcome as a dataset readback before analysis, and use the documented cost and scope boundary when interpreting public reach ranges.

Best-results guidance

Use the exact advertiser name Pinterest exposes and pair one market with a focused date window. Keep the source URL with every benchmark, schedule the same bounded input when freshness matters, and compare disclosed fields as the public repository presents them.

Builder's note

I built this Actor around an anonymous browser session before calling the public repository route. I designed the record contract to retain a clear source path, validate every persisted row, and make the terminal outcome useful to an automation that needs current public-ad evidence.

Responsible use

Use public repository data responsibly, respect Pinterest's terms and applicable law, and treat disclosed demographic ranges as aggregate transparency fields rather than personal data or a basis for sensitive targeting. This independent Actor is not affiliated with Pinterest.