Kullanıcı Arama

GET/v1/threads/search/users1 kredi

Threads hesaplarında ad veya kullanıcı adıyla arama yapar; eşleşen kullanıcıları profil fotoğrafı ve doğrulama durumuyla döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
queryzorunlu	string	Aranacak ad veya kullanıcı adı.

02İstek

curl "https://api.scrapesocial.ai/v1/threads/search/users?query=shams" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

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

GET /v1/threads/search/users?query=shams

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "users": [
    {
      "username": "shams",
      "pk": "63263616227",
      "is_active_on_text_post_app": true,
      "full_name": "Shams Charania",
      "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/v/t51.2885-19/482795192_3376548399146227_6340123271493467395_n.jpg?stp=dst-jpg_s206x206_tt6&_nc_cat=1&ccb=7-5&_nc_sid=30ff31&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=5iV0yO5IrecQ7kNvwGZ5GV9&_nc_oc=AdrDXmVqAr_6sgzVnT0ke05gJOT97Mkr2zGmCkBHWwEfg0xDQDIc7OMWAV8b99njUk8&_nc_zt=24&_nc_ht=scontent-otp1-1.cdninstagram.com&_nc_ss=7b289&o…",
      "is_verified": true,
      "has_onboarded_to_text_post_app": true,
      "id": "63263616227"
    },
    {
      "username": "shamsintwilight",
      "pk": "69648478429",
      "is_active_on_text_post_app": true,
      "full_name": "",
      "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/v/t51.82787-19/848072476_17952178884326430_3806416225879391242_n.jpg?stp=dst-jpg_s206x206_tt6&_nc_cat=105&ccb=7-5&_nc_sid=30ff31&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=Kl48D8HbRQsQ7kNvwG1iSki&_nc_oc=AdruHnZDINGxdCQIsKMIGqqd46HEA71HSXDOHDaf7fabQMzh5H8ibX0GpgHkMWGeklc&_nc_zt=24&_nc_ht=scontent-otp1-1.cdninstagram.com&_nc_gid=jS…",
      "is_verified": false,
      "has_onboarded_to_text_post_app": true,
      "id": "69648478429"
    }
  ]
}

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

Yaklaşık 8 kullanıcı, `users` listesinde. Sayfalama yoktur: her çağrı tek bir grup döndürür. Eşleşme yoksa 0 krediyle boş liste döner.

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.