TikTok Ads Library Scraper

Search public TikTok Commercial Content Library ads using ScrapeCreators. No user cookies or TikTok login are required. Search by keyword or resolve an advertiser name, then follow provider cursors for more results.

Input

{"searchMode":"keyword","query":"coffee","maxResults":10,"includeDetails":true}

For an advertiser search, set searchMode to advertiser and put its name in query, for example Gymshark. An optional advertiserBusinessId pins the exact entity; it requires advertiser mode and the matching name. Maximum results: 1–100. Verified free-plan runs deliver at most five ads.

The provider search endpoint does not expose country or date filters. Coverage and matching follow TikTok and ScrapeCreators. This Actor searches the public Commercial Content Library, not Creative Center Top Ads.

Output

One unique ad per dataset item: ad ID, advertiser, advertiser business ID when resolved, first/last shown dates, published audience range, caption/category from search when present, public ad URL, and provider-supplied media URLs. Detail enrichment adds objective, landing page and country codes when available. Missing fields are null or empty arrays. No exact spend, conversion, performance, payer, or registered-location claims are made. Media URLs can expire.

OUTPUT contains status, delivered count, warnings, stop reason, provider request count, and provider credits charged. Invalid records are skipped. Detail failures preserve valid search records with warnings. Provider errors remain explicit; no fake empty success or fabricated ads.

Bounded cost and pricing

A search page costs one ScrapeCreators credit; each requested detail costs one more. At most 10 search pages and 110 total API calls are allowed. Work stops before the runtime deadline or the result/charge limit. Provider credentials are owner-managed, never public input.

Live Pay per event uses automatic start and dataset-item events. Platform usage pass-through is disabled.

Event	FREE	BRONZE	SILVER	GOLD
Actor start	$0.010000	$0.009750	$0.009500	$0.008000
Ad record	$0.005000	$0.004875	$0.004750	$0.004000

Discounts: 0%, 2.5%, 5%, 20%. A FREE-tier one-ad run is $0.015; ten ads are $0.060. The owner pays ScrapeCreators separately; its invoice cost is distinct from Apify usage. Requests are not retried automatically, limiting provider spend.

Local development

Run npm ci, npm test, and apify run from this directory. Set SCRAPECREATORS_API_KEY through a private environment/secret, without logging it. The Actor uses HTTP and needs no browser.

Provider docs: https://docs.scrapecreators.com/v1/tiktok/ad-library/search/