Make a request
Send the page’s URL to scrape with ajson format that names the parser. Get an API key in the Quickstart.
Read the response
The parser’s data is indata.json. Its fields include adId, adUrl, advertiserName, headline, firstShownAt and lastShownAt. This sample is cut to the first items.
Options
Send options in theoptions object of the json format.
Price
$1 per 1,000 calls. See Pricing.Limits and errors
- The URL must be a TikTok Ad Library search page with an adv_name keyword or advertiser, or an ad page. Any other URL fails with
invalidRequest. - To read the next page, send the
cursorfrom the response as thecursoroption. Paging needs an API key. - The answer comes back in
data.json. If the page cannot be read, the call fails with an error code from Errors.
Related
- Pre-built parsers lists every parser.
- Scrape has the options every scrape takes.
- TikTok video
- TikTok comments
- TikTok transcript