TikTok Ad Library Ad Details
One ad of TikTok's Ad Library by its id (from `tiktok_ads_library`): its advertiser, creative, landing page, the audience's size, the impressions per region and the targeting (age, gender, and, for ads TikTok shows in its `enhanced` mode, the countries, regions, cities, languages and devices, the call to action, the objective and the impressions per age and gender).
One ad of TikTok's Ad Library by its id (from tiktok_ads_library): its advertiser, creative, landing page, the audience's size, the impressions per region and the targeting (age, gender, and, for ads TikTok shows in its enhanced mode, the countries, regions, cities, languages and devices, the call to action, the objective and the impressions per age and gender). Answered as the document: search_metadata (request_url is the ad's page), search_parameters, search_information ({}) and ad. An id the Library does not have is a 404 profile_not_found, confirmed on two looks. No snapshot.
X-API-Key<token>Your API key.
cancel_token?stringA 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.
1 <= length <= 128ad_id*stringThe ad's id: id of an ad from tiktok_ads_library.
^\d{5,25}$The ad, as the document. When the answer could not be parsed, the usual envelope.
application/json- response
The ad details document.
search_metadata?search_parameters?The request as sent.
search_information?Always empty here.
ad?[key: string]?anycurl -X GET 'https://api.justserp.com/v1/tiktok/ads-library/ad-details?ad_id=1879578150853938'{ "search_metadata": { "id": "string", "status": "string", "created_at": "string", "request_url": "string" }, "search_parameters": {}, "search_information": {}, "ad": { "id": "string", "advertiser": { "id": "string", "name": "string", "registry_location": "string", "tiktok_user": "string", "sponsor": "string", "advertiser_token": "string" }, "title": "string", "format": "video", "is_unavailable": true, "first_shown_datetime": "2019-08-24T14:15:22Z", "last_shown_datetime": "2019-08-24T14:15:22Z", "video_link": "string", "cover_image": "string", "image_urls": [ "string" ], "display_mode": "standard", "external_link": "string", "call_to_action": "string", "advertising_objective": "string", "estimated_audience": "string", "estimated_audience_min": 0, "estimated_audience_max": 0, "spent": "string", "impression": 0, "rejection_info": { "reasons": [ "string" ], "affected_regions": [ "string" ], "reporting_source": "string", "automated_notice": "string", "hit_illegal_content_reason": 0 }, "targeting": { "location": { "total_region": 0, "total_impressions": "string", "impressions_by_region": [ { "region": "string", "impressions": "string", "breakdowns": [ { "age": "string", "gender": "string", "impressions": "string" } ] } ] }, "age": [ { "region": "string", "property1": true, "property2": true } ], "gender": [ { "region": "string", "female": true, "male": true, "unknown": true } ], "target_audience_size": "string", "target_audience_size_min": 0, "target_audience_size_max": 0, "audience_list": "string", "interest": "string", "video_interactions": "string", "creator_interactions": "string", "countries": [ "string" ], "provinces": [ "string" ], "cities": [ "string" ], "languages": [ "string" ], "device_models": [ "string" ], "operating_systems": [ "string" ], "is_high_spending_power": true, "has_excluded_audience": true } }}TikTok Ad Library GET
The ads in TikTok's Ad Library (library.tiktok.com) for a keyword or for one advertiser, 12 to a page, with their dates, creative, estimated audience and, for an ad TikTok has taken down, its rejection notice.
TikTok Ad Library Advertiser Search GET
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.