TikTok Ad Library API
Discover supported public TikTok advertising records with a query or resolve a known ad URL into normalized fields for research, review, and archiving.
Available TikTok Ad Library APIs
Use Search to discover public advertising records by advertiser or keyword, and Ad Details to resolve one known qualifying public ad URL.
What public ad data can you retrieve?
Returned fields reflect the public information currently exposed for each supported record; unavailable source values remain null or empty.
Ad and advertiser identity
Collect public ad IDs, available record URLs, advertiser names, advertiser references, and stable resource types.
Creative and destination
Inspect available ad copy, format, media references, and public landing-page URLs.
Visible delivery context
Read supported shown dates, publication time, countries, platforms, audience, and impression information when exposed.
Collection context
Preserve normalized source and collection fields for review queues, catalogs, and research datasets.
SocQ and TikTok advertising products
SocQ provides read-only collection of supported public transparency records. TikTok's own products serve different purposes, from public-library access to authorized campaign management.
| Capability | SocQ | TikTok advertising products |
|---|---|---|
| Primary use | Search and normalize supported public ad records | Public transparency or authorized campaign operations, depending on the product |
| Inputs | One advertiser or keyword, or one known ad URL | Controls vary by the relevant TikTok surface |
| Private campaign data | Not available | Requires the applicable account, product, approval, and permissions |
| Actions | Read-only public-data workflow | Ads Manager supports authorized campaign operations |
| Response format | Stable SocQ ad records | Product-specific native views or responses |
How the TikTok Ad Library APIs work
Both endpoints use an asynchronous submit, poll, and read lifecycle; Search can collect multiple source pages, while Ad Details returns at most one record.
1. Choose an endpoint
Submit one advertiser or keyword to Search, or one qualifying public TikTok ad URL to Ad Details.
2. Poll the task
Use the returned task_id with /v1/tasks/{task_id} until processing succeeds or fails.
3. Read normalized records
Consume data.results.items and any task-result cursor; a detail request returns zero or one ad.
Authenticate with a SocQ API key. Search defaults to 12 results; Ad Details has no pagination or results_limit.
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}'
# Or resolve one known ad URL:
# POST /v1/tiktok-ad-library/ad
# {"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}
# Poll GET /v1/tasks/{task_id}Common TikTok Ad Library API use cases
Brand monitoring
Build periodic review sets of available public ads matched to a known advertiser name.
Creative review
Resolve selected ads and inspect supported public copy, advertiser, format, media, and destination fields.
Transparency archiving
Preserve normalized public advertising records with shown-date and collection context.
Research enrichment
Use search results to identify records, then turn known public ad URLs into stable detail fields.
Limits and public-data policy
Public advertising records depend on source visibility, eligibility, geographic availability, publication delay, retention, and fields exposed by the relevant TikTok surface.
- Absence from search is not proof that an advertiser has never run an ad, and unavailable URLs may produce no detail result.
- Search does not expose country, date, section, language, industry, objective, enrichment, or sort controls.
- Public dates, audience, or impression values are not private spend, conversion, attribution, or return-on-ad-spend reporting.
- Media references can be temporary or source-controlled, and all source-dependent fields may be null or empty.
TikTok Ad Library API frequently asked questions
Is SocQ TikTok Ads Manager?
No. SocQ searches and normalizes supported public transparency records; it does not manage accounts, campaigns, budgets, targeting, or creatives.
What can I submit?
Search accepts one advertiser name or keyword. Ad Details accepts one qualifying known public TikTok advertising URL.
Does every result contain complete ad details?
No. Search commonly returns summaries, detail lookup can return no record, and all source-dependent fields can be null or empty.
How is usage priced?
Each returned record costs 0.5 SocQ credits with no base charge; Search defaults to 12 results and Ad Details returns at most one.
Combine data across platforms for more complete business insights
Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.
YouTube API
Collect supported public YouTube channel profiles, video details, channel videos, comments, Shorts, keyword and hashtag results, and available transcripts through one normalized asynchronous workflow.
X API
Collect public profiles, follower and following relationships, posts, replies, quotes, retweeters, search results, and current trends. Use consistent results for research and monitoring.
Facebook API
Collect public Facebook Page profiles, posts, group posts, comments, keyword-matched events, and available video transcripts with normalized identity, content, source, format, place, media, reaction, attendance, and engagement fields.
Google Ad Library API
Discover public advertisers, collect creatives for a company, or retrieve one known Transparency Center creative by URL for research and review.
Google Maps API
Discover public places, retrieve normalized details for known Maps URLs, and collect public reviews with source-linked place and author context.
Kwai API
Retrieve public Kwai profiles, one page of account posts, or one known post with normalized identity, content, media, timestamps, and visible engagement.