rastriq. Talk to us →
Rastriq / X (Twitter) ads

Competitor ads on X (Twitter).

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.

27
EU countries
71
Fields per ad (README)
$0.30
Per 1,000 ads

What is in the X (Twitter) library

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.

GroupFieldsWhat it adds
Performanceimpressions · reach · frequencyPer ad and country; optionally impressions month by month.
Targetingtargeting[] · targetingByType{} · targetingSummaryInterests, keywords, followers of accounts, lookalikes, custom audiences, age, gender, language, OS and geo.
Who is behind itadAccountName · agencyName · fundingInstrumentType · currencyThe agency is inferred from the account name (Brand - Agency) and flagged.
Creativetext · media[] · headline · destinationUrl · utm{}Text, images, MP4 videos, headline, landing page, domain and parsed UTM parameters.
MonitoringchangeType · firstSeen · lastSeen · contentHashWith 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

A real record

Selected columns from one row of the README output example (run of 11 November 2026). Company advertisers only.

FieldValue
advertiserNameSpotify
countryCZ
adAccountNameSpotify - Universal McCann
agencyNameUniversal McCann
impressions7121
reach3710
frequency1.919
targetingTypes["Geo", "InterestCategory"]
creativeTypevideo_website
headlinePoslouchej Na Spotify
destinationDomainspotify.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.

What this library will not give you

Better to say it before you build an analysis on top of it.

EU only
X only publishes ads served in the EU, from 26 August 2023.
Search is by advertiser
The repository has no keyword search; searchTerms filters afterwards on text, headline, landing page or targeting.
Non-deterministic answers
Under load X returns partial lists. The actor re-asks, runs an extra pass and merges by ad key.

What you decide with this data

1 · Agency pitch
Media agenciesPull the ad account and agency of each of the client's competitors.Result: who buys media for whom.
Fields: adAccountName, agencyName
2 · Competitor targeting
Paid social and growthGroup targetingByType by advertiser and country.Result: the interests and audiences each rival buys.
Fields: targetingByType, country
3 · Campaigns by UTM
Marketing analystsRead utm{} and destinationUrl from each creative.Result: the real name of each campaign and its landing page.
Fields: utm, destinationUrl

Inputs ready to copy

Examples from the README or from real runs. Paste the input into the actor's JSON tab and press Start.

TaskInput (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.

How you receive the data

Run it yourself, receive it on a schedule or commission the project.

Apify
You run the actor and download Excel, CSV or JSON, or read it through the Apify API. $0.30 per 1,000 ads on the free plan.
Channels: console, API, MCP
Recurring dataset
A weekly feed of your competitors across all fourteen libraries, in one schema.
Channels: S3, CSV, JSON
Custom project
Normalisation to your taxonomies, history and dashboards.

Plus a $0.001 start fee per run. Rows for advertisers not found are free.

X (Twitter) ad library questions

Which ads does the X Ads Library include?

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.

Can I search by keyword?

The repository only supports advertiser lookups. searchTerms keeps ads whose text, headline, landing URL or targeting match your words.

How is the agency detected?

Many ad accounts are named Brand - Agency. When that pattern is present, the actor fills agencyName and adds the flag agency_inferred.

Does the X Ads Repository have an API?

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.

How much does it cost?

$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.

Keep exploring