# Temu Ad Library Scraper: EU Ads, Payers & Impressions (`rastriq/temu-ad-library-scraper`) Actor

Extract ads from Temu's EU Advertising Library (DSA Art. 39): advertiser, payer, product, impressions and delivery dates per EU country. No API key needed.

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

## Pricing

from $0.90 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## Temu Ad Library Scraper

**Temu Ad Library Scraper** extracts ads from Temu's EU Advertising Library, the public ad repository Temu must publish under **Article 39 of the EU Digital Services Act (DSA)**. Search by product, advertiser or payer in any EU country and get structured data: advertiser, payer, product, impressions, delivery dates and creative images. You don't need an API key or a Temu account.

### 🔍 What is Temu Ad Library Scraper?

Temu runs one of the largest advertising programs in Europe. Since the DSA came into force, every ad it shows in the EU is listed in its public Advertising Library. The library is built for manual browsing, though, and has no export.

Temu Ad Library Scraper turns that library into a clean dataset you can use for:

- 📊 **Competitive intelligence**: see which products and categories Temu pushes in each country.
- 🛒 **Marketplace monitoring**: track when ads for a brand or product start and stop.
- 🧾 **DSA / compliance research**: audit advertiser and payer disclosures at scale.
- 📈 **Market sizing**: compare impression ranges across countries and categories.

### 📦 What data does Temu Ad Library Scraper extract?

| Field | Description |
|-------|-------------|
| 🆔 `adId` | Durable ad identifier on Temu |
| 🏷️ `advertiser` | Advertiser on whose behalf the ad was shown |
| 💳 `adPayer` | Entity that paid for the ad |
| 📅 `firstShownDate` / `lastShownDate` | Delivery period (`YYYY-MM-DD`) |
| 👁️ `impressions` | Impressions as published by Temu |
| 🌍 `searchCountry`, `regionId`, `regionName` | Country searched and region reported |
| 📦 `adName` | Advertised product |
| 🖼️ `imageUrl` | Ad thumbnail |
| 🔗 `productUrl` | Product page on Temu |
| 🏛️ `adStatus`, `adPolicy`, `hitGovernanceLabel` | Status and governance information as published |
| 🛡️ `is_natural_person_suspected` | `true` if the advertiser or payer looks like a private individual or sole proprietor |
| 🕒 `scrapedAt`, `source`, `sourceUrl` | Extraction metadata |

Field names are shared with our other DSA ad library scrapers (Snapchat, Pinterest, Zalando, AliExpress), so you can merge their datasets directly.

### 🚀 How to use Temu Ad Library Scraper

1. Open **Temu Ad Library Scraper** in Apify Console and click **Try for free**.
2. Pick an EU **country** (e.g. `DE`, `ES`, `FR`).
3. Optionally enter a **keyword** and choose whether it matches the product, the advertiser or the payer.
4. Optionally set a **date range** and **max ads**.
5. Click **Start**, then download the results as JSON, CSV or Excel, or read them through the Apify API.

### ⚙️ Input parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `country` | string | `DE` | EU country code (ISO 3166-1 alpha-2) |
| `keyword` | string | all ads | Search text |
| `keywordType` | string | `product` | `product`, `advertiser` or `payer` |
| `startDate` / `endDate` | string | all dates | Keep ads whose delivery period overlaps this range (`YYYY-MM-DD`) |
| `maxResults` | integer | 200 | Maximum number of ads |
| `proxyConfiguration` | object | none | Optional. Not needed; add your own proxy URLs only if you want to |

#### Example input

```json
{
  "country": "DE",
  "keyword": "headphones",
  "keywordType": "product",
  "maxResults": 100
}
```

### 📄 Output example

```json
{
  "adId": "300000086713053874",
  "advertiser": "Example Trading Co., Ltd",
  "adPayer": "Example Trading Co., Ltd",
  "firstShownDate": "2026-10-04",
  "lastShownDate": "2026-10-13",
  "impressions": 2,
  "searchCountry": "DE",
  "sourceUrl": "https://ads.temu.com/library/search-result.html",
  "scrapedAt": "2026-11-12T22:40:00Z",
  "source": "temu_ad_library",
  "is_natural_person_suspected": false,
  "adName": "Retro guitar birthday card with envelope",
  "adStatus": "0",
  "regionId": 76,
  "regionName": "Germany",
  "imageUrl": "https://img.kwcdn.com/product/....jpg",
  "productUrl": "https://www.temu.com/goods.html?goods_id=...",
  "adPolicy": null,
  "hitGovernanceLabel": false
}
```

