# TikTok Intel API

## Docs

- [Get posts for a hashtag challenge](https://docs.full-tiktok-api.com/api-reference/challenges/posts.md): Returns a paginated list of TikTok videos associated with the specified hashtag challenge. Challenge IDs are numeric — to find a challenge ID for a hashtag, search TikTok and extract the ID from the URL.
- [Get collection metadata by ID](https://docs.full-tiktok-api.com/api-reference/collections/info.md): Returns metadata for a TikTok user collection (playlist) including name, post count, and cover image.
- [Get posts in a collection](https://docs.full-tiktok-api.com/api-reference/collections/posts.md): Returns a paginated list of TikTok videos in the specified collection.
- [Get effect metadata by ID](https://docs.full-tiktok-api.com/api-reference/effects/info.md): Returns metadata for a TikTok AR effect including its name, publish date, usage count, and icon.
- [Get posts using an effect](https://docs.full-tiktok-api.com/api-reference/effects/posts.md): Returns a paginated list of videos that use the specified TikTok AR effect. Author and sound attribution fields are omitted from each post to reduce payload size.
- [Get creator intelligence scorecard](https://docs.full-tiktok-api.com/api-reference/intelligence/creator.md): Computes a comprehensive intelligence scorecard for a public TikTok creator based on their profile and recent posting history.
- [Check if a user is currently live](https://docs.full-tiktok-api.com/api-reference/live/alive.md): Returns a boolean `is_alive` flag indicating whether the user is currently broadcasting a live stream. Always returns 200; `is_alive` will be false if the user is not live.
- [Browse live stream categories](https://docs.full-tiktok-api.com/api-reference/live/categories.md): Returns a paginated list of top-level live browse categories, each containing sub-category tabs with viewer counts.
- [Get live room details by room ID](https://docs.full-tiktok-api.com/api-reference/live/room.md): Returns full metadata for a specific live room including the streamer profile, viewer count, and live status. Room data is cached for 2 minutes.
- [Get live streams by tag](https://docs.full-tiktok-api.com/api-reference/live/streams.md): Returns active live stream rooms associated with the given tag. Results are real-time and will vary. Stream URLs (HLS/FLV) are included when available.
- [Get place metadata by ID](https://docs.full-tiktok-api.com/api-reference/places/info.md): Returns metadata for a TikTok location/place including name, address, country, and total post count.
- [Get posts tagged at a location](https://docs.full-tiktok-api.com/api-reference/places/posts.md): Returns a paginated list of TikTok videos tagged at the specified location/place.
- [Get comments on a post](https://docs.full-tiktok-api.com/api-reference/posts/comments.md): Returns a paginated list of top-level comments for a video. Supply either `videoId` or `url` — exactly one is required. Use the returned cursor to fetch the next page.
- [Get post detail by video ID or URL](https://docs.full-tiktok-api.com/api-reference/posts/detail.md): Returns full metadata for a single TikTok video. Supply either `videoId` (the numeric ID) or `url` (a full TikTok share URL) — exactly one is required.
- [General search (top results across all types)](https://docs.full-tiktok-api.com/api-reference/search/general.md): Returns top-ranked posts matching the keyword across all content types. This mirrors TikTok's general search tab. Use `?q=` as an alias for `?keyword=`.
- [Search for live streams by keyword](https://docs.full-tiktok-api.com/api-reference/search/live.md): Returns a paginated list of active live rooms matching the keyword. Results reflect real-time availability and may vary between requests.
- [Get keyword search suggestions](https://docs.full-tiktok-api.com/api-reference/search/suggest.md): Returns an array of suggested search terms related to the input keyword. Useful for building autocomplete or discovering related topics. Also accepted as ?q=.
- [Search for users by keyword](https://docs.full-tiktok-api.com/api-reference/search/users.md): Returns a paginated list of TikTok users matching the keyword. Equivalent to TikTok's user/account search tab.
- [Search for videos by keyword](https://docs.full-tiktok-api.com/api-reference/search/videos.md): Returns a paginated list of videos matching the keyword. Equivalent to TikTok's video search tab.
- [Get sound metadata by ID](https://docs.full-tiktok-api.com/api-reference/sounds/info.md): Returns metadata for a specific TikTok sound including title, author, duration, copyright status, and how many videos have used it.
- [Browse the commercial sound library](https://docs.full-tiktok-api.com/api-reference/sounds/library.md): Returns a paginated list of commercially-licensed sounds from TikTok's sound library. Sounds can be sorted by hottest (default) or newest. Pagination uses page numbers rather than cursors.
- [Get posts using a sound](https://docs.full-tiktok-api.com/api-reference/sounds/posts.md): Returns a paginated list of TikTok videos that use the specified sound. Use the returned cursor to fetch the next page.
- [Get a user's followers](https://docs.full-tiktok-api.com/api-reference/users/followers.md): Returns a page of the user's followers. Pagination uses `max_time` rather than a cursor — pass the `next_max_time` value from the previous response as `?max_time=` to get the next page.
- [Get accounts followed by a user](https://docs.full-tiktok-api.com/api-reference/users/following.md): Returns a page of accounts the user is following. Pagination uses `max_time` — pass the `next_max_time` from the previous response as `?max_time=` to get the next page.
- [Get collections/playlists created by a user](https://docs.full-tiktok-api.com/api-reference/users/playlist.md): Returns all public collections (playlists) created by the user. Each collection includes a cover image and post count. No pagination — all collections are returned in one response.
- [Get recent posts by username](https://docs.full-tiktok-api.com/api-reference/users/posts.md): Returns a paginated list of the user's most recent posts. Use the returned cursor to fetch the next page.
- [Get user profile by username](https://docs.full-tiktok-api.com/api-reference/users/profile.md): Returns a normalized public profile for the given TikTok username. The leading @ is optional and stripped automatically. Pass ?region= to resolve region-specific profile variants.
- [Get user profile by numeric user ID](https://docs.full-tiktok-api.com/api-reference/users/profile-by-id.md): Returns a normalized public profile for the given numeric TikTok user ID. Useful when you have the user ID but not the username.
- [Get videos reposted by a user](https://docs.full-tiktok-api.com/api-reference/users/reposts.md): Returns a paginated list of videos that the user has reposted. Not all users have reposts; an empty array is a valid response.
- [Authentication](https://docs.full-tiktok-api.com/authentication.md): How to authenticate requests to the TikTok Intel API.
- [Introduction](https://docs.full-tiktok-api.com/introduction.md): Real-time TikTok data for creators, marketers, and developers.
- [Quickstart](https://docs.full-tiktok-api.com/quickstart.md): Fetch a TikTok creator profile in under two minutes.

## OpenAPI Specs

- [openapi](https://docs.full-tiktok-api.com/openapi.yaml)