Takipçiler

GET/v1/tiktok/user/followers1 kredi

Bir TikTok kullanıcısını takip eden hesapları, profil bilgileri ve sayılarıyla birlikte sayfa başına 30 adet döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
handleisteğe bağlı	string	Hesabın kullanıcı adı (`@` ile ya da `@` olmadan) veya profil URL'si. `handle` ya da `user_id` parametrelerinden biri zorunludur; ikisi birden verilirse `handle` kullanılır.
user_idisteğe bağlı	string	Hesabın sayısal kullanıcı kimliği. `handle` ya da `user_id` parametrelerinden biri zorunludur.
min_timeisteğe bağlı	integer	Sonraki sayfayı almak için önceki sayfanın `min_time` değeri.
trimisteğe bağlı	boolean	Uyumluluk için kabul edilir; bu endpoint her zaman aynı kullanıcı nesnelerini döndürür.Varsayılan: `false`

02İstek

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

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

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
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

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

04Notlar

Takipçiler `followers` içindedir; `total` toplam takipçi sayısıdır. Sayfalamak için `has_more` true olduğu sürece yanıttaki `min_time` değerini `min_time` parametresiyle geri gönderin. Sayfalar örtüşebilir, bu yüzden kayıtları `uid` ile tekilleştirin. Bilinmeyen bir hesap ücretsiz 404 döner; kimsenin olmadığı bir sayfa 0 kredilik boş bir listedir. Endpoint geçici olarak kullanılamadığında ücretsiz 503 dönebilir; daha sonra tekrar deneyin.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.