Kullanıcı Gönderileri

GET/v1/cosmos/user/posts1 kredi

Bir kullanıcının herkese açık Cosmos gönderilerinden (kaydedilmiş görseller ve videolar) bir sayfa döndürür; her gönderi açıklama, medya, sahip, kaydedildiği kaynak ve o kaynağın yazarıyla 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/posts?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/posts?handle=design

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "items": [
    {
      "id": 1307496415,
      "url": "https://www.cosmos.so/e/1307496415",
      "created_at": "2026-04-01T15:24:45.897845Z",
      "caption": null,
      "text": null,
      "title": null,
      "description": null,
      "owner": {
        "id": 14413015,
        "username": "esther.yang"
      },
      "source_url": null,
      "source_author": null,
      "media": [
        {
          "id": "34647529-5d71-4c17-83c1-876e5500317c",
          "type": "StaticImage",
          "url": "https://cdn.cosmos.so/34647529-5d71-4c17-83c1-876e5500317c",
          "width": 1440,
          "height": 1920,
          "ai_generated": false,
          "duration": null,
          "thumbnail_url": null,
          "video_url": null,
          "playback_url": null
        }
      ],
      "price": null,
      "brand": null
    },
    {
      "id": 231368414,
      "url": "https://www.cosmos.so/e/231368414",
      "created_at": "2026-07-22T04:24:41.491306Z",
      "caption": "Ad for Halston colognes with bottles designed by Elsa Peretti.",
      "text": null,
      "title": null,
      "description": null,
      "owner": {
        "id": 234172146,
        "username": "design"
      },
      "source_url": "https://www.pinterest.com/pin/65443000829576944/",
      "source_author": null,
      "media": [
        {
          "id": "1d0d58e8-19b8-4ebf-b773-dc7da702df1e",
          "type": "StaticImage",
          "url": "https://cdn.cosmos.so/1d0d58e8-19b8-4ebf-b773-dc7da702df1e",
          "width": 564,
          "height": 799,
          "ai_generated": false,
          "duration": null,
          "thumbnail_url": null,
          "video_url": null,
          "playback_url": null
        }
      ],
      "price": null,
      "brand": null
    }
  ],
  "total_count": 25,
  "cursor": null,
  "has_more": false
}

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

Gönderiler `items` listesindedir (sayfa başına en fazla 40); yanında `total_count`, `cursor` ve `has_more` bulunur. Son sayfada `cursor` null, `has_more` false olur. `caption`, görsel için otomatik yazılmış bir açıklamadır. 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.