Does Pinterest have an ad library?

Yes, the Ads Repository, for ads in the EU, Norway, Turkey and Brazil. AdLib returns it through a REST API in the same schema as the other platforms.

Can I see who paid for a Pinterest ad?

No. Pinterest publishes targeting and reach ranges, but no payer, beneficiary or spend.

Can I search Pinterest ads by keyword?

No. The repository has no keyword search. Search by advertiser or domain, or search our archive with source=history.

Pinterest Ads Repository

Pinterest Ads Repository API

Promoted pins from Pinterest's Ads Repository by advertiser or domain, with title, description, landing page, targeting and reach ranges.

Get 5,000 free credits a month Read the quickstart

Coverage: 30 countries: the EU, Norway, Turkey and Brazil. Not the UK, Switzerland or the US. Searches go back about one year.
Price: 1 credit per ad. 1 credit per delivered ad. A live search page costs at most 5 credits, however many ads it returns. Ads last shown more than 12 months ago cost double. Empty, cached and failed results are free.
Status: Pinterest publishes no active flag, and its end date lags about ten days behind. status is unknown; use last_shown and our last_seen_by_us with your own rule.

Find ads by

Advertiser name (advertiser=…), matched to Pinterest's advertiser list
Advertiser id (advertiser=pinterest:<name>): the repository's advertiser name
Domain (domain=nike.com), checked against the website on the advertiser's Pinterest profile
Ad id (GET /v1/ads/pinterest:{pin id})
Our archive (source=history)

Filters

country: one of the 30 countries; without it, the search uses DE
from / to: up to one year back
format: image, video or carousel, applied to each page, so pages can come back shorter

What you get for each ad

The same fields as every other platform, in one schema. What Pinterest publishes is filled in; what it does not stays null.

Ad and advertiser

id: pinterest:<pin id>
advertiser.name: The advertiser as named in the repository
advertiser.domain, advertiser.verified: The profile's website and whether Pinterest verified it
first_shown, last_shown: Start and end date
extra.profile: Pinterest profile: username, URL, followers, avatar

Creative

formats: image, video or carousel
creatives[].headline, creatives[].text: Pin title and description
creatives[].landing_url: The pin's link
countries: Countries the ad ran in

Moderation

extra.review_status: Pinterest's review status
extra.statement_of_reasons: For disapproved ads, with extra.violation_source and extra.violation_decision_means

Only for ads shown in the EU

Published under the Digital Services Act; see EU reach.

eu_data.targeting.ages and genders
eu_data.targeting.locations: countries, regions, metros and postal codes
eu_data.targeting.other: interests, audience list types, devices, keywords and negative keywords used, and more
extra.reach_eu_range and extra.reach_by_country_range: reach as Pinterest's ranges

What Pinterest does not publish

Payer and beneficiary: Pinterest publishes neither
Spend and impressions: spend_range and impressions_range are null
Exact reach: only ranges, so eu_data.reach_total is null
An active flag: status is always unknown
Keyword search: there is none
CTA and placements

Try it

Nike's promoted pins in France, with targeting and reach ranges.

Media: Original images, and videos with duration and thumbnail. Images are copied to media.adlibapi.com under stable URLs, and videos are archived for advertisers on a watchlist.

curl "https://api.adlibapi.com/v1/search?platform=pinterest&domain=nike.com&country=FR" \
  -H "X-API-Key: $ADLIB_API_KEY"

What to do with it

See which interests and age groups a home or fashion brand targets on Pinterest.
Watch a retailer's promoted pins per country and get alerts on new ones.

Limits

One country per search. Searching all 30 countries means 30 searches.
No keyword search: start from an advertiser or a domain.
The advertiser id is the advertiser's name in the repository, since Pinterest filters by name only.

Questions

Does Pinterest have an ad library?: Yes, the Ads Repository, for ads in the EU, Norway, Turkey and Brazil. AdLib returns it through a REST API in the same schema as the other platforms.
Can I see who paid for a Pinterest ad?: No. Pinterest publishes targeting and reach ranges, but no payer, beneficiary or spend.
Can I search Pinterest ads by keyword?: No. The repository has no keyword search. Search by advertiser or domain, or search our archive with source=history.

Other platforms

Questions about Pinterest data? [email protected]