Kullanıcı Koleksiyonları

GET/v1/cosmos/user/clusters1 kredi

Bir kullanıcının herkese açık koleksiyonlarından bir sayfa döndürür; her koleksiyon ad, açıklama, kapak görseli, gönderi ve takipçi sayıları ile sahibi bilgisiyle gelir.

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).
cursoristeğe bağlı	string	Sonraki sayfa için bir önceki yanıttaki `cursor` değeri. Doğrudan `null` yazılırsa ücretsiz, boş bir son sayfa döner.

02Fiyatlandırma

Sayfa başına 1 kredi. `cursor=null` boş bir son sayfa (`end_of_pagination: true`) döndürür ve 0 kredi tutar; boş bir sayfa da ücretsizdir.

03İstek

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

04Yanıtlar

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

GET /v1/cosmos/user/clusters?handle=design

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "items": [
    {
      "id": 1444486570,
      "name": "ransom note lettering",
      "slug": "ransom-note-lettering",
      "description": "cut from whatever was lying around",
      "url": "https://www.cosmos.so/design/ransom-note-lettering",
      "cover_image_url": "https://cdn.cosmos.so/13ab2335-6d21-4cbb-899d-ebb313170a71",
      "post_count": 38,
      "follower_count": 957,
      "owner": {
        "id": 234172146,
        "username": "design",
        "full_name": "Design",
        "avatar_url": "https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0"
      }
    },
    {
      "id": 1691653994,
      "name": "kids tv logos",
      "slug": "kids-tv-logos",
      "description": "all i'd want to see when school was over",
      "url": "https://www.cosmos.so/design/kids-tv-logos",
      "cover_image_url": "https://cdn.cosmos.so/a3c300f7-9e89-4f3e-914e-e8d4e4afea73?rect=0,80,324,324",
      "post_count": 48,
      "follower_count": 957,
      "owner": {
        "id": 234172146,
        "username": "design",
        "full_name": "Design",
        "avatar_url": "https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0"
      }
    }
  ],
  "total_count": 70,
  "cursor": "eyJ2MSI6IjE5NzAtMDEtMDFUMDA6MDA6MDBaIiwidjIiOiIyMDI2LTA5LTIzVDIxOjE4OjIyLjQxMDY1NloiLCJ2MyI6MTUxMDg2Mzl9",
  "has_more": true
}

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"
}

05Notlar

Koleksiyonlar `items` listesindedir (sayfa başına 20); yanında `total_count`, `cursor` ve `has_more` bulunur. Son sayfada `cursor` null, `has_more` false olur. Bilinmeyen bir kullanıcı ücretsiz 404 döner.

06Hatalar 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.