The X Ads Repository publishes every ad served in the EU, but the official tool looks up one advertiser at a time and shows little more than the embedded post. The actor turns it into a dataset: impressions, reach and frequency by country, every targeting criterion X discloses, the ad account (which often reveals the media agency) and the full creative with its landing page and UTM tags.
Since 2023 the EU Digital Services Act (DSA, art. 39) requires very large platforms to publish a repository of the ads they serve in the EU: who advertises, who paid, when, how many people it reached and how it was targeted.
| Group | Fields | What it adds |
|---|---|---|
| Performance | impressions · reach · frequency | Per ad and country; optionally impressions month by month. |
| Targeting | targeting[] · targetingByType{} · targetingSummary | Interests, keywords, followers of accounts, lookalikes, custom audiences, age, gender, language, OS and geo. |
| Who is behind it | adAccountName · agencyName · fundingInstrumentType · currency | The agency is inferred from the account name (Brand - Agency) and flagged. |
| Creative | text · media[] · headline · destinationUrl · utm{} | Text, images, MP4 videos, headline, landing page, domain and parsed UTM parameters. |
| Monitoring | changeType · firstSeen · lastSeen · contentHash | With a monitor key, each weekly run returns only new, changed or removed ads. |
It uses its own field names (adKey, advertiserName, adAccountName, impressions, reach, targetingByType, qualityFlags), different from the common block of the Microsoft, Amazon, Apple and Booking.com DSA actors. To stack it with them, map adKey to ad_id and advertiserName to advertiser. See the actor on Apify
Selected columns from one row of the README output example (run of 11 November 2026). Company advertisers only.
| Field | Value |
|---|---|
| advertiserName | Spotify |
| country | CZ |
| adAccountName | Spotify - Universal McCann |
| agencyName | Universal McCann |
| impressions | 7121 |
| reach | 3710 |
| frequency | 1.919 |
| targetingTypes | ["Geo", "InterestCategory"] |
| creativeType | video_website |
| headline | Poslouchej Na Spotify |
| destinationDomain | spotify.app.link |
| qualityFlags | ["agency_inferred"] |
Nothing is filtered by default. quality_flags marks what deserves a second look, and the decision is yours.
Public sample: 27 real ads and 52 columns, in JSON and CSV, no sign-up.
Better to say it before you build an analysis on top of it.
searchTerms filters afterwards on text, headline, landing page or targeting.adAccountName, agencyNametargetingByType by advertiser and country.Result: the interests and audiences each rival buys.targetingByType, countryutm{} and destinationUrl from each creative.Result: the real name of each campaign and its landing page.utm, destinationUrlExamples from the README or from real runs. Paste the input into the actor's JSON tab and press Start.
| Task | Input (JSON) | What it is for |
|---|---|---|
| Streaming competitors, changes only | {"advertisers": ["Spotify", "@amazon"], "marketPreset": "eu27", "startDate": "2025-01-01", "enrichCreatives": true, "monitorKey": "streaming-competitors", "onlyChanges": true} | Scheduled weekly, it only charges for new or changed ads. |
| DACH with monthly timeline | {"advertisers": ["@Nike"], "marketPreset": "dach", "deliveryTimeline": "monthly"} | When each ad ran and how hard. |
A scheduled weekly run is enough to follow competitors.
Run it yourself, receive it on a schedule or commission the project.
Plus a $0.001 start fee per run. Rows for advertisers not found are free.
Only ads served in the EU, which is what X publishes under the DSA, from 26 August 2023. Ads shown only in the US or other regions are not in the repository.
The repository only supports advertiser lookups. searchTerms keeps ads whose text, headline, landing URL or targeting match your words.
Many ad accounts are named Brand - Agency. When that pattern is present, the actor fills agencyName and adds the flag agency_inferred.
X lets you browse it on the web and request report exports by account, country and dates, but it offers no ad-by-ad query API. The actor returns a filterable dataset you can schedule directly.
$0.30 per 1,000 ads on Apify's free plan, plus $0.001 per run. The $5 free credit covers about 15,000 ads.