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-10-17.
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
platformquery+2 optionaltype=useraccounts instead of posts2 creditscurl https://api.socialtoai.com/v1/search \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -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
platformid or urlinclude=transcriptthe transcript of the video2 creditscurl https://api.socialtoai.com/v1/detail \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -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
platformid or urlreply_ofthe replies under one comment2 creditscurl https://api.socialtoai.com/v1/comments \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -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
platformid or usernamecurl https://api.socialtoai.com/v1/user_profile \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -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
platformusername+1 optionalcurl https://api.socialtoai.com/v1/user_posts \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "platform": "tiktok", "username": "nasa" }'POST /v1/user_postsYour key goes in the Authorization headerNot offered on TikTok: trending.
Creative Center Top Ad detailPreviewGet one Top Ad of TikTok's Creative Center by its ID.tiktok.top_ad_detail2 credits
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 and the countries it ran in.
idcurl https://api.socialtoai.com/v1/call/tiktok.top_ad_detail \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "7686210433094729735" }'POST /v1/call/tiktok.top_ad_detailYour key goes in the Authorization headerCreative Center Top Ads searchPreviewSearch the Top Ads of TikTok's Creative Center by keyword.tiktok.top_ad_search2 credits
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://api.socialtoai.com/v1/call/tiktok.top_ad_search \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "sneakers" }'POST /v1/call/tiktok.top_ad_searchYour key goes in the Authorization headerAds Library searchPreviewSearch TikTok's public Ads Library (ads shown in Europe) by keyword.tiktok.ad_search2 credits
Search TikTok's public Ads Library (ads shown in Europe) by keyword: 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.
querycurl https://api.socialtoai.com/v1/call/tiktok.ad_search \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "running shoes" }'POST /v1/call/tiktok.ad_searchYour key goes in the Authorization headerAds Library ad detailPreviewGet one ad of TikTok's public Ads Library by its ID or link.tiktok.ad_detail2 credits
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://api.socialtoai.com/v1/call/tiktok.ad_detail \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "1871655924410641" }'POST /v1/call/tiktok.ad_detailYour key goes in the Authorization headerShop product reviewsPreviewGet the first 10 buyers' reviews of a TikTok Shop product in the United States by the product's ID.tiktok.product_reviews2 credits
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://api.socialtoai.com/v1/call/tiktok.product_reviews \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "1732488007561286228" }'POST /v1/call/tiktok.product_reviewsYour key goes in the Authorization headerShop product searchPreviewSearch the products of TikTok Shop in the United States by terms.tiktok.product_search2 credits
Search the products of TikTok Shop in the United States by terms: title, current and original price, rating, units sold, shop.
querycurl https://api.socialtoai.com/v1/call/tiktok.product_search \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "yoga mat" }'POST /v1/call/tiktok.product_searchYour key goes in the Authorization headerShop seller productsPreviewGet 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
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://api.socialtoai.com/v1/call/tiktok.seller_products \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "8651645720603103776" }'POST /v1/call/tiktok.seller_productsYour key goes in the Authorization headerShop product detailPreviewGet a TikTok Shop product in the United States by its ID.tiktok.product_detail2 credits
Get a TikTok Shop product in the United States by its ID: title, description, pictures, rating, reviews, units sold, shop; its price comes from the product search.
idcurl https://api.socialtoai.com/v1/call/tiktok.product_detail \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -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
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://api.socialtoai.com/v1/call/tiktok.hashtag_videos \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -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
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.
usernamecurl https://api.socialtoai.com/v1/call/tiktok.followers \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "username": "nasa" }'POST /v1/call/tiktok.followersYour key goes in the Authorization headerPreview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.
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": [], "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": [], "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.