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.
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.
Parameters
| Parameters | Required | Description |
|---|---|---|
url | Required | Required 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
Submit a known public ad URL, poll the asynchronous task, and process the single result when available.
- Choose an official TikTok ad URL with an id, ad_id, or numeric path identifier when possible.
- POST url to /v1/tiktok-ad-library/ad and save the returned task_id.
- Poll /v1/tasks/{task_id} until the task reaches a terminal status.
- 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 itemBest Use Cases
- Selected-ad inspection: Resolve one ad selected from a search result into the normalized detail fields currently 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.
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; this detail endpoint never enumerates an advertiser's ads.
Related APIs
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.