JustSERPDocs
TikTok

TikTok Ad Library Advertiser Search

Advertisers and keywords that match a word in TikTok's Ad Library (the suggestions its search box gives): up to ten advertisers, each with its id and an `advertiser_token` that `tiktok_ads_library` takes, and the related keywords.

GET
/v1/tiktok/ads-library/advertiser-search

Advertisers and keywords that match a word in TikTok's Ad Library (the suggestions its search box gives): up to ten advertisers, each with its id and an advertiser_token that tiktok_ads_library takes, and the related keywords. Answered as the document: search_metadata, search_parameters, search_information ({}), advertisers and keyword_results. A word nothing matches is a 200 with both lists empty. No snapshot.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
q*string

The word to search advertisers for.

Length1 <= length <= 200

Response Body

The advertisers and keywords, as the document. When the answer could not be parsed, the usual envelope.

application/json
  1. response

The advertiser search document.

search_metadata?
search_parameters?

The request as sent.

search_information?

Always empty here.

advertisers?array<>
keyword_results?array<string>
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/tiktok/ads-library/advertiser-search?q=nike'
Example Response
{  "search_metadata": {    "id": "string",    "status": "string",    "created_at": "string",    "request_url": "string"  },  "search_parameters": {},  "search_information": {},  "advertisers": [    {      "name": "string",      "id": "string",      "advertiser_token": "string"    }  ],  "keyword_results": [    "string"  ]}