{ "info": { "name": "TikLiveAPI", "description": "Official Postman Collection for TikLiveAPI. Extract TikTok data in real-time.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "Users Endpoints", "item": [ { "name": "User ID", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/userid/?username=tiktok", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "userid" ], "query": [ { "key": "username", "value": "tiktok", "description": "" } ] }, "description": "Retrieve the unique numeric User ID (UID) for any TikTok user by providing their username. Essential for subsequent API requests. The response is a single JSON object with the id field, for example {\"id\": \"107955\"} for the official tiktok account. Store this ID once per account: /user-posts/, /user-followers/, /user-following/ and both info endpoints all key off the numeric userid rather than the handle, and handles can change while the ID never does." } }, { "name": "User Info by Username", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/userinfo-by-username/?username=tiktok", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "userinfo-by-username" ], "query": [ { "key": "username", "value": "tiktok", "description": "" } ] }, "description": "Fetch detailed user profile information including bio, stats (followers, heart count), nickname, and verified status using a username. Returns two blocks in one call: a user object with id, uniqueId, nickname, signature (the bio), avatar URLs in three sizes, verified, privateAccount, secUid, createTime (account creation as a Unix timestamp) and bioLink when the account has set one, plus a stats object with followerCount, followingCount, heartCount, videoCount and diggCount. This is the go-to endpoint for influencer vetting and profile enrichment when all you have is a handle." } }, { "name": "User Info by ID", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/userinfo-by-id/?userid=107955", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "userinfo-by-id" ], "query": [ { "key": "userid", "value": "107955", "description": "" } ] }, "description": "Get comprehensive user profile details such as follower count, total likes, bio, secUid and account creation time (createTime) using the unique numeric User ID. The response shape is identical to the username variant - a user block and a stats block - so the two endpoints share one parser. Use this one when you already store numeric IDs and want to refresh follower counts on a schedule without resolving handles again, for example in a daily competitor-tracking snapshot." } }, { "name": "User Posts", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/user-posts/?userid=107955", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "user-posts" ], "query": [ { "key": "userid", "value": "107955", "description": "" } ] }, "description": "Retrieve a list of video posts from a specific TikTok user, including video play URL, cover image, stats, and description. Each entry in the videos array carries play (clean MP4 URL), wmplay (watermarked), cover images, duration, create_time, a nested music_info block, and live counters: play_count, digg_count, comment_count, share_count, download_count and collect_count. Loop on the returned cursor while hasMore is true to walk the entire public channel, newest first." } }, { "name": "User Followers", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/user-followers/?userid=6763595241277129734", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "user-followers" ], "query": [ { "key": "userid", "value": "6763595241277129734", "description": "" } ] }, "description": "Get the complete list of followers for a specific TikTok user. Access user profiles of followers for deeper audience analysis. Each follower is a full profile object - unique_id, nickname, region, avatar, verified, follower_count, following_count and aweme_count (post count) - alongside a total for the account. Pagination is time-based: pass the time value from the previous response to fetch the next page of up to 200. Region and count fields make this the raw material for audience-quality and fake-follower audits." } }, { "name": "User Following", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/user-following/?userid=6763595241277129734", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "user-following" ], "query": [ { "key": "userid", "value": "6763595241277129734", "description": "" } ] }, "description": "Retrieve the list of accounts that a specific TikTok user is following. Analyze user interests and network connections. The followings array mirrors the follower object shape - unique_id, nickname, region, verified and full stat counts per account - with a total and time-based pagination up to 200 per page. Following lists reveal partnerships, brand relationships and interest graphs that follower lists cannot show." } }, { "name": "User Search", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/search-user/?keyword=tiktok", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "search-user" ], "query": [ { "key": "keyword", "value": "tiktok", "description": "" } ] }, "description": "Search for TikTok users by keyword or username. Find profiles matching your search criteria with detailed user snippets. Each hit in user_list bundles a user object and a stats object, so follower counts arrive inline and you can rank candidates without a second lookup per profile. Page with cursor and hasMore. Typical uses: seeding an influencer-discovery pipeline by niche keyword, or locating a brand account and its imitators in one pass." } }, { "name": "User Collections", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/user-collections/?userid=107955", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "user-collections" ], "query": [ { "key": "userid", "value": "107955", "description": "" } ] }, "description": "Retrieve a list of public collections (favorites) created by a specific TikTok user, including each collection's title and video count. The collection_list array returns id, name, state and video_count per collection, with cursor pagination. Feed a collection id into /collection-posts/ to enumerate the saved videos - together the two calls expose what a creator curates, which is often a stronger interest signal than what they post." } }, { "name": "User Liked Posts", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/user-liked/?userid=7251316607308678170", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "user-liked" ], "query": [ { "key": "userid", "value": "7251316607308678170", "description": "" } ] }, "description": "Access the list of videos that a specific TikTok user has liked. Note: The user's liked videos must be public. Returns the same rich video objects as /user-posts/ - media URLs, music_info and the full engagement counters - with a timestamp-style cursor and hasMore for paging. Most accounts hide their likes, so treat an empty result as the normal case and the public ones as bonus behavioural signal." } }, { "name": "User Playlists (Mix)", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/user-playlists/?userid=107955", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "user-playlists" ], "query": [ { "key": "userid", "value": "107955", "description": "" } ] }, "description": "Browse and retrieve all public playlists created by a specific TikTok user. Discover their personal video collections and curated series. The mix_list array gives id, name and type per playlist, paged with cursor and hasMore. Pass any id to /playlist-posts/ for the full video sequence, or to /playlist-info/ for its metadata - useful for mapping how a creator organises episodic or series content." } }, { "name": "User Stories", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/user-stories/?userid=78234114527", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "user-stories" ], "query": [ { "key": "userid", "value": "78234114527", "description": "" } ] }, "description": "Retrieve active stories posted by a specific TikTok user. Access temporary video content before it expires. Stories come back as standard video objects - cover, play and wmplay URLs, duration, music_info and engagement counts - with a millisecond-timestamp cursor. Because stories vanish after 24 hours, poll this endpoint on a schedule and archive the media URLs promptly if retention matters to your pipeline." } } ] }, { "name": "Posts (Videos) Endpoints", "item": [ { "name": "Post Detail", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/post-detail/?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7460937381265411370", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "post-detail" ], "query": [ { "key": "url", "value": "https://www.tiktok.com/@tiktok/video/7460937381265411370", "description": "" } ] }, "description": "Get in-depth details for a specific TikTok post (video). Includes stats, music info, author data, and no-watermark download URLs. One call with the public video URL returns everything TikTok shows on the page and more: play, wmplay and hdplay media URLs (the last one HD without watermark), file sizes, cover stills, create_time, an author block, a music_info block, commerce flags like is_ad, and all six counters from play_count to collect_count. This is the workhorse endpoint for link-unfurling, moderation queues and single-video analytics." } }, { "name": "Post Comments", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/post-comments/?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7460937381265411370", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "post-comments" ], "query": [ { "key": "url", "value": "https://www.tiktok.com/@tiktok/video/7460937381265411370", "description": "" } ] }, "description": "Retrieve a list of comments for a specific TikTok video. Analyze audience sentiment, engagement, and direct feedback from viewers. Each comment carries id, text, create_time, digg_count (likes), reply_total and a nested user profile with unique_id, region and verified flag; the envelope adds total, cursor and hasMore. Keyed by the public video URL, capped at 50 per page - loop on cursor to drain threads of any size for sentiment models or complaint triage." } }, { "name": "Post Comment Replies", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/post-comment-replies/?video_id=7460937381265411370&comment_id=7460951322251920150", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "post-comment-replies" ], "query": [ { "key": "video_id", "value": "7460937381265411370", "description": "" }, { "key": "comment_id", "value": "7460951322251920150", "description": "" } ] }, "description": "Fetch all replies to a specific top-level comment on a TikTok video. Understand the full context of conversations and user interactions. Takes the video_id plus the parent comment_id (both returned by /post-comments/) and pages replies with the same cursor mechanics, up to 50 per call. Reply objects carry the same fields as top-level comments except reply_total, so one parser handles the whole thread tree - expand only comments with a non-zero reply_total to save credits." } }, { "name": "Post Music", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/music-posts/?music_id=6747377620087819014", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "music-posts" ], "query": [ { "key": "music_id", "value": "6747377620087819014", "description": "" } ] }, "description": "Retrieve a list of videos that use a specific music track or sound. Explore content trends for a song. Keyed by music_id, the videos array returns full video objects with engagement counters and author info, paged by cursor. Sound adoption is the earliest public trend signal on TikTok: track video_count growth via /music-info/ and sample the newest videos here to catch an audio going viral before hashtags form around it." } }, { "name": "Post Challenge", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/challenge-posts/?challenge_id=33380", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "challenge-posts" ], "query": [ { "key": "challenge_id", "value": "33380", "description": "" } ] }, "description": "Fetch trending videos associated with a specific hashtag or challenge. Analyze hashtag performance and content. Keyed by challenge_id with an optional region filter, so you can compare how the same hashtag performs across countries. Videos arrive as complete objects - media URLs, music_info, counters - ready for engagement benchmarks, UGC sourcing or brand-campaign measurement without extra lookups." } }, { "name": "Post Playlist", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/playlist-posts/?playlist_id=7516638364301265695", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "playlist-posts" ], "query": [ { "key": "playlist_id", "value": "7516638364301265695", "description": "" } ] }, "description": "Get all video posts from a specific TikTok playlist. Perfect for downloading or analyzing entire series or thematic collections. Playlists preserve creator ordering, so the videos array reflects the intended viewing sequence - valuable for episodic content where publish date does not equal episode number. Standard video objects with cursor pagination; combine with /playlist-info/ for the playlist name and video_count." } }, { "name": "Posts Collection (Favorites)", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/collection-posts/?collection_id=7394627756635573022", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "collection-posts" ], "query": [ { "key": "collection_id", "value": "7394627756635573022", "description": "" } ] }, "description": "Access all videos saved within a specific user collection. Retrieve detailed information about a user's favorite or bookmarked content. Keyed by the collection id from /user-collections/, returning full video objects with cursor paging. Collections are hand-picked bookmarks, so this feed is effectively a curated dataset assembled by the account owner - useful for research into what a community considers reference material." } }, { "name": "Post Search", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/search-video/?keyword=cat&publish_time=0&sort_by=0", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "search-video" ], "query": [ { "key": "keyword", "value": "cat", "description": "" }, { "key": "publish_time", "value": "0", "description": "" }, { "key": "sort_by", "value": "0", "description": "" } ] }, "description": "Search for TikTok videos by keyword. Filter results by publish time, relevance, or like count to find specific content. The most filterable feed in the API: publish_time windows from the past 24 hours to 6 months, sort_by relevance, like count or date, plus a region code from /region-list/. Results are full video objects with cursor paging - the standard entry point for social listening and brand-mention monitoring." } } ] }, { "name": "Music Endpoints", "item": [ { "name": "Music Info", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/music-info/?music_id=6747377620087819014", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "music-info" ], "query": [ { "key": "music_id", "value": "6747377620087819014", "description": "" } ] }, "description": "Retrieve detailed metadata for a specific music track, including title, artist, album cover, and usage statistics. Returns id, title, author, album, duration, original flag, cover art and a direct audio play URL, plus video_count - the number of videos using the sound. Poll video_count over time to plot adoption curves; a track jumping from thousands to tens of thousands of uses in days is a trend forming." } }, { "name": "Post Music", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/music-posts/?music_id=6747377620087819014", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "music-posts" ], "query": [ { "key": "music_id", "value": "6747377620087819014", "description": "" } ] }, "description": "Fetch a feed of videos that feature a specific music track. Discover how a sound is being used across TikTok. Same music_id key as /music-info/ but returns the actual videos: complete objects with author, counters and media URLs, paged by cursor. Sampling the newest entries shows how creators are remixing a sound right now - the qualitative half of the adoption curve the info endpoint quantifies." } } ] }, { "name": "Hashtag (Challenge) Endpoints", "item": [ { "name": "Challenge Info (ID)", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/challenge-info-id/?id=7551", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "challenge-info-id" ], "query": [ { "key": "id", "value": "7551", "description": "" } ] }, "description": "Retrieve detailed information about a hashtag challenge using its unique ID, including usage stats and description. Returns cha_name, desc, cover art and two headline metrics: user_count (creators who posted) and view_count (total views - the cat challenge alone exceeds a trillion). Also flags is_commerce for branded challenges. Snapshot these counters daily to measure campaign momentum." } }, { "name": "Challenge Info (Name)", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/challenge-info-name/?name=cat", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "challenge-info-name" ], "query": [ { "key": "name", "value": "cat", "description": "" } ] }, "description": "Fetch details for a specific hashtag challenge by name. Access view counts, descriptions, and related data. Identical response shape to the ID variant - cha_name, desc, user_count, view_count, is_commerce, cover - but keyed by the hashtag text itself, so it doubles as name-to-ID resolution. Resolve once, store the id, then use /challenge-posts/ for the video stream." } }, { "name": "Post Challenge", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/challenge-posts/?challenge_id=33380", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "challenge-posts" ], "query": [ { "key": "challenge_id", "value": "33380", "description": "" } ] }, "description": "Retrieve a stream of videos associated with a specific hashtag challenge. Monitor trend participation. Full video objects under the challenge_id, cursor-paged, with an optional region parameter for country-level cuts. Pair the stream with the user_count and view_count from the info endpoints to turn raw participation into a trend dashboard." } }, { "name": "Challenge Search", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/search-challenge/?keyword=cat", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "search-challenge" ], "query": [ { "key": "keyword", "value": "cat", "description": "" } ] }, "description": "Search for trending hashtags and challenges by keyword. Discover viral topics and popular tags to boost your content strategy. Each hit in challenge_list carries id, cha_name, desc, user_count, view_count and commerce flags, so you can rank tags by real usage instantly. A quick sweep across product or campaign keywords shows which related hashtags actually carry views before you commit content to them." } } ] }, { "name": "Search Endpoints", "item": [ { "name": "User Search", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/search-user/?keyword=tiktok", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "search-user" ], "query": [ { "key": "keyword", "value": "tiktok", "description": "" } ] }, "description": "Search for TikTok users by keyword. Filter results by specific criteria to find profiles, influencers, or market competitors efficiently. Every result pairs the profile with its stats block inline - follower, following, heart and video counts arrive with the handle - so ranking a niche by audience size takes one paged call rather than one lookup per candidate." } }, { "name": "Post Search", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/search-video/?keyword=cat&publish_time=0&sort_by=0", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "search-video" ], "query": [ { "key": "keyword", "value": "cat", "description": "" }, { "key": "publish_time", "value": "0", "description": "" }, { "key": "sort_by", "value": "0", "description": "" } ] }, "description": "Search TikTok videos by keyword and filter by publish time or sort order - relevance, like count, or date posted - to surface exactly the posts you need. Combine publish_time windows (24 hours to 6 months), sort_by and a region code to build precise monitoring queries - for example, this-week videos mentioning your brand in one country, sorted by likes. Full video objects with cursor paging make it the backbone of alerting pipelines." } }, { "name": "Challenge Search", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/search-challenge/?keyword=cat", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "search-challenge" ], "query": [ { "key": "keyword", "value": "cat", "description": "" } ] }, "description": "Search for challenges and hashtags by keyword to find trending topics. Essential for discovering viral content and popular tags. Results include per-tag usage metrics - user_count and view_count in challenge_list - so the difference between a dormant hashtag and a live trend is visible in the response itself, before you open a single video." } } ] }, { "name": "Playlist (Mix) Endpoints", "item": [ { "name": "Playlist Info", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/playlist-info/?playlist_id=7516638364301265695", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "playlist-info" ], "query": [ { "key": "playlist_id", "value": "7516638364301265695", "description": "" } ] }, "description": "Retrieve metadata for a specific TikTok playlist, including its name, type, creator handle and video count, in one compact JSON object. The fields are id, name, type, creator_unique_id and video_count - one cheap call to decide whether a playlist is worth enumerating with /playlist-posts/, or to verify a series is still growing since your last crawl." } }, { "name": "Post Playlist", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/playlist-posts/?playlist_id=7516638364301265695", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "playlist-posts" ], "query": [ { "key": "playlist_id", "value": "7516638364301265695", "description": "" } ] }, "description": "Fetch all video posts contained within a specific playlist. Access the full sequence of videos for downloading or analysis. The videos arrive in playlist order as standard video objects - media URLs, the music audio URL, engagement counters - with cursor paging; this feed carries no nested music_info block. The returned cursor can run ahead of the number of videos received, so always pass back the cursor you were given. Because creators arrange playlists deliberately, ordinal position here often matters more than create_time for series and tutorial content." } }, { "name": "User Playlists (Mix)", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/user-playlists/?userid=107955", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "user-playlists" ], "query": [ { "key": "userid", "value": "107955", "description": "" } ] }, "description": "Retrieve all public playlists created by a specific user. Explore their curated video series and discover new content collections. Returns the mix_list with id, name and type per playlist under the numeric userid, cursor-paged. The listing is the index; feed ids onward to /playlist-info/ and /playlist-posts/ to materialise each series." } } ] }, { "name": "Download Endpoints", "item": [ { "name": "Download Video", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/download-video/?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7460937381265411370", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "download-video" ], "query": [ { "key": "url", "value": "https://www.tiktok.com/@tiktok/video/7460937381265411370", "description": "" } ] }, "description": "Download high-quality TikTok videos without watermarks. Retrieve direct download links for content archiving. The response is deliberately minimal: video (clean MP4) and video_hd (high definition) as direct CDN URLs, keyed by the public video URL. Fetch the files promptly - CDN links are signed and expire - and you have watermark-free media for archiving, editing or model training without any page scraping." } }, { "name": "Download Music", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/download-music/?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7460937381265411370", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "download-music" ], "query": [ { "key": "url", "value": "https://www.tiktok.com/@tiktok/video/7460937381265411370", "description": "" } ] }, "description": "Extract and download the audio track (MP3) from a TikTok video. Get the original sound in high quality. Returns a single music field holding a direct audio URL for the video you pass in - original sounds included, not just licensed tracks. The audio side of an archiving pipeline: pair it with /download-video/ when you need both streams stored separately." } } ] }, { "name": "Collection Endpoints", "item": [ { "name": "Collection Info", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/collection-info/?collection_id=7394627756635573022", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "collection-info" ], "query": [ { "key": "collection_id", "value": "7394627756635573022", "description": "" } ] }, "description": "Retrieve metadata for a specific TikTok user collection, including its title, creator, state and video count, in one compact JSON object. The fields are id, name, creator_user_id, creator_username, state and video_count, which tell you who assembled the collection and how big it is before you spend credits enumerating it with /collection-posts/." } }, { "name": "Posts Collection (Favorites)", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/collection-posts/?collection_id=7394627756635573022", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "collection-posts" ], "query": [ { "key": "collection_id", "value": "7394627756635573022", "description": "" } ] }, "description": "Fetch all video posts saved within a specific collection. Access aggregated favorite content for analysis or personal archiving. Standard video objects under the collection id, cursor-paged. Collections are curated by hand, so the feed doubles as a human-filtered dataset - what one account considered worth keeping, with full metadata and media URLs per entry." } }, { "name": "User Collections", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/user-collections/?userid=107955", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "user-collections" ], "query": [ { "key": "userid", "value": "107955", "description": "" } ] }, "description": "Retrieve a list of public collections belonging to a specific user. Explore specific user's curated favorites. The collection_list gives id, name, state and video_count per collection with cursor paging - the discovery step before /collection-info/ and /collection-posts/ turn each entry into its full contents." } } ] }, { "name": "Region Endpoints", "item": [ { "name": "Region List", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/region-list/", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "region-list" ], "query": [] }, "description": "Retrieve a comprehensive list of supported country codes and regions. Use these codes to filter search results and localized content. Returns a flat map of ISO-style codes (AD, AE, AF ... US) to region names, and costs nothing to cache - fetch it once at deploy time. These codes drive the region parameter on /search-video/, /search-user/ and /challenge-posts/, unlocking per-country trend comparisons." } } ] }, { "name": "Ads Endpoints", "item": [ { "name": "Ads Detail", "request": { "method": "GET", "header": [ { "key": "X-Api-Key", "value": "YOUR_API_KEY", "type": "text", "description": "Your secret API Key" }, { "key": "Accept", "value": "application/json", "type": "text", "description": "Force JSON response" } ], "url": { "raw": "https://api.tikliveapi.com/ads-detail/?url=https%3A%2F%2Fads.tiktok.com%2Fbusiness%2Fcreativecenter%2Ftopads%2F7221117041168252930%2F", "protocol": "https", "host": [ "api", "tikliveapi", "com" ], "path": [ "ads-detail" ], "query": [ { "key": "url", "value": "https://ads.tiktok.com/business/creativecenter/topads/7221117041168252930/", "description": "" } ] }, "description": "Fetch detailed data for a specific TikTok advertisement, including creative assets, advertiser info, and performance metrics. One ad id returns the creative and the context: brand_name, title, landing_page URL, industry_key and objective_key labels, a video_info block with playable URLs, plus performance signals - like, comment, share, ctr and a cost tier. Competitive ad intelligence that normally requires the Creative Center UI, as JSON." } } ] } ] }