TikTok API by APISH

Get public TikTok data as clean, consistent JSON: latest videos of a TikTok account, tikTok playlist / collection videos, replies to a TikTok comment, comments of a TikTok video, popular TikTok creators right now, tikTok discover (keyword) page and more. 33 endpoints, one response shape, numbers parsed, absolute URLs.

How to use

1. Pick an Endpoint. Each option shows what it returns and its price in credits.
2. Enter its Parameters as JSON, for example {"username":"nasa"}. All parameters are listed below.
3. Run. Each call becomes one row in the dataset. Use Batch to run the same endpoint for many inputs and Pages per input to follow pagination.

Pricing

Pay per event: you pay per APISH credit the call used. The price of each endpoint is in the table below. Calls that fail on our side (server errors, timeouts, blocks) are free.

Endpoints

Endpoint	Returns	Required parameters	Credits
/tiktok/v1/channel	Latest videos of a TikTok account	username	3
/tiktok/v1/collection/videos	TikTok playlist / collection videos	url	1
/tiktok/v1/comment/replies	Replies to a TikTok comment	url, comment_id	1
/tiktok/v1/comments	Comments of a TikTok video	url	1
/tiktok/v1/creators/popular	Popular TikTok creators right now	—	1
/tiktok/v1/discover	TikTok discover (keyword) page	keyword	1
/tiktok/v1/discover/related	TikTok related keywords	keyword	1
/tiktok/v1/explore/categories	TikTok Explore categories	—	1
/tiktok/v1/hashtag	TikTok hashtag	name	1
/tiktok/v1/hashtag/videos	TikTok hashtag videos	name	1
/tiktok/v1/live	TikTok live room	—	1
/tiktok/v1/post	One TikTok video	url	1
/tiktok/v1/profile	TikTok profile	username	1
/tiktok/v1/profile/region	TikTok account region	username	2
/tiktok/v1/search	TikTok videos for a keyword (public hashtag feed)	q	1
/tiktok/v1/search/keyword	Search TikTok videos	q	1
/tiktok/v1/search/live	Search TikTok LIVE rooms	q	1
/tiktok/v1/search/suggestions	TikTok search suggestions	q	1
/tiktok/v1/search/top	TikTok Top search (videos and accounts)	q	1
/tiktok/v1/search/users	Search TikTok accounts	q	1
/tiktok/v1/song	TikTok sound	id	1
/tiktok/v1/song/videos	Videos using a TikTok sound	id	1
/tiktok/v1/trending	Trending TikTok videos	—	1
/tiktok/v1/trends/hashtags	TikTok trending hashtags (Creative Center)	—	1
/tiktok/v1/user/collections	TikTok user collections	username	1
/tiktok/v1/user/followers	TikTok followers	username	1
/tiktok/v1/user/following	Accounts a TikTok user follows	username	1
/tiktok/v1/user/liked	TikTok user liked videos	username	1
/tiktok/v1/user/live	Is a TikTok account live	username	1
/tiktok/v1/user/playlists	TikTok user playlists	username	1
/tiktok/v1/user/reposts	TikTok user reposts	username	1
/tiktok/v1/video/related	Related TikTok videos	url	1
/tiktok/v1/video/transcript	TikTok video transcript (TikTok captions)	url	1

Output

Each dataset row has endpoint, params, status, credits_used and the endpoint's data. Add "raw": 1 to the parameters to also get the site's original record, or "fields": "a,b.c" to return only the fields you need.

Endpoint details

Latest videos of a TikTok account

Endpoint /tiktok/v1/channel · 3 credits per successful call.

The profile's videos, 35 per page; pass next_cursor back as cursor. Logged out, TikTok serves about two pages (~60 videos), then next_cursor is null (more_available says whether the account has more). sort = latest (default), popular or oldest, like the tabs on the profile.

Parameters:

• username (required)
• sort — one of latest, popular, oldest: latest (default), popular or oldest.
• cursor: Value of next_cursor from the previous page (logged out, TikTok serves about two pages).

Example parameters: {"username":"nasa"}

TikTok playlist / collection videos

Endpoint /tiktok/v1/collection/videos · 1 credit per successful call.

Parameters:

• url (required)
• cursor: Value of next_cursor from the previous page.

Example parameters: {"url":"https://www.tiktok.com/@nba/playlist/Playoffs-7499302679324936990"}

Replies to a TikTok comment

Endpoint /tiktok/v1/comment/replies · 1 credit per successful call.

Parameters:

• url (required)
• comment_id (required)
• cursor: Value of next_cursor from the previous page.

Example parameters: {"url":"https://www.tiktok.com/@khaby.lame/video/7137423965982592302","comment_id":"7137510823549272878"}

Comments of a TikTok video

