# Apple App Store Ad Repository Scraper — Apple Ads Library (DSA) (`rastriq/apple-ad-repository-scraper`) Actor

Scrape Apple's App Store Ad Repository (EU, DSA): app and developer, seller legal name, country, placement, format, first/last impression, audience refinement, creatives, language variations and advertising restrictions.

- **URL**: https://apify.com/rastriq/apple-ad-repository-scraper.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** Developer tools
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Apple App Store Ad Repository Scraper — Apple Ads Library (DSA)

**Apple App Store Ad Repository Scraper** extracts App Store ads from Apple's official [Ad Repository](https://adrepository.apple.com/), the EU ad library Apple publishes under the Digital Services Act: app, developer, seller legal name, country, placement (Search results, Today tab, Search tab, product page), format, first and last impression, audience refinement, screenshots and videos, language variations and Apple's advertising restrictions. Use it as an Apple Search Ads library API for app-marketing intelligence and DSA research.

### 🔎 What is Apple App Store Ad Repository Scraper?

Apple's website shows one app or developer at a time. **Apple App Store Ad Repository Scraper** turns the repository into structured data:

- 🏢 **By developer or app** — `Temu`, `Spotify AB` or App Store ids, matched as whole words
- 🔭 **Discovery** — every developer whose name contains a text (`bank`, `games`, `vpn`)
- 🌍 **Whole countries** — every App Store ad shown in Spain, France or any of the 25 EU countries
- 📄 **Complete results** — every query is paginated to its last page, matching Apple's reported total
- 🎨 **Creatives** — screenshots, videos and icon; optionally every language and device variation
- 🚫 **Restrictions** — ads removed and accounts suspended by Apple, with reason, basis and countries
- ✅ **Data quality** — `quality_flags`, DSA art. 39 coverage and natural-person flags

Typical uses: tracking which competitors buy Apple Search Ads and in which countries, App Store creative benchmarking, mapping advertisers of a category, and research on App Store advertising and moderation.

### 📦 What data does Apple App Store Ad Repository Scraper extract?

Every row has the common block shared by all Rastriq ad-library scrapers plus **every field Apple publishes, with Apple's original names**.

| Group | Fields |
|---|---|
| 🆔 Identity | `platform`, `ad_id`, `recordType`, `source_url`, `scraped_at` (+ `adId`, `appId`, `developerId`) |
| 🏢 Advertiser | `advertiser` (developer), `payer` (seller legal name) (+ `developerName`, `legalName`, `appName`) |
| 📍 Placement | `countries` (+ `countryOrRegion`, `placement`, `format`, `subFormat`) |
| 📅 Period | `first_shown`, `last_shown` (+ `firstImpressionDate`, `lastImpressionDate`, `data_start_date`, `data_end_date`) |
| 🎯 Targeting | `targeting_types` (age, gender, location, customer_type) (+ `audienceRefinement`) |
| 🎨 Creative | `creative_urls`, `app_store_url` (+ `adBanner`, `adAssets`, `appIconVariations`, `adLocaleVariations`) |
| 🚫 Restrictions | `actionDate`, `actionTaken`, `reason`, `basis`, `details`, `affectedPlacements` |
| ✅ Quality | `quality_flags[]`, `art39_coverage`, `is_natural_person_suspected`, `variations_status` |

#### 📄 Flat table or nested JSON

By default every row is a **flat table** — one value per column, ready for Excel, Google Sheets or CSV: lists become comma-separated text (URLs are separated by `|`), reach per country becomes `reach_min_<CC>` / `reach_max_<CC>` columns, and the DSA art. 39 score becomes `art39_covered`, `art39_total`, `art39_ratio` and `art39_missing`. Set **Output format** to *Nested JSON* to keep the source's original objects and lists for programmatic use.

### 🚀 How to use Apple App Store Ad Repository Scraper

1. Open **Apple App Store Ad Repository Scraper** in Apify Console and click **Try for free**.
2. Add **Developers** or **Apps** (names or ids), or **Discovery prefixes**.
3. Pick the **Countries** and the **Period** (90 days, 180 days or 1 year).
4. Set **Max ads** (100 for a first test) and click **Start**.
5. Export the results as JSON, CSV or Excel, or get them through the API.

### ⚙️ Input parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `developers` / `apps` | array | — | Names (whole-word match) or App Store ids |
| `countries` | array | all 25 | ISO codes of EU countries with App Store ads |
| `datePreset` | string | `LAST_90_DAYS` | `LAST_90_DAYS`, `LAST_180_DAYS`, `LAST_YEAR` |
| `maxItems` | integer | `1000` | Max ads in the run (0 = no limit) |
| `discoveryPrefixes` | array | — | Scrape every developer whose name contains these texts |
| `browseCountries` | boolean | `false` | Every ad of the selected countries |
| `nameMatch` | string | `word` | `word`, `contains`, `exact`, `any` |
| `fetchVariations` | boolean | `false` | Language and device variations of each ad |
| `restrictions` | string | `none` | `none`, `removed`, `suspended`, `both` |
| `hashPersonalNames` | boolean | `false` | Pseudonymise names flagged as private individuals |
| `outputFormat` | string | `flat` | `flat` (one column per value) or `nested` (original JSON structure) |

