Kullanıcı Arama

GET/v1/tiktok/search/users1 kredi

TikTok hesaplarını anahtar kelimeyle arar ve eşleşen kullanıcıları sayfa başına 10 adet döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
queryzorunlu	string	Arama terimi.
cursoristeğe bağlı	integer	Sonraki sayfayı almak için önceki sayfanın `cursor` 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/search/users?query=khaby" \
  -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/search/users?query=khaby

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "challenge_list": null,
  "cursor": 10,
  "extra": {
    "api_debug_info": null,
    "fatal_item_ids": [],
    "logid": "20261026011032B94034339A484D44DC9B",
    "now": 1792948233000,
    "search_request_id": "",
    "server_stream_time": 695
  },
  "feedback_type": "user",
  "global_doodle_config": {
    "display_filter_bar": 1,
    "feedback_survey": null,
    "hide_results": false,
    "hit_dolphin": false,
    "hit_shark": false,
    "keyword": "khaby",
    "new_source": "",
    "search_channel": "tiktok_user",
    "tns_search_result": "Pass"
  },
  "has_more": 1,
  "input_keyword": "khaby",
  "log_pb": {
    "impr_id": "20261026011032B94034339A484D44DC9B"
  },
  "music_list": null,
  "qc": "",
  "rid": "20261026011032B94034339A484D44DC9B",
  "status_code": 0,
  "type": 1,
  "user_list": [
    {
      "challenges": null,
      "effects": null,
      "items": null,
      "mix_list": null,
      "musics": null,
      "position": null,
      "uniqid_position": null,
      "user_info": {
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f",
          "url_list": [
            "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my3&ps=13740610&refresh_token=df858af7&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1793034000&x-signature=925raAbb8vgdchN6duAgrdYksYQ%3D",
            "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my3&ps=13740610&refresh_token=ab25539b&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1793034000&x-signature=yAO8paSM%2BQGcSVufXcKynoWuOhw%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "cover_url": null,
        "custom_verify": "Popular creator",
        "enterprise_verify_reason": "",
        "events": null,
        "follow_status": 0,
        "follower_count": 163000000,
        "followers_detail": null,
        "geofencing": null,
        "homepage_bottom_toast": null,
        "item_list": null,
        "mutual_relation_avatars": null,
        "need_points": null,
        "nickname": "Khabane lame",
        "platform_sync_info": null,
        "relative_users": null,
        "room_id": 0,
        "room_id_str": "0",
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
        "shield_edit_field_info": null,
        "total_favorited": 2691101735,
        "type_label": null,
        "uid": "127905465618821121",
        "unique_id": "khaby.lame",
        "user_profile_guide": null,
        "user_tags": null,
        "white_cover_url": null
      }
    },
    {
      "challenges": null,
      "effects": null,
      "items": null,
      "mix_list": null,
      "musics": null,
      "position": null,
      "uniqid_position": null,
      "user_info": {
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my3&ps=13740610&refresh_token=7e675d31&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1793034000&x-signature=h7Z%2FIAmi48ioSRAOiCGbisVnyNo%3D",
            "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my3&ps=13740610&refresh_token=030cba08&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1793034000&x-signature=cMJGDei633GgCKapEZ0NwXlQ7E4%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "cover_url": null,
        "custom_verify": "Verified account",
        "enterprise_verify_reason": "",
        "events": null,
        "follow_status": 0,
        "follower_count": 160300000,
        "followers_detail": null,
        "geofencing": null,
        "homepage_bottom_toast": null,
        "item_list": null,
        "mutual_relation_avatars": null,
        "need_points": null,
        "nickname": "charli d’amelio",
        "platform_sync_info": null,
        "relative_users": null,
        "room_id": 0,
        "room_id_str": "0",
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAA-VASjiXTh7wDDyXvjk10VFhMWUAoxr8bgfO1kAL1-9s",
        "shield_edit_field_info": null,
        "total_favorited": 12372225140,
        "type_label": null,
        "uid": "5831967",
        "unique_id": "charlidamelio",
        "user_profile_guide": null,
        "user_tags": null,
        "white_cover_url": null
      }
    }
  ]
}

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

Kullanıcılar `user_list` içindedir, her birinin profili `user_info` alanındadır. Sayfalamak için `has_more` 1 olduğu sürece yanıttaki `cursor` değerini `cursor` parametresiyle geri gönderin (bir ofset: 10, 20, ...). Sonuç yoksa 0 kredilik boş bir liste döner. 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.