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.
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 }}