```json
{
  "developers": ["Temu", "Spotify AB"],
  "countries": ["ES", "FR", "DE"],
  "datePreset": "LAST_YEAR",
  "restrictions": "removed",
  "maxItems": 2000
}
```

### 📤 Output example

One row of the default flat output (selected columns):

```json
{
  "platform": "apple",
  "recordType": "ad",
  "ad_id": "08f69688638bb799eee84bdc6e8082ec",
  "advertiser": "Temu",
  "payer": "Whaleco Inc.",
  "first_shown": "2026-11-04",
  "last_shown": "2026-11-06",
  "countries": "ES",
  "targeting_types": null,
  "creative_urls": "https://is5-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/15/31/ba/1531ba75-82f0-0bcb-751d-cf5af0f0d90f/5…",
  "destination_url": "https://apps.apple.com/app/id1641486558",
  "appName": "Temu: Compra como millonario",
  "placement": "APPSTORE_SEARCH_RESULTS",
  "format": "Icon + Asset Ad",
  "audienceRefinement_ageTarget": false,
  "adBanner_primaryCategory": "Shopping",
  "adAssets_count": 3,
  "variations_status": "ok",
  "variation_languages": "ca, en-GB, en-US, es-ES",
  "variation_count": 4,
  "quality_flags": "no_reach_disclosed, payer_is_seller_legal_name, payer_differs_from_advertiser, no_audience_refinement, poss…",
  "art39_ratio": 0.714,
  "art39_missing": "recipients_total, recipients_by_country",
  "scraped_at": "2026-11-11T17:50:30Z"
}
```

…plus every other `audienceRefinement_*` and `adBanner_*` column and every field Apple publishes. Restriction rows (`recordType: restriction`) have `actionDate`, `actionTaken`, `reason`, `basis`, `details` and `affectedPlacements` as text.

Good to know: Apple does not publish impressions or reach (`no_reach_disclosed`). The **payer** is the seller's legal name on the App Store (`payer_is_seller_legal_name`), which can differ from the developer name. Apple's data is delayed by 7 days.

### 💰 How much does it cost to scrape the Apple Ad Repository?

Apple App Store Ad Repository Scraper uses pay-per-event pricing with volume discounts by Apify plan. You pay per ad delivered; variations and restrictions are separate events.

| Apify plan | Per 1,000 ads | Per 1,000 ads with variations (extra) | Per restriction | Run start |
|---|---|---|---|---|
| Free | $0.40 | $3.00 | $0.002 | $0.002 |
| Starter (Bronze) | $0.35 | $2.50 | $0.002 | $0.002 |
| Scale (Silver) | $0.30 | $2.00 | $0.0015 | $0.0015 |
| Business (Gold) | $0.25 | $1.75 | $0.001 | $0.001 |

- **Free plan ($5 credit)**: ~12,000 ads
- **Speed**: ~1,500 ads per minute without variations (100 per request); variations take ~10 s per ad

> 💡 **Tip**: start with one developer and one country, then widen.

### 🔗 Related Actors

Build a cross-platform view of competitor advertising with the Rastriq ad intelligence suite:

