↑ ↓ to move ↵ to open

TikTok API reference

Get public TikTok profiles, videos, comments, hashtag and search results, captions and US Shop products as clean JSON. Send a handle, a video link or a keyword. No TikTok login.

At a glance

Platform ID
tiktok
Endpoints
20
Price
From 0.5 credits per call; failed calls are free
Pin in MCP
https://data.upscrape.com/mcp?platforms=tiktok
Pin tools
OpenAPI
openapi.json
Download

The TikTok API has 20 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin TikTok in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.

The inputs you send most are handle, url and sec_uid. Prices run from 0.5 credits to 1 credit per call, and a failed call costs nothing.

Endpoints

Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.

EndpointWhat it returnsPrice
tiktok.profile.get Get a public profile from its handle: name, bio, followers, following, total likes, video count and verified status. 0.75 credits
tiktok.user.videos List a creator's public videos, latest or most popular first, with caption, plays, likes, comments, shares and post time. 0.75–1 credits
tiktok.post.get Get one video from its link, or its ID and handle: caption, author, plays, likes, comments, shares and post time. 1 credit
tiktok.video.comments Read the public comments on a video, page by page, each checked to belong to that video. 0.75 credits
tiktok.comment.replies Read the public replies to one comment on a video. 0.5 credits
tiktok.hashtag.posts List the videos that carry a hashtag, by its name or ID, page by page. 1–1.5 credits
tiktok.video.transcript Get a video's own captions as text with timings, in the language you choose when the video has it. 1 credit
tiktok.shop.product.get Get a US TikTok Shop product from its link: title, price, every variant with its own price, and stock quantities. 0.75 credits
tiktok.shop.search Search US TikTok Shop products by keyword, with price, discount, rating, review count and units sold. 0.75 credits
tiktok.shop.products List the products in a US TikTok Shop store, with price, discount, rating and units sold. 0.75 credits
tiktok.shop.reviews Read a US TikTok Shop product's public reviews: rating, date, verified purchase and text. 0.75 credits
tiktok.music.info Get a sound's details from its music ID: title, author and how many videos use it. 0.75 credits
tiktok.music.posts List the videos that use a sound, from its music ID. 0.75 credits
tiktok.collection.videos List the videos in a public collection or playlist. 0.75–1 credits
tiktok.feed.trending Get a page of TikTok's US For You feed for a visitor, from many creators. 0.75–1 credits
tiktok.search.suggestions Get the search suggestions TikTok offers for a keyword. 0.75 credits
tiktok.user.live Check whether an account is live now, with its LIVE room ID. 1 credit
tiktok.live.get Get a LIVE room's details from its ID: title, the account running it, whether it is on and its engagement. 1 credit
tiktok.user.followers List the public followers of an account, page by page. 0.75 credits
tiktok.user.following List the accounts a public account follows, page by page. 0.75 credits

What to know

  • Counts as TikTok shows them Plays, likes, comments and followers are TikTok's own numbers at the moment of the call. TikTok rounds large ones.
  • Page sizes are a guide Ask for about how many results you want; TikTok decides the exact page size, and the response says whether more follow.
  • Captions come from the video Transcripts are the captions TikTok has for a video. A video without captions has no transcript to return.
  • Sounds and hashtags lead to videos The music and hashtag endpoints list the videos that use a sound or a tag, so you can follow a trend to its posts.

Something missing or unclear? Ask the team that builds the TikTok endpoints.