TikTok Ad Library & Creative Scraper - Spy on Competitor Ads

targetUrl can identify the source directly. For parameter searches, choose scrapeMode and a compatible country. Ad Library and Creative Center have different geography and filter coverage. Start with a small maxResults.

{
  "targetUrl": "https://library.tiktok.com/ads?query=nike&region=DE",
  "maxResults": 10
}

• The returned fields depend on the selected source and quickSearch setting.
• Reach, targeting, and performance fields can be estimates or source-specific labels. Preserve their context instead of treating them as verified sales.

{
  "adId": "12345678",
  "advertiserName": "Nike",
  "advertiserBusinessId": "987654321",
  "advertiserLocation": "US",
  "videoUrl": "https://v16m.tiktokcdn.com/...",
  "videoUrlHd": "https://v16m.tiktokcdn.com/...",
  "coverImageUrl": "https://p16-sign.tiktokcdn.com/...",
  "adCopy": "Just Do It. Shop the latest Nike collection.",
  "firstShownDate": "2025-01-15",
  "lastShownDate": "2025-03-20",
  "status": "active",
  "estimatedAudience": "500K-1M",
  "estimatedAudienceMin": 500000,
  "estimatedAudienceMax": 1000000,
  "reachByCountry": {
    "DE": 250000,
    "FR": 150000,
    "IT": 100000
  },
  "targetGender": [
    "FEMALE",
    "MALE"
  ],
  "targetAgeRange": [
    "18-24",
    "25-34"
  ],
  "targetCountries": [
    "DE",
    "FR",
    "IT"
  ],
  "targetInterests": [
    "Sports",
    "Fashion"
  ],
  "likes": 15000,
  "ctr": 2.5,
  "viewRate2s": 45.2,
  "viewRate6s": 28.7,
  "industry": "Apparel & Accessories",
  "campaignObjective": "Traffic",
  "adFormat": "Single Video",
  "source": "ad_library",
  "sourceUrl": "https://library.tiktok.com/ads?id=12345678",
  "scrapeDate": "2025-03-28T10:00:00.000Z"
}

Fields in the documented output view

Output views select columns. They do not necessarily filter record types or exhaust the full JSON payload. Use structured JSON when you need nested arrays or objects.

These are the active public event prices checked on 2026-10-29, in USD. They describe each event, not a universal flat price for a run. Confirm your current Apify plan and run budget before starting.

A result limit and a spending cap are different controls. Account charges, applicable taxes, and separately billed providers or proxies must be considered where relevant. A cap setting is not a minimum invoice charge.

Test a small run in Apify Console, inspect its records and charges, then save a task or call the actor from your own application. Keep your Apify token in an environment variable. Source-specific credentials, if required, are separate from the Apify API token.

# Save the input example as input.json and set APIFY_TOKEN.
# This request starts an asynchronous, potentially billable run.
curl --request POST \
  'https://api.apify.com/v2/acts/whoareyouanas~tiktok-ad-scraper/runs' \
  --header "Authorization: Bearer $APIFY_TOKEN" \
  --header 'Content-Type: application/json' \
  --data @input.json

The response identifies the run. Wait for it to finish, inspect its status, and use its default dataset and key-value store to retrieve results. A successful run can still contain partial or failed records; check the output contract above before continuing downstream.