{"stats":{"calls7d":0,"successRate":null,"avgMs":null,"reviews":0,"usefulRate":null},"id":"p/apify.tiktok-ads.library.search","kind":"provider","name":"apify_tiktok-ads_library_search","description":"Scrape the TikTok ad library by keyword. Scrape publicly running TikTok ads from TikTok's ad library by keyword or advertiser (Apify · TikTok Ads)","tags":["tiktok-ads","advertising","apify","library","search","data"],"method":"POST","path":"/v1/p/apify.tiktok-ads.library.search","url":"https://toll402.dev/v1/p/apify.tiktok-ads.library.search","specUrl":"https://toll402.dev/v1/spec/p/apify.tiktok-ads.library.search","price":"$0.00375","priceUsd":0.00375,"available":true,"inputSchema":{"type":"object","properties":{"search":{"type":"string","description":"keyword or advertiser name to search the ad library for","examples":["skincare"]},"adv_biz_ids":{"type":"string","description":"advertiser business id, to pin the search to one advertiser instead of a keyword"},"ad_id":{"type":"string","description":"fetch one specific ad"},"region":{"type":"string","description":"ISO country code or 'all' (the default). TikTok's library is a DSA transparency database, so coverage is EU/EEA/UK-centric — and per the actor's own input schema it REJECTS region=US; pass 'all' to include US ads","examples":["all"]},"query_type":{"type":"string","description":"which field `search` is matched against: '1' = advertiser name (the actor's DEFAULT), '0' = keyword. A keyword passed without query_type:'0' is matched as an advertiser name and finds nothing","examples":["1"]},"start_date":{"type":"string","description":"YYYY-MM-DD","examples":["2026-06-01"]},"end_date":{"type":"string","description":"YYYY-MM-DD"},"sort":{"type":"string"},"limit":{"type":"integer","description":"results to return; pair it with maxTotalChargeUsd","examples":[50]},"offset":{"type":"integer","examples":[0]}},"additionalProperties":true,"required":["search"],"description":"returns creative content, advertiser, dates, audience reach and targeting as TikTok discloses them in the Commercial Content Library. Community actor, not an official TikTok surface — the only route to this capability in the catalog, and the one most likely to break upstream, so check the actor's run history before relying on it"},"example":{"search":"nike","region":"all","query_type":"1","limit":1,"offset":0},"meta":{"provider":"Apify","providerSlug":"apify","providerDocs":"https://docs.apify.com/api/v2","providerPricing":"https://apify.com/pricing","providerLogo":"https://www.google.com/s2/favicons?domain=apify.com&sz=64","platform":"tiktok-ads","platformLabel":"TikTok Ads","category":"Advertising","capability":"tiktok-ads.library.search","upstreamMethod":"POST","upstreamPriceUsd":0.003,"pricing":"per_result","pricingNote":"pay-per-event: one scraped event per ad, $0.003 flat (no plan tiers), no start event. OBSERVED 2026-09-26 on the platform key: 1 ad billed chargedEventCounts {scraped: 1}, usageTotalUsd 0.003. Earlier runs (2026-07-31, 2026-08-13) returned empty datasets; the actor returns rows again","verified":"2026-09-26","docs":"https://apify.com/s-r/tiktok-ads-library","calls":0,"successRate":null,"via":"treg"}}