Profil

GET/v1/cosmos/profile1 kredi

Bir Cosmos (cosmos.so) kullanıcısının herkese açık profilini döndürür: ad, biyografi, avatar, web sitesi, doğrulama ve premium durumu, takipçi, takip edilen ve herkese açık gönderi sayıları ile bağlı Instagram, X ve TikTok hesapları.

01Sorgu parametreleri

Ad	Tür	Açıklama
handlezorunlu	string	Cosmos kullanıcı adı, örneğin `design` (baştaki `@` veya profil URL'si de kabul edilir).

02İstek

curl "https://api.scrapesocial.ai/v1/cosmos/profile?handle=design" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

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

GET /v1/cosmos/profile?handle=design

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": 234172146,
  "username": "design",
  "full_name": "Design",
  "url": "https://www.cosmos.so/design",
  "bio": "where systems learn to speak to people",
  "avatar_url": "https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0",
  "website_url": null,
  "is_premium": true,
  "is_verified": false,
  "follower_count": 957,
  "following_count": 1,
  "public_post_count": 25,
  "instagram_url": null,
  "twitter_url": null,
  "tiktok_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

Profil alanları yanıtın en üst seviyesindedir. Bilinmeyen bir kullanıcı ücretsiz 404 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.