# Track a Competitor's TikTok Ads

**Use case:** 

Spy on your competitors' TikTok ads with the  Ad Library. Get their creatives, dates and targeting (example with Sephora)

## Input

```json
{
  "mode": "library",
  "region": "FR",
  "startDate": "2026-01-01",
  "endDate": "2026-06-02",
  "queryType": "2",
  "query": "SEPHORA",
  "advertiserBizId": "",
  "maxAds": 50,
  "fetchDetails": true,
  "topAdsKeyword": "",
  "topAdsCountryCode": [
    "FR"
  ],
  "topAdsPeriod": "7",
  "topAdsOrderBy": "like",
  "topAdsLanguage": "fr",
  "topAdsLikeRange": "",
  "topAdsMaxItems": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  }
}
```

## Output

```json
{
  "AD ID": {
    "label": "Ad ID",
    "format": "text"
  },
  "Advertiser Name": {
    "label": "Advertiser Name",
    "format": "text"
  },
  "Ad Title": {
    "label": "Ad Title",
    "format": "text"
  },
  "AD Preview": {
    "label": "Ad Preview",
    "format": "image"
  },
  "Ad Dates": {
    "label": "Ad Dates",
    "format": "array"
  },
  "Ad Audience": {
    "label": "Ad Audience",
    "format": "object"
  },
  "Ad Details": {
    "label": "Ad Details",
    "format": "array"
  },
  "Ad Media": {
    "label": "Ad Media",
    "format": "array"
  },
  "Ad Targeting": {
    "label": "Ad Targeting",
    "format": "object"
  },
  "Ad Reach": {
    "label": "Ad Reach (by country)",
    "format": "object"
  },
  "Advertiser": {
    "label": "Advertiser",
    "format": "object"
  },
  "Ad Sponsor": {
    "label": "Ad Sponsor",
    "format": "text"
  },
  "Ad Target Audience Size": {
    "label": "Target Audience Size",
    "format": "object"
  },
  "Ad Detail URL": {
    "label": "Ad Detail URL",
    "format": "link"
  }
}
```

## About this Actor

This example demonstrates how to use [TikTok Ads Scraper](https://apify.com/data_xplorer/tiktok-ads-scraper) with a specific input configuration. Visit the [Actor detail page](https://apify.com/data_xplorer/tiktok-ads-scraper) to learn more, explore other use cases, and run it yourself.