tiktok-ad-library/
search

The TikTok Ad Library Search API discovers supported public TikTok advertising records with one advertiser-name or keyword query, then collects normalized identities, shown dates, audience signals, and media references when available.

TikTok Ad Library Search API

Advertiser or keyword
12-record pages
Public ad discovery
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 Search

TikTok Ad Library Search sends one advertiser-name or keyword query to the public Ads Library and follows its opaque cursor until the requested page-aligned limit or an upstream stopping condition is reached. It supports transparency research and ad discovery, not private campaign management or performance measurement.

TikTok Ad Library Search API Features

  • One focused querySearch with one required non-empty advertiser name, brand term, or keyword.
  • Page-aligned collectionRequest 12 through 2,000 results in multiples of 12; 1,992 is the largest valid value.
  • Opaque cursor handlingFollow source cursors until the limit, an empty page, an end signal, a missing cursor, or a repeated cursor.
  • Normalized ad summariesReceive stable identity, advertiser, shown-date, delivery, destination, impression, media, publication, and collection fields.
  • Source-aware nullabilityKeep fields null or empty when the public search result exposes only a summary or omits that value.

TikTok Ad Library Search API Parameters

ParametersRequiredDescription
queryRequiredRequired non-empty advertiser name or keyword. Exactly one query is accepted.
results_limitOptionalOptional result cap. Defaults to 12 and must be a multiple of 12 from 12 through 2,000; the largest valid value is 1,992.

How to Use the TikTok Ad Library Search API

Submit one query and a valid page-aligned limit to the TikTok Ad Library Search API, poll the asynchronous task, and consume the normalized result pages.

  1. Choose one advertiser name or keyword; the TikTok Ad Library Search API does not accept a list of queries.
  2. POST query and an optional results_limit to /v1/tiktok-ad-library/search.
  3. Poll /v1/tasks/{task_id} until the task reaches a terminal status.
  4. Read data.results.items and follow task-result cursors when the result response reports more pages.
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Anysphere","results_limit":12}'

# Poll GET /v1/tasks/{task_id}
# Read normalized ads from data.results.items

TikTok Ad Library Search API Use Cases

  • Advertiser discovery: Use the TikTok Ad Library Search API to find supported public ads associated with a submitted advertiser or brand name.
  • Keyword research: Build a review set of public ads whose indexed library content matches one topic term.
  • Creative landscape review: Compare visible themes, media references, advertiser labels, and shown dates across returned records.
  • Detail lookup queue: Collect public ad IDs and source references for selected-record inspection with the detail endpoint.

TikTok Ad Library Search API Pro Tips

  • Use a specific advertiser name or distinctive phrase because upstream matching and ordering control relevance.
  • Choose results_limit in 12-record increments; 2,000 is inside the general ceiling but fails the multiple-of-12 rule.
  • Expect fewer records than requested when the source ends, returns an empty page, or repeats a cursor.
  • Do not assume cross-page deduplication; use the stable ad id in your own pipeline when uniqueness matters.
  • Treat estimated audience or impressions according to the source definition, not as conversions or verified performance.
  • Use the Ad Details endpoint for one selected record; Search does not provide optional detail enrichment.

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

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

Explore other platforms

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

TikTok Ad Library Search API — FAQ

TikTok Ad Library Search API is a programmatic interface for finding supported public TikTok advertising records with one advertiser-name or keyword query and returning normalized ad summaries up to a page-aligned limit.

query is one required non-empty string. It can be an advertiser name, brand term, or keyword, but the endpoint does not accept multiple query values in one request.

The default is 12. Values must be integers from 12 through 2,000 and multiples of 12, so 1,992 is the largest valid limit.

No. The current SocQ contract accepts only query and results_limit; matching, ordering, geography, and source eligibility remain upstream-controlled.

Collection stops at the requested limit or when the source returns no ads, reports the last page, omits a cursor, or repeats a cursor. Visibility and geographic rules can also affect availability.

The collector prevents cursor loops but does not promise cross-page record deduplication. Deduplicate by a non-null ad id downstream when required.

The TikTok Ad Library Search API charges 0.5 SocQ credits for each returned ad record, with no base charge. The default estimate covers 12 results, and an empty result has no result charge.