TikTok
TikTok search ads API
Search ads in the TikTok ad library. Call the TikTok search ads API and get JSON back in one request. 1 credit per call. Failed calls cost nothing.
POST
Search ads in the TikTok ad library
Searches ads in the TikTok ad library.
Request
This method has no required parameters.Response
If successful, the response body contains the standard envelope.data.results[] contains the ads, each with its advertiser and how many people it reached.
The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.
Optional parameters
Billing
Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.Pagination
Results are paginated. To retrieve the next page, pass the value ofdata.cursor as cursor in a subsequent request. A response that omits cursor is the last page.
Related methods
- TikTok ad details: Accepts
adUrl. Returns a TikTok ad’s details and reach.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Required string length:
1 - 200Required string length:
1 - 200European country code like de. TikTok publishes ads for these countries only. Any case is accepted.
Pattern:
^[A-Za-z]{2}$The cursor from the previous response. Send it as is.
Minimum string length:
1