tiktok-ad-library/
ad

The TikTok Ad Library Ad API resolves one known public TikTok ad URL into normalized creative, advertiser, delivery, destination, impression, media, publication, and collection fields.

TikTok Ad Library Ad API

Single URL
One ad maximum
Canonical ad record
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

TikTok Ad Library Ad

TikTok Ad Library Ad resolves one known public advertising record after search or manual review has produced a qualifying URL. It derives one upstream identifier and returns at most one normalized ad; it does not search an advertiser, enumerate campaigns, or expose private Ads Manager performance data.

TikTok Ad Library Ad API Features

  • Known-ad URL inputSubmit one official TikTok http or https URL whose path contains /ad.
  • Identifier derivationPrefer the first id query value, then ad_id, then the rightmost numeric path segment; otherwise the provider receives the URL fallback.
  • Single-object detailRequest one upstream detail object and emit at most one record only when a supported ad identity is present.
  • Canonical ad fieldsReceive stable advertiser, copy, date, country, platform, format, destination, impression, media, publication, and collection fields.
  • Nullable source fidelityKeep unavailable values null because Commercial Content Library and Creative Center records can expose different fields.

TikTok Ad Library Ad API Parameters

ParametersRequiredDescription
urlRequiredRequired single official TikTok http or https URL whose path contains /ad. Prefer a usable id or ad_id query value, or a numeric path segment.

How to Use the TikTok Ad Library Ad API

Submit a known public ad URL to the TikTok Ad Library Ad API, poll the asynchronous task, and process the single result when available.

  1. Choose an official TikTok ad URL with an id, ad_id, or numeric path identifier when possible.
  2. POST url to /v1/tiktok-ad-library/ad and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task reaches a terminal status.
  4. On success, read data.results.items; the detail operation returns zero or one item.
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; the detail operation returns at most one item

TikTok Ad Library Ad API Use Cases

  • Selected-ad inspection: Resolve one ad selected from a search result into the normalized detail fields the TikTok Ad Library Ad API currently has available.
  • Creative review: Inspect public creative text, advertiser identity, format, media, and destination for a known ad.
  • Transparency archive: Preserve one public record with source URL, shown dates, delivery context, and collection time.
  • Cross-library comparison: Compare supported public metadata across selected ad records without treating it as campaign performance.

TikTok Ad Library Ad API Pro Tips

  • Prefer URLs with an explicit numeric id or ad_id query value to avoid provider-dependent fallback behavior.
  • A valid URL does not guarantee that the upstream source still exposes an identifiable ad object.
  • Treat Ads Library and Creative Center fields as source-specific rather than directly interchangeable.
  • Archive media or landing-page references only under appropriate terms because URLs can expire or redirect.
  • Do not infer targeting, spend, conversions, or performance from public shown dates or impressions.
  • Use the search endpoint when you need discovery; the TikTok Ad Library Ad API never enumerates an advertiser's ads.

Beyond the TikTok Ad Library Ad API, use these APIs when you need a different type of public TikTok Ad Library data.

  • TikTok Ad Library Search API — Search supported public TikTok advertising records by one advertiser name or keyword with a page-aligned result limit.

Explore other platforms

Combine TikTok Ad Library data with public data from other supported social platforms.

TikTok Ad Library Ad API — FAQ

TikTok Ad Library Ad API is a programmatic interface for resolving one known public TikTok ad URL into at most one normalized ad detail record with supported advertiser, creative, delivery, destination, impression, media, and time fields.

Submit one official TikTok http or https URL whose path contains /ad. The page console rejects lookalike hosts before submission.

The adapter takes the first non-empty id value, otherwise ad_id, otherwise the rightmost fully numeric path segment. If none exists, it passes the URL as a provider-dependent fallback.

No. The endpoint accepts one URL, returns at most one ad, does not paginate, and has no results_limit.

Public Ads Library and Creative Center records expose different fields, and source records can omit advertiser, dates, countries, format, destination, impressions, or media.

No. It does not provide Ads Manager bids, budgets, conversions, attribution, private targeting, or complete campaign configuration.

The TikTok Ad Library Ad API charges 0.5 SocQ credits for a returned ad record, with no base charge. The estimate is one result and an empty result has no result charge.