SCscrapecreators
TikTok Ad Library

Ad Library Search

Changed on

Searches TikTok's public Ads Library using either query for a general search or advertiser_name for advertiser-specific results. Advertiser-name searches resolve the name through TikTok's advertiser typeahead first, then search the selected advertiser entity and return adv_biz_ids on each ad. You can pass adv_biz_ids with advertiser_name to pin the exact advertiser shown in TikTok's See all ads link. TikTok requires the name with the ID and ignores an ID-only search, so provide exactly one of query or advertiser_name. If TikTok has no matching advertiser entity, the API falls back to TikTok's name search. Results are global, sorted by the latest shown date, support cursor pagination, and include a public TikTok Ads Library URL for each ad.

get/v1/tiktok/ad-library/search

Request

  • Base URL
    https://api.scrapecreators.com
  • URL
    https://api.scrapecreators.com/v1/tiktok/ad-library/search
  • Auth
    API key in header x-api-key

Query parameters

querystring

General ad search. Provide either query or advertiser_name, not both.

advertiser_namestring

Advertiser name to resolve through TikTok's typeahead and search by advertiser entity. Falls back to TikTok's name search when no entity matches. Provide either advertiser_name or query, not both.

adv_biz_idsstring

TikTok advertiser business ID from a See all ads link. Use it with advertiser_name to pin the exact advertiser. Required companion: advertiser_name; ID-only searches return 400 because TikTok ignores the ID without the name.

cursorstring

Opaque cursor returned from the previous response.

Response

Successful response

Changes