Endpoint /tiktok/v1/comments · 1 credit per successful call.

Pagination: pass the cursor from next_cursor on the previous response; next_cursor is null on the last page.

Parameters:

• url (required)
• cursor: Cursor from next_cursor on the previous response; next_cursor is null on the last page.

Example parameters: {"url":"https://www.tiktok.com/@nasa/video/7697300954667994381"}

Popular TikTok creators right now

Endpoint /tiktok/v1/creators/popular · 1 credit per successful call.

Ranks the creators behind what TikTok's Explore feed is pushing right now (All, Singing & Dancing and Comedy by default, or one category) by followers, with their trending videos.

Parameters:

• category: One Explore category (name or id) instead of the default three.
• country: Two-letter country, default US.
• limit: Creators to return, up to 200 (default 50).

TikTok discover (keyword) page

Endpoint /tiktok/v1/discover · 1 credit per successful call.

Parameters:

• keyword (required): A phrase or the slug from a tiktok.com/discover/ URL (the URL itself works too).
• count: Videos per page, up to 30 (default 20).
• cursor: Value of next_cursor from the previous page.

Example parameters: {"keyword":"healthy breakfast ideas"}

TikTok related keywords

Endpoint /tiktok/v1/discover/related · 1 credit per successful call.

Parameters:

• keyword (required): A phrase or a tiktok.com/discover/ slug.
• count: How many (default 60, up to 100).

Example parameters: {"keyword":"healthy breakfast ideas"}

TikTok Explore categories

Endpoint /tiktok/v1/explore/categories · 1 credit per successful call.

The Explore tabs (All, Comedy, Food, ...) with the id that category accepts on /tiktok/v1/trending.

TikTok hashtag

Endpoint /tiktok/v1/hashtag · 1 credit per successful call.

A hashtag page: id, video count, view count, cover, description.

Parameters:

• name (required): Hashtag without #, or its tiktok.com/tag URL.

Example parameters: {"name":"cooking"}

TikTok hashtag videos

Endpoint /tiktok/v1/hashtag/videos · 1 credit per successful call.

Videos filed under a hashtag, 30 per page.

Parameters:

• name (required): Hashtag without #, or its tiktok.com/tag URL.
• cursor: Value of next_cursor from the previous page; next_cursor is null on the last page.

Example parameters: {"name":"cooking"}

TikTok live room

Endpoint /tiktok/v1/live · 1 credit per successful call.

A live room by room_id, or the current room of username. An account that is not live answers live: false.

Parameters:

• username
• room_id: Live room ID (instead of username).

One TikTok video

Endpoint /tiktok/v1/post · 1 credit per successful call.

Parameters:

• url (required)

Example parameters: {"url":"https://www.tiktok.com/@nasa/video/7697300954667994381"}

TikTok profile

Endpoint /tiktok/v1/profile · 1 credit per successful call.

Parameters:

• username (required)

Example parameters: {"username":"nasa"}

TikTok account region

Endpoint /tiktok/v1/profile/region · 2 credits per successful call.

Most common country the latest posts were published from.

Parameters:

• username (required)

Example parameters: {"username":"khaby.lame"}

TikTok videos for a keyword (public hashtag feed)

Endpoint /tiktok/v1/search · 1 credit per successful call.

The public hashtag feed for the keyword (spaces removed): the videos TikTok files under #

Parameters:

• q (required)
• cursor: Value of next_cursor from the previous page; next_cursor is null on the last page.

Example parameters: {"q":"cooking"}

Search TikTok videos

Endpoint /tiktok/v1/search/keyword · 1 credit per successful call.

Parameters:

• q (required)
• cursor: Value of next_cursor from the previous page.
• date — one of all, day, week, month, 3months, 6months: Date posted: all (default), day, week, month, 3months, 6months.
• sort — one of relevance, likes: relevance (default) or likes.

Example parameters: {"q":"cooking"}

Search TikTok LIVE rooms

Endpoint /tiktok/v1/search/live · 1 credit per successful call.

Rooms on TikTok's LIVE search tab: title, viewers, likes, owner, stream URLs (HLS/FLV).

Parameters:

• q (required)
• cursor: Value of next_cursor from the previous page; next_cursor is null on the last page.

Example parameters: {"q":"music"}

TikTok search suggestions

Endpoint /tiktok/v1/search/suggestions · 1 credit per successful call.

Parameters:

• q (required)

Example parameters: {"q":"cook"}

TikTok Top search (videos and accounts)

Endpoint /tiktok/v1/search/top · 1 credit per successful call.

Parameters:

• q (required)
• cursor: Value of next_cursor from the previous page.

Example parameters: {"q":"gordon ramsay"}

Search TikTok accounts

Endpoint /tiktok/v1/search/users · 1 credit per successful call.

