tiktok

Adlibrary › Ad

Returns one TikTok Ad Library ad: creative video, title, advertiser account, landing page, brand name, and first-shown date.

Use it when you already have an ad id or library URL; use adlibrary/search to find ads by keyword or advertiser name first.

50 credits per call.

get/v1/tiktok/adlibrary/ad

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/tiktok/adlibrary/ad
  • Auth: API key in header x-api-key

Query parameters

ad_idstring
Example:1869335220395266

TikTok Ad Library ad id, or a library.tiktok.com ads/detail URL. Provide at least one of: ad_id, url.

urlstring

TikTok Ad Library ads/detail URL. Provide at least one of: ad_id, url.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.