Profil

GET/v1/tiktok/profile1 kredi

Bir TikTok hesabının herkese açık profilini döndürür: kullanıcı bilgileri (ad, biyografi, avatar, doğrulama, biyografi bağlantısı) ile takipçi, takip, beğeni ve video sayıları.

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.
cache_max_ageisteğe bağlı	string	Uyumluluk için kabul edilir; her çağrı güncel veriyle yanıtlanır. Listede olmayan bir değer ücretsiz 400 hatası döner.Kabul edilen değerler:`1d3d7d14d30d`

02İstek

curl "https://api.scrapesocial.ai/v1/tiktok/profile?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/profile?handle=tiktok

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "user": {
    "id": "107955",
    "shortId": "",
    "uniqueId": "tiktok",
    "nickname": "TikTok",
    "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=995fbd26&x-expires=1793120400&x-signature=4Uln2LWthKdh0Hwbyegf4%2Fc6CXs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
    "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=bed6c8d0&x-expires=1793120400&x-signature=o7l8LcJLbNVmSGhfKlst0Rp06jw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
    "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=ca99aabf&x-expires=1793120400&x-signature=rfQn4YeRDcDxqRptCEDm1QguoPo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my",
    "signature": "Your next discovery is waiting on TikTok.",
    "createTime": 1425144149,
    "verified": true,
    "secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
    "ftc": false,
    "relation": 0,
    "openFavorite": false,
    "bioLink": {
      "link": "tiktok.com/discovermore",
      "risk": 0
    },
    "commentSetting": 0,
    "commerceUserInfo": {
      "commerceUser": true,
      "downLoadLink": {
        "android": "",
        "ios": ""
      },
      "category": "Others",
      "categoryButton": false
    },
    "duetSetting": 0,
    "stitchSetting": 0,
    "privateAccount": false,
    "secret": false,
    "isADVirtual": false,
    "roomId": "",
    "uniqueIdModifyTime": 0,
    "ttSeller": false,
    "downloadSetting": 0,
    "profileTab": {
      "showMusicTab": true,
      "showQuestionTab": true,
      "showPlayListTab": true
    },
    "followingVisibility": 1,
    "recommendReason": "",
    "nowInvitationCardUrl": "",
    "nickNameModifyTime": 1638559600,
    "isEmbedBanned": false,
    "canExpPlaylist": true,
    "profileEmbedPermission": 1,
    "language": "en",
    "eventList": [],
    "suggestAccountBind": false,
    "isOrganization": 1,
    "UserStoryStatus": 0,
    "shortDramaCreator": {}
  },
  "stats": {
    "followerCount": 96400000,
    "followingCount": 1,
    "heart": 466100000,
    "heartCount": 466100000,
    "videoCount": 1514,
    "diggCount": 0,
    "friendCount": 1
  },
  "statsV2": {
    "followerCount": "96441334",
    "followingCount": "1",
    "heart": "466090159",
    "heartCount": "466090159",
    "videoCount": "1514",
    "diggCount": "0",
    "friendCount": "1"
  },
  "itemList": []
}

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

Yanıtta `user`, `stats` ve `statsV2` (aynı sayılar metin olarak) bulunur; `itemList` her zaman boştur, gönderiler için Profile Videos endpoint'ini kullanın. Bilinmeyen bir kullanıcı adı veya kimlik, `account_deactivated: true` ile 404 döner ve kredi düşülmez.

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.