Platforms/TikTok
TikTok API
Read public TikTok profiles and their videos, a video's stats, comments and transcript, playlists, collections, hashtags and live rooms, as JSON. Every call reads what a logged-out visitor sees: no TikTok account and no developer app.
TikTok endpoints
13 endpoints, each a GET request with your key in the x-api-key header.
| Endpoint | Request | Returns |
|---|---|---|
| Profile | GET /v1/tiktok/profile?handle=mrbeast | A profile's card: name, bio, followers, likes and video count. |
| Profile videos | GET /v1/tiktok/profiles/videos?handle=mrbeast | A profile's videos and photo posts, the newest first, up to 15 a page. |
| Profile playlists | GET /v1/tiktok/profiles/playlists?handle=mrbeast | A profile's playlists, 20 a page: their names and video counts. |
| Profile live | GET /v1/tiktok/profiles/live?handle=mrbeast | Whether a profile is live now, with its live room's details when it is. |
| Video | GET /v1/tiktok/videos?video_id=7587811642650545421 | A video or photo post: its caption, counts, author, sound, hashtags, mentions and caption tracks. |
| Video comments | GET /v1/tiktok/videos/comments?video_id=7596844935442189598 | A video's comments, up to 50 a page, in TikTok's order, each with its reply count. |
| Comment replies | GET /v1/tiktok/videos/comments/replies?comment_id=7596851467001119502&video_id=7596844935442189598 | A comment's replies, up to 50 a page. |
| Video transcript | GET /v1/tiktok/videos/transcript?video_id=7587811642650545421 | A video's captions, as one text and as timed segments. |
| Playlist videos | GET /v1/tiktok/playlists?playlist_id=7596415294902389534 | A playlist's videos, 30 a page, in its order. |
| Collection videos | GET /v1/tiktok/collections?collection_id=7665668414573546258 | A collection's videos, 30 a page: favorites its owner made public as a collection. |
| Hashtag | GET /v1/tiktok/hashtags?tag=fyp | A hashtag's details: its description, video count and views. |
| Search suggestions | GET /v1/tiktok/search/suggestions?q=dogs | The searches TikTok suggests for what has been typed so far, usually 10. |
| Live | GET /v1/tiktok/live?room_id=7260668776968964907 | A live room's details: its title, whether it is live, viewers, likes and host. |
Your first request
Save your key and the base URL, then call the profile endpoint:
export API_KEY="your-api-key"
export API_URL="https://api.socialparse.dev"
curl -H "x-api-key: $API_KEY" "$API_URL/v1/tiktok/profile?handle=mrbeast"Every answer has the same envelope on every platform: data, page for the next page, and meta. See Responses and Errors.
Compared with TikTok's own API
TikTok's Display API returns only the signed-in user's own videos, and its Research API is for approved non-commercial researchers. Social Parse needs neither: it reads the public pages, and you pay per successful call.
Pricing
One credit per successful call, whichever endpoint; errors cost nothing and credits never expire. New accounts start with 100 free credits. See pricing for the packs.
FAQ
Do I need TikTok credentials or developer approval?
No. Social Parse reads TikTok's public pages as a logged-out visitor does, so you only need an API key.
What does each TikTok call cost?
One credit per successful call, live or cached; a page of results is one call, and errors cost nothing. New accounts get 100 free credits.
What about private TikTok content?
Only what a logged-out visitor can see is read. Content behind a login answers 403 LOGIN_REQUIRED, and something deleted answers 404 NOT_FOUND.
How fresh is the data?
Each call reads the live page. The same call within a few minutes is answered from a short cache, and deleted content is never served from it.