Get a TikTok user follower list
View all TikTok Profiles, Videos & Sounds API endpoints →Retrieve a list of followers for the account identified by the required user_id path parameter. Supply the numeric-looking account identifier as a string, not an @username or sec_user_id. The optional min_time query parameter is also a string, but the supplied documentation does not define its format, units, filtering behavior or continuation semantics. Omit it unless you have verified an appropriate value; do not assume it accepts a Unix timestamp or acts as a pagination cursor. The documented response is a follower list, with no named list field, follower-record fields, count, cursor or completion indicator. No observed probe response or source response example is available for this operation. Treat returned data as an observed sample, not a guaranteed complete export; differences between samples do not establish follows or unfollows, audience demographics or contact details.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/tiktok/user-followers API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tiktok/user-followers?key=<API_KEY>&user_id=127905465618821121'
Query Result
Use Cases
- Collect a bounded follower-list sample for permitted public-creator network research, subject to available visibility and returned data.
- Store follower retrieval snapshots with user_id, requested min_time and fetched_at for later audit without interpreting missing records as unfollows.
- Evaluate a follower-list ingestion pipeline by inspecting actual record fields before choosing identifier mappings and deduplication keys.
- Test continuation handling in a controlled collector only after confirming min_time semantics, without promising exhaustive audience coverage.
Frequently asked questions
Which identifier does the follower-list route require?
Supply the account's user_id as the required string path parameter. The documented value is numeric-looking, but an @username or secondary sec_user_id is not a substitute.
What does the optional min_time parameter mean?
Only its name, query location, string type and optional status are documented. Its units, expected format and filtering or pagination behavior are not established. Omit it until you have verified a suitable value; do not invent a timestamp or cursor.
Which follower fields and pagination fields are returned?
The documentation describes a follower list but names no response fields. No probe result or source response example is available, so confirm the list location, follower identifiers and any continuation or completion fields in an actual response before mapping them.
Does one request return every follower?
Complete coverage is not established. Treat the returned records as a bounded sample, respect available visibility and verify any continuation behavior before attempting to collect additional results.
Can comparing two samples reveal who unfollowed an account?
Not reliably. A follower absent from a later sample may simply be missing from that partial result. Save the request context and collection time, and describe differences as changes in observed samples rather than confirmed follow or unfollow events.