### 🛡️ How it works and limitations

- Temu Ad Library Scraper opens the library in a real browser session, runs your search in the library itself and reads the results the page loads, 48 ads per page, until it reaches `maxResults`.
- No proxy is needed. If Temu ever rejects the session, the scraper automatically retries once through a built-in residential proxy.
- The date range is applied by the scraper, which keeps ads whose delivery period overlaps it. A range with few matches can mean reading many pages; the run stops when the library has no more pages.
- In testing, the library stopped loading new pages after roughly 1,150 ads for a single search. For larger extractions, split the work into narrower searches (keyword, advertiser or country).
- Some ads are published with an empty advertiser and payer. Those fields are then empty in the output too.
- The library does not expose product categories in its results, so there is no category filter.

### 💰 How much does it cost to scrape the Temu Ad Library?

Temu Ad Library Scraper uses **pay-per-event** pricing, so you only pay for the ads you get:

| Event | Price |
|-------|-------|
| Actor start (per GB of memory; the default 2 GB = 2 events) | $0.0005 |
| Each ad record in the dataset | $0.0009 |

That works out to roughly **$0.90 per 1,000 ads**, platform compute included. A 100-ad run takes about 40 seconds. Use **Max ads** to cap what a run can cost.

### 🔗 Related Actors

- [Snapchat Ad Library Scraper](https://apify.com/rastriq/snapchat-ad-library-scraper)
- [Pinterest Ad Library Scraper](https://apify.com/rastriq/pinterest-ad-library-scraper)
- [AliExpress Ad Repository Scraper](https://apify.com/rastriq/aliexpress-ad-repository-scraper)
- [Zalando Ads Repository Scraper](https://apify.com/rastriq/zalando-ads-repository-scraper)
- [TikTok Ad Library Scraper](https://apify.com/rastriq/tiktok-ad-library-scraper)
- [Facebook Ad Library Scraper](https://apify.com/rastriq/fb-adlibrary-scraper)
- [Google Ads Transparency Center Scraper](https://apify.com/rastriq/google-ads-scraper)

### ❓ FAQ

**Is it legal to scrape the Temu Ad Library?**
The library is public by law under DSA Article 39 and is meant to be inspected by researchers and the public. Temu Ad Library Scraper only reads publicly available ad records. You are still responsible for following Temu's terms of use and applicable law in your use case.

**Does the output contain personal data?**
Many Temu advertisers are small sellers, and some are individuals or sole proprietors. Temu Ad Library Scraper flags them with `is_natural_person_suspected: true`. This is a heuristic, so treat flagged records as personal data under GDPR: minimise them and do not republish them.

**Can I monitor ads over time?**
Yes. Schedule Temu Ad Library Scraper in Apify and deduplicate the results on `adId`.

# Actor input Schema

## `country` (type: `string`):

EU country whose ads are searched.

## `startDate` (type: `string`):

Only return ads whose delivery period overlaps the date range starting on this date. Leave empty for no lower bound.

## `endDate` (type: `string`):

End of the date range. Leave empty for no upper bound.

## `keyword` (type: `string`):

Search keyword: a product, advertiser or payer name (see <b>Keyword type</b>). Leave empty for all ads.

## `keywordType` (type: `string`):

What the keyword matches against.

## `maxResults` (type: `integer`):

Maximum number of ads to extract. Use it to cap the cost of a run.

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

<b>Optional.</b> Not needed: the scraper works without a proxy and automatically falls back to a built-in residential proxy if Temu rejects the session. Add your own proxy URLs only if you want to use them.

## Actor input object example

```json
{
  "country": "DE",
  "keywordType": "product",
  "maxResults": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset containing all scraped ads.

# 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 = {
    "country": "DE",
    "maxResults": 50,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/temu-ad-library-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 = {
    "country": "DE",
    "maxResults": 50,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("rastriq/temu-ad-library-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 '{
  "country": "DE",
  "maxResults": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call rastriq/temu-ad-library-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rastriq/temu-ad-library-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/HrZWmKNEvkzIs5Po0/builds/LCNbtWJRqobdr6ofZ/openapi.json
