API referenceTikTok
TikTok user followers
The accounts following a creator.
total on the response carries the full follower count, so the gap between
it and what pagination reaches is always visible.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 2.4s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/tiktok-user-followers-v4" \ -H "Content-Type: application/json" \ -d '{ "unique_id": "tiktok", "count": 50 }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "followers": [ { "avatar_larger": { "height": null, "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/ea41d131ac51dd0318f47880765b7da2~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=e0b25e07&x-expires=1787572800&x-signature=Q6S%2BGNDquP8HPpTmM%2FK1YvpoAuA%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5", "url_list": [ "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/ea41d131ac51dd0318f47880765b7da2~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=e0b25e07&x-expires=1787572800&x-signature=Q6S%2BGNDquP8HPpTmM%2FK1YvpoAuA%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5" ], "url_prefix": null, "width": null }, "avatar_medium": { "height": null, "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/ea41d131ac51dd0318f47880765b7da2~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=e0b25e07&x-expires=1787572800&x-signature=Q6S%2BGNDquP8HPpTmM%2FK1YvpoAuA%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5", "url_list": [ "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/ea41d131ac51dd0318f47880765b7da2~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=e0b25e07&x-expires=1787572800&x-signature=Q6S%2BGNDquP8HPpTmM%2FK1YvpoAuA%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5" ], "url_prefix": null, "width": null }, "avatar_thumb": { "height": null, "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/ea41d131ac51dd0318f47880765b7da2~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=e0b25e07&x-expires=1787572800&x-signature=Q6S%2BGNDquP8HPpTmM%2FK1YvpoAuA%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5", "url_list": [ "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/ea41d131ac51dd0318f47880765b7da2~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=e0b25e07&x-expires=1787572800&x-signature=Q6S%2BGNDquP8HPpTmM%2FK1YvpoAuA%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5" ], "url_prefix": null, "width": null }, "aweme_count": 5, "create_time": null, "favoriting_count": 68, "follower_count": 20, "following_count": 9, "language": null, "nickname": "ηαηα", "region": "ID", "sec_uid": "MS4wLjABAAAA-soQD5GLdru3xeeDKRfcPQ-kYDgoQyy54M-OIkg1SZqz_7TBFH1Urnj6EhAXYF8E", "secret": false, "signature": "WHEN YA!!\njust enjoy🤙🏻", "total_favorited": 123, "uid": "7541971003112277009", "unique_id": "oioinay_", "verified": false }, { "avatar_larger": { "height": null, "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/e0e8295f4e065c480ee5d097074323a4~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=76f0b5ef&x-expires=1787572800&x-signature=74BRLAYr8rG0%2Bfw7GGCP3S2BBAc%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5", "url_list": [ "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/e0e8295f4e065c480ee5d097074323a4~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=76f0b5ef&x-expires=1787572800&x-signature=74BRLAYr8rG0%2Bfw7GGCP3S2BBAc%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5" ], "url_prefix": null, "width": null }, "avatar_medium": { "height": null, "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/e0e8295f4e065c480ee5d097074323a4~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=76f0b5ef&x-expires=1787572800&x-signature=74BRLAYr8rG0%2Bfw7GGCP3S2BBAc%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5", "url_list": [ "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/e0e8295f4e065c480ee5d097074323a4~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=76f0b5ef&x-expires=1787572800&x-signature=74BRLAYr8rG0%2Bfw7GGCP3S2BBAc%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5" ], "url_prefix": null, "width": null }, "avatar_thumb": { "height": null, "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/e0e8295f4e065c480ee5d097074323a4~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=76f0b5ef&x-expires=1787572800&x-signature=74BRLAYr8rG0%2Bfw7GGCP3S2BBAc%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5", "url_list": [ "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/e0e8295f4e065c480ee5d097074323a4~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=76f0b5ef&x-expires=1787572800&x-signature=74BRLAYr8rG0%2Bfw7GGCP3S2BBAc%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=65db1d19&idc=useast5" ], "url_prefix": null, "width": null }, "aweme_count": 1, "create_time": null, "favoriting_count": 3860, "follower_count": 74, "following_count": 1403, "language": null, "nickname": "Rettob Kaimer", "region": "ID", "sec_uid": "MS4wLjABAAAAZJc7XmXUbiGWeS4GpcAVzAQo9Q966h6USRTtVPN3leySuh8aoo1ivpVhUZ6du8sD", "secret": false, "signature": "bantu follow", "total_favorited": 4, "uid": "7640558104783045652", "unique_id": "rettobkaimerrettob", "verified": false }, "… 48 more items in the full response" ], "has_more": true, "min_time": "1787486459", "total": 95356695, "unique_id": "tiktok", "user_id": "107955" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-user-followers-v4", "billable": true, "duration_ms": 1328 }}