TikTok API
Videos, comments, accounts.
The TikTok API lets you search videos and read video details, comments, account profiles and an account's videos, with no TikTok account or login. Each call costs 2 credits ($0.004 to $0.0067); failed calls are free. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-19.
Last tested: Last updated:
/v1/search200 OK2 creditsplatform: "tiktok" · query: "space station"titleauthor.verifiedmetrics.repostsimages+15 actions.
Plus 10 only TikTok has.
Open a row to see its request. Its full parameters and response fields are on its own page.
SearchFind videos by keyword: text, author, likes, comment count, views and publish time./v1/search2 credits≈ $0.0067$0.23 per 1,000 (up to 30 a page)
platformquery+2 optionaltype=useraccounts instead of posts2 creditscurl https://socialtoai.app/v1/search \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "tiktok", "query": "space station" }'POST /v1/searchYour key goes in the Authorization headerDetailOne video by ID or link: text, author, likes, comment count, views and publish time./v1/detail2 credits≈ $0.0067
platformid or urlinclude=transcriptthe transcript of the video2 creditscurl https://socialtoai.app/v1/detail \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "tiktok", "id": "7665840565958872333" }'POST /v1/detailYour key goes in the Authorization headerCommentsThe comments under one video: text, likes, reply count and time./v1/comments2 credits≈ $0.0067$0.13 per 1,000 (up to 50 a page)
platformid or urlreply_ofthe replies under one comment2 creditscurl https://socialtoai.app/v1/comments \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "tiktok", "id": "7665840565958872333" }'POST /v1/commentsYour key goes in the Authorization headerUser ProfileOne account: name, bio, followers, following and post count./v1/user_profile2 credits≈ $0.0067
platformid or usernamecurl https://socialtoai.app/v1/user_profile \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "tiktok", "id": "6767146744805213190" }'POST /v1/user_profileYour key goes in the Authorization headerUser PostsThe recent videos of one account./v1/user_posts2 credits≈ $0.0067$0.67 per 1,000 (up to 10 a page)
platformusername+1 optionalcurl https://socialtoai.app/v1/user_posts \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "tiktok", "username": "nasa" }'POST /v1/user_postsYour key goes in the Authorization headerNot offered on TikTok: trending.
Compared with Instagram: TikTok videos also give author followers, shares and saves but do not give images; its accounts also give posts.
Creative Center Top Ad detailGet one Top Ad of TikTok's Creative Center by its ID.tiktok.top_ad_detail2 credits≈ $0.0067
Get one Top Ad of TikTok's Creative Center by its ID: the ad's video, caption, brand name, landing page, likes, comments, shares, length, campaign objective, industry code and the countries it ran in.
idcurl https://socialtoai.app/v1/call/tiktok.top_ad_detail \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "7686210433094729735" }'POST /v1/call/tiktok.top_ad_detailYour key goes in the Authorization headerCreative Center Top Ads searchSearch the Top Ads of TikTok's Creative Center by keyword.tiktok.top_ad_search2 credits≈ $0.0067$0.33 per 1,000 (up to 20 a page)
Search the Top Ads of TikTok's Creative Center by keyword: the ad's video, caption, brand name, likes, length and campaign objective; one country at a time, over a chosen period, in the Creative Center's own order or by likes. 20 ads a page. This is a showcase of ads that did well, not an ad library: it has no dates.
query+3 optionalcurl https://socialtoai.app/v1/call/tiktok.top_ad_search \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "query": "sneakers" }'POST /v1/call/tiktok.top_ad_searchYour key goes in the Authorization headerAds Library searchSearch TikTok's public Ads Library (ads shown in Europe) by keyword or by the advertiser's name.tiktok.ad_search2 credits≈ $0.0067$0.56 per 1,000 (up to 12 a page)
Search TikTok's public Ads Library (ads shown in Europe) by keyword or by the advertiser's name: advertiser, headline, videos and images, when each was first and last shown, and a bracket of people reached; newest first, 12 ads a page. This is the transparency record of ads, a different set from the Creative Center's Top Ads.
query or advertisercurl https://socialtoai.app/v1/call/tiktok.ad_search \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "query": "running shoes" }'POST /v1/call/tiktok.ad_searchYour key goes in the Authorization headerAds Library ad detailGet one ad of TikTok's public Ads Library by its ID or link.tiktok.ad_detail2 credits≈ $0.0067
Get one ad of TikTok's public Ads Library by its ID or link: advertiser, headline, videos and images, landing page, when it was first and last shown, the countries it was shown in and the campaign's objective.
id or urlcurl https://socialtoai.app/v1/call/tiktok.ad_detail \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "1871655924410641" }'POST /v1/call/tiktok.ad_detailYour key goes in the Authorization headerShop product reviewsGet the first 10 buyers' reviews of a TikTok Shop product in the United States by the product's ID.tiktok.product_reviews2 credits≈ $0.0067$0.67 per 1,000 (up to 10 a page)
Get the first 10 buyers' reviews of a TikTok Shop product in the United States by the product's ID: text, rating, time, variant bought, pictures.
idcurl https://socialtoai.app/v1/call/tiktok.product_reviews \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "1732488007561286228" }'POST /v1/call/tiktok.product_reviewsYour key goes in the Authorization headerShop product searchSearch the products of TikTok Shop in the United States by terms.tiktok.product_search2 credits≈ $0.0067$0.11 per 1,000 (up to 60 a page)
Search the products of TikTok Shop in the United States by terms: title, current and original price, rating, units sold, shop.
querycurl https://socialtoai.app/v1/call/tiktok.product_search \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "query": "yoga mat" }'POST /v1/call/tiktok.product_searchYour key goes in the Authorization headerShop seller productsGet a page of the products a TikTok Shop seller in the United States has on sale by the seller's ID.tiktok.seller_products2 credits≈ $0.0067$0.33 per 1,000 (up to 20 a page)
Get a page of the products a TikTok Shop seller in the United States has on sale by the seller's ID: title, current and original price, rating, reviews, units sold.
idcurl https://socialtoai.app/v1/call/tiktok.seller_products \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "8651645720603103776" }'POST /v1/call/tiktok.seller_productsYour key goes in the Authorization headerShop product detailGet a TikTok Shop product in the United States by its ID.tiktok.product_detail2 credits≈ $0.0067
Get a TikTok Shop product in the United States by its ID: title, description, pictures, rating, reviews, units sold, the shop with its rating, followers and products on sale, and the price and shipping fee its page shows. The page's price runs about a shipping fee above the price in the shop's list and the search, which the product search gives.
idcurl https://socialtoai.app/v1/call/tiktok.product_detail \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "1732488007561286228" }'POST /v1/call/tiktok.product_detailYour key goes in the Authorization headerHashtag videosGet a page of the TikTok videos under a hashtag, by its name, about 20 a page.tiktok.hashtag_videos2 credits≈ $0.0067$0.33 per 1,000 (up to 20 a page)
Get a page of the TikTok videos under a hashtag, by its name, about 20 a page: caption, author, engagement counts, cover and play address.
idcurl https://socialtoai.app/v1/call/tiktok.hashtag_videos \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "nasa" }'POST /v1/call/tiktok.hashtag_videosYour key goes in the Authorization headerUser followersGet a page of the accounts following a TikTok user, by handle, 50 a page, newest followers first.tiktok.followers2 credits≈ $0.0067$0.13 per 1,000 (up to 50 a page)
Get a page of the accounts following a TikTok user, by handle, 50 a page, newest followers first: handle, name, bio, follower, following and video counts, likes received, and each account's country or region and language, for where the followers are.
usernamecurl https://socialtoai.app/v1/call/tiktok.followers \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "username": "nasa" }'POST /v1/call/tiktok.followersYour key goes in the Authorization headerWhat a whole job costs.
| The job | How it adds up | Credits | About |
|---|---|---|---|
| Search 1,000 results on TikTok | usually 30 a page, 34 pages | 68 credits | about $0.23 |
| Read 1,000 TikTok comments | usually 50 a page, 20 pages | 40 credits | about $0.13 |
| Backfill one TikTok account: a list of 200 videos and 20 in full | 20 list pages + 20 full reads | 80 credits | about $0.27 |
| Watch 1 TikTok account daily, at most a month | 12 credits × 31 days | 372 credits | about $1.24 |
Priced at the $10 pack; larger purchases bring it down. A watch runs only while it is on, and you can pause it at any time. There is no subscription.
Or skip the parameters.
Just ask.
Connect SocialToAI once over MCP. Your AI picks the calls, and you see what each one cost.
Which is bigger on TikTok this week: home coffee or matcha?
- search“home coffee”2 credits
- search“matcha”2 credits
Read the comments on this TikTok video and tell me what people complain about.
- detailthe video you pasted2 credits
- commentsfirst 3 pages6 credits
Find five TikTok accounts that post about camping coffee and show me what they posted lately.
- searchaccounts · “camping coffee”2 credits
- user_posts5 accounts10 credits
Same shape on every platform.
Learn it once.
A TikTok video and a Xiaohongshu note come back with the same field names. What a platform cannot give comes back as null.
{ "platform": "tiktok", "id": "…", "ref": "…", "approx": [], "extra": {}, "type": "content", "url": "https://example.com/…", "format": "video", "title": null, "text": "…", "published_at": "2026-10-08T13:12:22.000Z", "author": { "id": "…", "username": "…", "name": "…", "verified": null, "followers": 2060936 }, "metrics": { "likes": 67877, "comments": 524, "shares": 2472, "collects": 5331, "views": 449259, "reposts": null }, "images": null, "hashtags": [], "is_pinned": null}titleauthor.verifiedmetrics.repostsimagesis_pinned{ "platform": "xiaohongshu", "id": "…", "ref": "…", "approx": [], "extra": {}, "type": "content", "url": "https://example.com/…", "format": "image", "title": "…", "text": "…", "published_at": "2026-10-09T01:00:34.000Z", "author": { "id": "…", "username": "…", "name": "…", "verified": null, "followers": null }, "metrics": { "likes": 927, "comments": 122, "shares": 256, "collects": 59, "views": null, "reposts": null }, "images": ["https://example.com/…", "https://example.com/…"], "hashtags": ["…", "…"], "is_pinned": false}author.verifiedauthor.followersmetrics.viewsmetrics.reposts7 tools read TikTok.
All toolsDoes TikTok have an official API?
TikTok's API for reading public content at scale is the Research API, open only to approved academic and not-for-profit researchers in eligible regions, for non-commercial research. Its Display API reads only the profile and public videos of users who log in and authorise the app.
Source: TikTok's developer documentation, checked 2026-10-17.
| Who can use it | Cost | Limits | Source | |
|---|---|---|---|---|
| Research API | Approved academic and not-for-profit researchers in eligible regions, for non-commercial research. | TikTok's page states no price; access is by application. | Reads public content at scale, but not for business use. | developers.tiktok.com, checked 2026-10-17 |
| Display API | Apps whose users log in and authorise them. | TikTok's page states no price. | Reads only the profile and public videos of the users who authorise the app. | developers.tiktok.com, checked 2026-10-17 |
| SocialToAI | Anyone with a key; no TikTok account of yours and no review. | From 2 credits a call (≈$0.0067); failed calls are free. | Publicly visible content only; up to 50 items a call. | Pricing |
1,000 videos here: about 34 tiktok.search calls (typically 30 a page), 68 credits, $0.23 at the first pack. Estimate your cost
- TikTok transcript APIWhat is said in a public TikTok video, with timed segments, by link.
- Comments API, every platformWhich platforms give comments, how many a page, at what price.
- Transcript API, every platformWhich platforms give a transcript, timed or not.
- How to analyze video comments with AI, and keep the original wordswhat comments say, with original words: the tool or your AI, price per platform, a recorded answer
- How to get the numbers for hundreds of post links at oncethe numbers of hundreds of links in one job: prices per platform, what the free credits run, and what it stops for
- Monitor competitors' accounts every daycompetitors' accounts, daily: what is new and what beat their usual, from 9 credits an account
- Monitor brand mentions every day, with the posts behind thema brand, daily, across platforms: attitudes and the posts behind them, from 16 credits a run
- TikTok MCP serverLet your AI read TikTok.