Unif API Docs

TikTok API

Public-data TikTok endpoints.

Public-data TikTok endpoints.

When To Use This API

The TikTok API is for agent workflows that need public, platform-native data without writing a custom collector for every task. Use it when a prompt needs evidence from live social records, when a Skill needs repeatable enrichment, or when product code needs the same contract an agent discovered through MCP.

This section lists 20 live TikTok operations from the canonical OpenAPI spec. Each operation page documents the route, method, parameters, response envelope, pagination behavior when available, and the error vocabulary shared across UnifAPI.

  • Analyze public TikTok videos, users, comments, hashtags, music, feeds, and search results.
  • Power creator discovery, trend research, and campaign vetting Skills with canonical video and user records.
  • Resolve TikTok URLs or ids into normalized data that can be priced, ranked, and cited by an agent.

Agent Contract Notes

Agents usually discover these endpoints with the hosted UnifAPI MCP server, inspect the operation schema, then call only the records needed for the current task. Developers can call the same endpoints over HTTP with an API key, which makes the path from exploratory agent run to production integration direct.

Every successful response uses a stable envelope with a request id, data payload, optional pagination cursor, and billing metadata. Errors use the same closed vocabulary across platforms, so retry logic, user-facing explanations, and cost reporting can stay consistent even when a workflow spans multiple public-data sources.

When you are choosing an operation, start from the public identifier the user already has: a profile username, post id, channel id, subreddit name, search term, or URL-derived slug. Prefer the narrowest endpoint that answers the question, then expand only when the agent needs more evidence. This keeps record usage predictable, makes citations easier to explain, and avoids turning a focused research task into an expensive crawl.

Operations

Feeds

  • POST /tiktok/feed/recommended — Get TikTok recommendation videos — Return a batch of videos from TikTok's recommendation feed for a given region.

Hashtags

  • GET /tiktok/hashtags/{id} — Get a TikTok hashtag by ID — Return a TikTok hashtag (challenge) by its numeric ID, including its title, description, and aggregate view count.
  • GET /tiktok/hashtags/{id}/videos — List videos tagged with a TikTok hashtag — Return the videos tagged with a given TikTok hashtag, by hashtag ID, as a cursor-paginated list.

Music

  • GET /tiktok/music/{id} — Get a TikTok music track by ID — Return a TikTok sound (music track) by its numeric ID, including title, author, and usage stats.
  • GET /tiktok/music/{id}/videos — List videos using a TikTok music track — Return the videos that use a given TikTok sound, by music ID, as a cursor-paginated list.
  • GET /tiktok/search/hashtags — Search TikTok hashtags by keyword — Search TikTok hashtags by keyword, returning matching hashtags with their metadata as a cursor-paginated list.
  • GET /tiktok/search — General TikTok search (returns videos) — Returns TikTok videos for the keyword q.
  • GET /tiktok/search/users — Search TikTok users by keyword — Search TikTok accounts by keyword, returning matching public profiles as a cursor-paginated list.
  • GET /tiktok/search/videos — Search TikTok videos by keyword — Returns a paginated list of TikTok videos matching the keyword q.

Users

  • GET /tiktok/users/{id}/followers — List a TikTok user's followers — Return a paginated list of the accounts that follow a given TikTok user, identified by sec_uid, numeric ID, or handle.
  • GET /tiktok/users/{id}/following — List users a TikTok user is following — Return a paginated list of the accounts a given TikTok user follows, identified by sec_uid, numeric ID, or handle.
  • GET /tiktok/users/{id}/likes — List videos liked by a TikTok user — Returns a paginated list of videos the user has liked where the user has made their likes public.
  • GET /tiktok/users/{id} — Get a TikTok user profile — Returns the canonicalized public profile for the TikTok user with the given sec_uid, numeric user id, or handle.
  • GET /tiktok/users/{id}/videos — List videos posted by a TikTok user — Returns a paginated list of public videos posted by the user.
  • GET /tiktok/users/resolve — Resolve a TikTok username to a user id — Accepts a public TikTok username (handle) and returns the user's stable opaque id for other /tiktok/users/{id} endpoints.

Videos

  • GET /tiktok/videos/{id}/comments/{comment_id}/replies — List replies to a TikTok comment — Return the replies to a specific comment on a TikTok video, identified by the numeric video ID and comment ID, as a cursor-paginated list.
  • GET /tiktok/videos/{id}/comments — List top-level comments on a TikTok video — Returns a paginated list of top-level comments on the given video.
  • GET /tiktok/videos/{id} — Get a TikTok video by ID — Returns canonicalized metadata for a single TikTok video.
  • POST /tiktok/videos/batch — Batch-fetch TikTok videos by ID — Return canonicalized metadata — author, captions, sound, and engagement counts — for up to 20 TikTok videos in one request, by numeric video ID.
  • GET /tiktok/videos/resolve — Resolve a TikTok share URL to a video — Accepts a TikTok share URL (long or short / vm.tiktok.com) and returns the canonical Video object.

On this page

When To Use This APIAgent Contract NotesOperationsFeedsHashtagsMusicSearchUsersVideos