User › Liked
Returns the videos a TikTok account has liked, newest first, each carrying its own third party author, engagement counts, caption, and a playable URL.
Use it for what an account likes, not for who liked a post: that direction does not exist on TikTok. Most accounts hide the list, and a hidden list is a refunded not found.
20 credits per call.
Re-running the exact same call within 6h is free.
Paginates by cursor — see Pagination.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
TikTok username without the @ symbol. Provide at least one of: handle, user_id.
TikTok numeric user ID. Use this for faster responses. Provide at least one of: handle, user_id.
Cursor from the previous response to fetch the next page of liked videos.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/tiktok/user/liked"{ "success": true, "platform": "instagram", "endpoint": "/v1/instagram/profile/posts", "data": { "items": [ "…" ], "dropped": 0 }, "pagination": { "next_cursor": "is2.eyJwIjoyfQ", "has_more": true, "page_size": 12 }, "credits_used": 20, "credits_remaining": 9980, "request_id": "req_1a2b3c4d5e6f", "cached": false, "idempotent_replay": false, "charge_reason": "miss", "free_call": false}User › Following GET
Returns a page of accounts a TikTok user follows, each with username, display name, avatar, and its own follower count. Use it to list who an account follows and page through them; user/followers returns the reverse, the accounts that follow it. **20 credits** per call. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).
User › Live GET
Returns a TikTok account's live room in the platform's own shape: cover image, title, start time, status code, viewer and entry counts, stream ids, and the host's profile. Use it to read a creator's live room state, but check status and start time yourself, since a room may still be returned after the broadcast has ended. **20 credits** per call. Re-running the exact same call within 24h is free.