Followers

GET/v1/tiktok/user/followers1 credit

Returns the accounts that follow a TikTok user, 30 per page, with their profile details and counts.

01Query parameters

Name	Type	Description
handleoptional	string	The account's username, with or without `@`, or its profile URL. One of `handle` or `user_id` is required; when both are given, `handle` is used.
user_idoptional	string	The account's numeric user id. One of `handle` or `user_id` is required.
min_timeoptional	integer	The `min_time` value of the previous page, to get the next one.
trimoptional	boolean	Accepted for compatibility; this endpoint always returns the same user objects.Default: `false`

02Request

curl "https://api.scrapesocial.ai/v1/tiktok/user/followers?handle=tiktok" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/tiktok/user/followers?handle=tiktok

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "extra": {
    "fatal_item_ids": [],
    "logid": "2026102601104261A9C327FC18DE40236E",
    "now": 1792948242000
  },
  "followers": [
    {
      "avatar_larger": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-alisg-avt-0068/3396e9b4f258118baabb0a5fd49c7ade",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/3396e9b4f258118baabb0a5fd49c7ade~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=864d86ce&x-expires=1793120400&x-signature=h5l9%2F%2FD%2F9zkCe6zp%2FRVYZwLUWu0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_medium": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-alisg-avt-0068/3396e9b4f258118baabb0a5fd49c7ade",
        "url_list": [
          "https://p19-common-sign.tiktokcdn.com/tos-alisg-avt-0068/3396e9b4f258118baabb0a5fd49c7ade~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=6f5ec199&x-expires=1793120400&x-signature=K24BGeJoiKPsL239WNFHwEpE1CQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_thumb": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-alisg-avt-0068/3396e9b4f258118baabb0a5fd49c7ade",
        "url_list": [
          "https://p19-common-sign.tiktokcdn.com/tos-alisg-avt-0068/3396e9b4f258118baabb0a5fd49c7ade~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=3d4b827b&x-expires=1793120400&x-signature=GMqJAfx%2Bs6qYYqC%2BScCfJuoHMwk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_uri": "tos-alisg-avt-0068/3396e9b4f258118baabb0a5fd49c7ade",
      "aweme_count": 3,
      "comment_setting": 0,
      "download_setting": 0,
      "duet_setting": 0,
      "favoriting_count": 112,
      "follower_count": 80,
      "following_count": 7,
      "nickname": "Y　E　A　S　I　N　ツ",
      "sec_uid": "MS4wLjABAAAAds9B8igFl27brRE73loCBpDsKiaq8bl_OmTxfiFpUF3suKxKFax6bzZBtP6o7hbV",
      "secret": 0,
      "signature": "",
      "stitch_setting": 0,
      "total_favorited": 66,
      "uid": "7699789640761803796",
      "unique_id": "ewryeasin786",
      "verification_type": 0
    },
    {
      "avatar_larger": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-alisg-avt-0068/227deb7ce6cfa40112969cd557303516",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/227deb7ce6cfa40112969cd557303516~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=7cdb659d&x-expires=1793120400&x-signature=bZqi6XbGXKsCVrPkTEPibJ7CbY0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_medium": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-alisg-avt-0068/227deb7ce6cfa40112969cd557303516",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/227deb7ce6cfa40112969cd557303516~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=8ae90621&x-expires=1793120400&x-signature=RfCovfx654n5OJMT%2FwfODxZgNyI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_thumb": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-alisg-avt-0068/227deb7ce6cfa40112969cd557303516",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/227deb7ce6cfa40112969cd557303516~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=14a2784f&x-expires=1793120400&x-signature=FCqUuoRh7dTQCHYI1mm4k4IKDsk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_uri": "tos-alisg-avt-0068/227deb7ce6cfa40112969cd557303516",
      "aweme_count": 5,
      "comment_setting": 1,
      "download_setting": 3,
      "duet_setting": 3,
      "favoriting_count": 177,
      "follower_count": 6,
      "following_count": 60,
      "nickname": "Onthatile Moloi",
      "sec_uid": "MS4wLjABAAAA0zDIk-0wYxqYTL-i0iKR1OzZSJ1ch_xXrhAbfPBCJj89qEnWuQ-RTsyCfyBXi82B",
      "secret": 0,
      "signature": "",
      "stitch_setting": 3,
      "total_favorited": 5,
      "uid": "7698422450481021972",
      "unique_id": "onthatile.moloi6",
      "verification_type": 0
    }
  ],
  "has_more": true,
  "log_pb": {
    "impr_id": "2026102601104261A9C327FC18DE40236E"
  },
  "max_time": 1792948242,
  "min_time": 1792948199,
  "myself_user_id": "0",
  "next_page_token": "eyJtYXhfY3Vyc29yIjoxNzkyOTQ4MjQyLCJtaW5fY3Vyc29yIjoxNzkyOTQ4MTk5fQ==",
  "offset": 0,
  "status_code": 0,
  "status_msg": "",
  "total": 96441361
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Followers are in `followers`; `total` is the follower count. To page, send the response's `min_time` back as `min_time` while `has_more` is true. Pages can overlap, so de-duplicate by `uid`. An unknown account is a free 404; a page with nobody in it is an empty list for 0 credits. The endpoint can answer a free 503 when it is temporarily unavailable; retry later.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.