- [Google Ads Transparency Center Scraper](https://apify.com/Rastriq/google-ads-scraper) — Search, YouTube and Display ads
- [Facebook Ad Library Scraper](https://apify.com/Rastriq/fb-adlibrary-scraper) — Meta ads (Facebook & Instagram)
- [TikTok Ad Library Scraper](https://apify.com/Rastriq/tiktok-ad-library-scraper) — TikTok ads, targeting and reach
- [LinkedIn Ad Library Scraper](https://apify.com/Rastriq/linkedin-ad-library-scraper) — B2B ads on LinkedIn
- [X (Twitter) Ads Library Scraper](https://apify.com/Rastriq/x-ads-repository-scraper) — X ads in the EU

All of them share the same base fields (`platform`, `ad_id`, `advertiser`, `payer`, `first_shown`, `countries`…), so their datasets stack in one table.

### ❓ FAQ

**Which ads are included?** Apple-delivered App Store ads shown in the 25 EU countries where Apple offers them, which is what Apple publishes under the DSA. Periods are Apple's: last 90 days, 180 days or year, with a 7-day delay.

**Do I get every ad, or only the first pages?** Every query is paginated to the last page, and the run summary (`OUTPUT`) compares the ads collected with the total Apple reports. Browsing a whole country is possible but large: Spain alone has about 130,000 ads in 90 days.

**Why is there no impressions or reach data?** Apple does not publish it in the Ad Repository. The rows say so with `no_reach_disclosed`.

**What are restriction rows?** Apple's DSA moderation decisions (ads removed, accounts suspended) with reason, basis, details, placements and countries. Apple publishes them without an ad id, so each row gets a stable id derived from its content.

**Does it collect personal data?** Some developers are private individuals. Apple App Store Ad Repository Scraper flags those rows with `is_natural_person_suspected` and can pseudonymise the names (`hashPersonalNames`). You are responsible for processing the data lawfully (GDPR).

**Is it legal to scrape the Apple Ad Repository?** The Actor uses Apple's public, documented Ad Repository API at a moderate rate. You are responsible for complying with Apple's terms and applicable laws in how you use the data.

**Something broke?** Open an issue in the Actor's **Issues** tab — we usually reply within 24 hours.

# Changelog

This Actor's version history is a separate document: https://apify.com/rastriq/apple-ad-repository-scraper/changelog.md

# Actor input Schema

## `developers` (type: `array`):

Developer names as shown on the App Store, or developer ids (the number after <code>/developer/…/id</code>). Names are matched as whole words (<code>Temu</code> → <i>Temu</i>, not <i>Temurbek Rakhimov</i>).

## `apps` (type: `array`):

App names or App Store app ids (the number in <code>apps.apple.com/app/id\<id></code>).

## `countries` (type: `array`):

EU countries where Apple delivers App Store ads. Empty = all 25.

## `datePreset` (type: `string`):

Apple only offers these periods. Data is delayed by 7 days.

## `maxItems` (type: `integer`):

Maximum ads in the dataset for the whole run. 0 = no limit.

## `discoveryPrefixes` (type: `array`):

Texts of 2+ characters. Every developer in the repository whose name contains one of them is scraped (e.g. <code>bank</code>, <code>games</code>). Each prefix can return hundreds of developers — combine with <b>Max ads</b>.

## `browseCountries` (type: `boolean`):

Also list <b>every</b> ad of the selected countries, without a developer (Spain alone has ~130,000 ads in 90 days). Combine with <b>Max ads</b>.

## `nameMatch` (type: `string`):

How names in <b>Developers</b>/<b>Apps</b> are matched against the repository.

## `outputFormat` (type: `string`):

<b>Flat</b> (default): every value in its own column — lists become comma-separated text, reach per country becomes <code>reach_min_DE</code> / <code>reach_max_DE</code> columns, and art. 39 coverage becomes <code>art39_ratio</code> / <code>art39_missing</code>.<br><br><b>Nested</b>: keeps the source's original objects and lists (e.g. the full per-language variations or per-country breakdown) for programmatic use.

## `fetchVariations` (type: `boolean`):

Add every language and device variation of each ad (texts and screenshots per locale). One extra request per ad (~10 s each). Charged per ad with variations.

## `maxVariations` (type: `integer`):

0 = all.

## `restrictions` (type: `string`):

Add Apple's DSA moderation decisions of the period (action, reason, basis, details, placements, countries) as rows with <code>recordType: restriction</code>.

## `hashPersonalNames` (type: `boolean`):

Some developers are private individuals. Rows are always flagged <code>is_natural_person_suspected</code>; turn this on to replace those names with a stable SHA-256 pseudonym.

## `proxyConfiguration` (type: `object`):

Not needed normally.

## `intervalSec` (type: `integer`):

Apple answers 429 to faster bursts.

## `maxRetries` (type: `integer`):

Retries after 429/5xx with exponential backoff.

## Actor input object example

```json
{
  "developers": [
    "Temu"
  ],
  "countries": [
    "ES"
  ],
  "datePreset": "LAST_90_DAYS",
  "maxItems": 100,
  "browseCountries": false,
  "nameMatch": "word",
  "outputFormat": "flat",
  "fetchVariations": false,
  "maxVariations": 0,
  "restrictions": "none",
  "hashPersonalNames": false,
  "intervalSec": 4,
  "maxRetries": 5
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `creatives` (type: `string`):

No description

## `restrictions` (type: `string`):

No description

## `compliance` (type: `string`):

No description

## `allFields` (type: `string`):

No description

## `runSummary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "developers": [
        "Temu"
    ],
    "countries": [
        "ES"
    ],
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/apple-ad-repository-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "developers": ["Temu"],
    "countries": ["ES"],
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("rastriq/apple-ad-repository-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "developers": [
    "Temu"
  ],
  "countries": [
    "ES"
  ],
  "maxItems": 100
}' |
apify call rastriq/apple-ad-repository-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rastriq/apple-ad-repository-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/S3ENjiaXKLqVZldhD/builds/0CkHum0VLol5tbn3O/openapi.json
