TikTok Creative Center is where marketers look up the ads that perform best, the hashtags climbing in a country and the videos topping the charts. Creator Marketplace adds audience data and starting rates for creators. On 2026-11-17 SocQ added six endpoints that return this data as JSON, listed on the TikTok Creative Center platform page.
The six endpoints work in three pairs. A list endpoint finds candidates, and a detail endpoint takes the ID from that list and returns the depth. This guide covers each pair: what it returns, the request, the price and when to use it.
Quick answer: Send a JSON body to
POST https://api.socq.ai/v1/tiktok-creative-center/<endpoint>. Save the returnedtask_id, pollGET /v1/tasks/{task_id}untilstatusissucceeded, then readdata.results.items.
The New TikTok Creative Center Endpoints
1 SocQ credit = $0.005. List endpoints charge per result with no base fee.
| Endpoint | What it returns | Price |
|---|---|---|
| Top Ads API | Top-performing ads with caption, advertiser, industry, objective, CTR, likes and video | 0.5 credits ($0.0025) per ad |
| Ad Analysis API | One ad's details, impressions percentile and second-by-second click-through and retention curves | 1 credit ($0.005) per call |
| Trending Hashtags API | Hashtags trending in a country with rank, posts, views and daily popularity curve | 0.5 credits ($0.0025) per hashtag |
| Hashtag Insights API | One hashtag's totals, popularity curve, top countries and example video IDs | 0.5 credits ($0.0025) per call |
| Top Videos API | A country's top video chart with rank, creator, chart and lifetime views and engagement rates | 0.5 credits ($0.0025) per video |
| Creator Marketplace API | Creator cards with follower age, gender, country and device mix, median views, engagement rate and starting rate | 0.5 credits ($0.0025) per creator |
Authentication and the Async Task Flow
All requests authenticate with an API key. The same header is used for submit, task status and result requests:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Every collection runs as a background task:
submit -> task_id -> queued -> running -> succeeded
\-> failed
The submit call returns immediately with data.task_id and data.status. Poll the task with that ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
When status is succeeded, the response includes result_count, credits_amount and the first page of normalized records in data.results.items. limit defaults to 50 and goes up to 500. If results.has_more is true, pass results.next_cursor as cursor to read the next page. A failed task carries error_message.
Every endpoint here also accepts an optional callback_url. SocQ sends one POST with a task summary when the task finishes; read the records from the task endpoint. A client-side timeout does not cancel a task, so resume with the same task ID instead of submitting again. A 402 means the account is out of credits, and a 429 means the key hit a rate or credit limit.
Top Ads and Ad Analysis: Build a Swipe File
The Top Ads API browses the ads TikTok Creative Center ranks as top performers. Each ad comes with its caption, advertiser, industry, campaign objective, ctr, likes and the full video. All fields are optional: query matches ad captions and brands, time_range is 7d, 30d (default) or 180d, and sort_by is relevance (default) or likes. results_limit defaults to 20 and accepts 1 to 300. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "skincare", "time_range": "30d", "sort_by": "likes"}'
The Ad Analysis API takes the id of one Top Ads result as ad_id. Alongside the ad's details, countries and landing page, it returns impressions_percentile against comparable ads, a click_through_curve and a retention_curve, each as a value per second of video. Read the two curves together to find the hook, the point where viewers drop off and the moment they act. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/ad-analysis" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ad_id": "7697084527089729557"}'
When to use it: creative research for a new campaign. Pull 20 top ads in your category (10 credits), then analyze the five most relevant (5 credits). That is 15 credits, or $0.075.
Trending Hashtags and Hashtag Insights: Spot Rising Tags by Country
The Trending Hashtags API returns the hashtags climbing in one country, each with its rank, post count, view count and a daily popularity_curve for the period. All fields are optional: country is a two-letter code (default US), and time_range is 7d (default), 30d or 90d. results_limit defaults to 20 and accepts 1 to 100. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "time_range": "7d", "results_limit": 20}'
The Hashtag Insights API takes a Trending Hashtags id as hashtag_id, together with the same country. It returns post and view totals, the daily popularity curve, top_countries with a score for how popular the tag is relative to each country's size, and video_ids of example videos. time_range defaults to 7d. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}'
When to use it: choosing hashtags for a launch in a specific market, or checking whether a tag is global or local before you build content around it. To size any hashtag you already have in mind, including ones that are not trending, the TikTok Hashtag Views API returns total videos and views for up to 20 tags at once.
Top Videos and Creator Marketplace: Find Creators and Their Rates
The Top Videos API reads TikTok Creative Center's chart of top-performing videos for a country. Each entry has its rank, caption, creator, creator_id, chart-period views, organic views, lifetime views, engagement rate and six-second view rate. All fields are optional: country defaults to US, period is daily (default), weekly or long_term, and sort_by is views (default), engagement_rate or six_second_view_rate. The latest published chart is used. results_limit defaults to 20 and accepts 1 to 100. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "period": "daily", "results_limit": 20}'
The Creator Marketplace API takes 1 to 20 numeric creator_ids, such as the creator_id values from Top Videos. Each creator with a card returns the age, gender, country and device mix of their followers, follower count, median views, engagement rate, follower growth rate, six-second view rate, recent video IDs and the starting_price they list for a sponsored video. Only creators with a card are billed. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"creator_ids": ["7011198409688219653", "7070293872819044358"]}'
When to use it: building a creator shortlist with budget in mind. A daily chart of 20 videos (10 credits) and cards for 20 creators (10 credits) cost 20 credits, or $0.10.
How This Fits With the Other TikTok Endpoints
Creative Center data is aggregated by TikTok: charts, rankings and curves. For a creator's own profile, videos and comments, use the endpoints in the TikTok scraping guide. For follower countries from a creator's public account and fake-view checks, see the new TikTok endpoints guide. Ads that run on Meta are covered by the Facebook Ad Library APIs.
FAQ
Do I need a TikTok Ads or Creator Marketplace account?
No. You authenticate with a SocQ API key and send the fields shown above.
Where does ad_id come from?
From a Top Ads result: pass its id to Ad Analysis as ad_id. In the same way, Trending Hashtags id goes to Hashtag Insights as hashtag_id, and Top Videos creator_id goes to Creator Marketplace.
Which countries can I query?
Trending Hashtags, Hashtag Insights and Top Videos take a two-letter country code, such as US, GB or JP, and default to US. Use the same country for Hashtag Insights that you used to find the hashtag.
Is a creator's starting rate always present?
The rate is part of the Creator Marketplace card, and only creators with a card return a result. Like other SocQ fields, a value the source does not provide comes back as null.
How are empty results billed?
The per-result endpoints have no base fee, so a call that returns nothing costs nothing. Ad Analysis and Hashtag Insights are billed once per call.
TIKTOK CREATIVE CENTER API
Test the workflow with a public TikTok Creative Center URL
Submit public inputs and receive normalized records with traceable source context.
Explore TikTok Creative Center APIs