# Competitor ads on X (Twitter).

Canonical URL: https://www.rastriq.es/en/competitor-ad-tracking/x-ads/ · Spanish version: https://www.rastriq.es/seguimiento-publicidad-competencia/x-ads/

> X (Twitter) Ads Repository as data: every ad served in the EU with impressions, reach, targeting, agency, creative, landing page and UTM tags. By API or CSV.

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 it publishes → Inputs ready to copy

WHAT IT PUBLISHES

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

| 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](https://apify.com/rastriq/x-ads-repository-scraper?utm_source=rastriq.es&utm_medium=web&utm_campaign=en-competitor-ad-tracking-x-ads)

REAL SAMPLE

## A real record

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.

[Download the sample (JSON)](https://www.rastriq.es/muestras/anuncios-x.json) [CSV](https://www.rastriq.es/muestras/anuncios-x.csv)

LIMITS

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

USE CASES

## 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`

RECIPES

## Inputs ready to copy

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

DELIVERY

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

[Data normalisation](https://www.rastriq.es/en/data-normalization/)

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

FAQ

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

RELATED PAGES

## Keep exploring

[Competitor ad tracking All fourteen libraries compared.](https://www.rastriq.es/en/competitor-ad-tracking/) [Ad libraries Sources, fields and countries.](https://www.rastriq.es/en/ad-libraries/) [Meta (Facebook, Instagram) Copy, landing page, format, platforms and dates in 40 countries.](https://www.rastriq.es/en/competitor-ad-tracking/meta-ads/) [Google Ads Verified advertiser, format, dates and days running in 38 countries.](https://www.rastriq.es/en/competitor-ad-tracking/google-ads/) [TikTok Ad Library (33 countries) and Top Ads with CTR and likes.](https://www.rastriq.es/en/competitor-ad-tracking/tiktok-ads/) [LinkedIn Who paid, impressions by country and B2B targeting.](https://www.rastriq.es/en/competitor-ad-tracking/linkedin-ads/)