TikTok's users-only search is empty for logged-out visitors, so this reads the accounts in the Top results.

Parameters:

• q (required)
• cursor: Value of next_cursor from the previous page.

Example parameters: {"q":"cooking"}

TikTok sound

Endpoint /tiktok/v1/song · 1 credit per successful call.

Parameters:

• id (required): Music ID or /music/ URL.

Example parameters: {"id":"7016547803243022337"}

Videos using a TikTok sound

Endpoint /tiktok/v1/song/videos · 1 credit per successful call.

Parameters:

• id (required)
• cursor: Value of next_cursor from the previous page.

Example parameters: {"id":"7016547803243022337"}

Trending TikTok videos

Endpoint /tiktok/v1/trending · 1 credit per successful call.

explore: TikTok's Explore feed for a category (category: a name from /tiktok/v1/explore/categories, e.g. food, or its id); foryou: the For You feed logged-out visitors get. Each page is a new batch of videos; pass next_cursor back for more. country picks the region of the feed (US default; another country's first call is slower).

Parameters:

• source: explore or foryou.
• count
• category: Explore category name or id (explore only), e.g. food, comedy, sports, 111.
• country: Two-letter country of the feed (explore only), default US.
• cursor: Value of next_cursor from the previous page; next_cursor is null on the last page.

TikTok trending hashtags (Creative Center)

Endpoint /tiktok/v1/trends/hashtags · 1 credit per successful call.

Top trending hashtags from TikTok Creative Center for a country and period: rank, posts, views, a daily popularity curve and the top creators using each one. Logged out, TikTok shows the top 3 per country and period; the full ranking needs a TikTok for Business login. available_filters lists the countries and industries the page offers.

Parameters:

• country: Two-letter country code (default US); see available_filters.hashtagCountry.
• period — one of 7, 30, 120: Days to rank over.
• industry: Industry id from available_filters.industry.

TikTok user collections

Endpoint /tiktok/v1/user/collections · 1 credit per successful call.

An account's public collections (the Favorites tab). Videos of a collection: /tiktok/v1/collection/videos.

Parameters:

• username (required)
• cursor: Value of next_cursor from the previous page; next_cursor is null on the last page.

Example parameters: {"username":"tiktok"}

TikTok followers

Endpoint /tiktok/v1/user/followers · 1 credit per successful call.

Parameters:

• username (required)
• cursor: Value of next_cursor from the previous page.

Example parameters: {"username":"khaby.lame"}

Accounts a TikTok user follows

Endpoint /tiktok/v1/user/following · 1 credit per successful call.

Parameters:

• username (required)
• cursor: Value of next_cursor from the previous page.

Example parameters: {"username":"khaby.lame"}

TikTok user liked videos

Endpoint /tiktok/v1/user/liked · 1 credit per successful call.

The Liked tab, 30 per page (pass next_cursor back as cursor). Most accounts keep it private: then private: true and no videos.

Parameters:

• username (required)
• cursor: Value of next_cursor from the previous page (logged out, TikTok serves about two pages).

Example parameters: {"username":"nasa"}

Is a TikTok account live

Endpoint /tiktok/v1/user/live · 1 credit per successful call.

Parameters:

• username (required)

Example parameters: {"username":"tiktok"}

TikTok user playlists

Endpoint /tiktok/v1/user/playlists · 1 credit per successful call.

Parameters:

• username (required)
• cursor: Value of next_cursor from the previous page.

Example parameters: {"username":"nba"}

TikTok user reposts

Endpoint /tiktok/v1/user/reposts · 1 credit per successful call.

Videos the account reposted (the Reposts tab), as a logged-out visitor sees them, 30 per page; pass next_cursor back as cursor.

Parameters:

• username (required)
• cursor: Value of next_cursor from the previous page (logged out, TikTok serves about two pages).

Example parameters: {"username":"nasa"}

Related TikTok videos

Endpoint /tiktok/v1/video/related · 1 credit per successful call.

The related videos TikTok shows next to a video (about 16).

Parameters:

• url (required): Video URL or id.
• count: Up to 30 (default 16).

Example parameters: {"url":"https://www.tiktok.com/@nasa/video/7697300954667994381"}

TikTok video transcript (TikTok captions)

Endpoint /tiktok/v1/video/transcript · 1 credit per successful call.

TikTok's own captions (WebVTT): auto-generated (ASR) or uploaded tracks, read from the video page. languages lists every track; language picks one (default en).

Parameters:

• url (required)
• language

Example parameters: {"url":"https://www.tiktok.com/@x/video/7688809734673108237"}

Support

Questions, bugs or a missing field? Open an issue in this Actor's Issues tab and we will reply there.

Public data only: nothing behind a login. You are responsible for how you use the data you collect.