Arama

GET/v1/cosmos/search1 kredi

Cosmos'ta bir sorguyla eşleşen gönderileri arar ve açıklama, medya, sahip ve kaynak bilgisiyle döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
queryzorunlu	string	Arama ifadesi, örneğin `architecture`.
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/search?query=architecture" \
  -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/search?query=architecture

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "items": [
    {
      "id": 547956585,
      "url": "https://www.cosmos.so/e/547956585",
      "created_at": "2025-06-19T12:57:19.994842Z",
      "caption": "An architectural poster created using Midjourney v7.",
      "text": null,
      "title": null,
      "description": null,
      "owner": {
        "id": 2059029120,
        "username": "joris.kahl"
      },
      "source_url": "https://www.instagram.com/p/DK2wZxvMsbf/?igsh=MW9ubmc3NzRucHBkNg==",
      "source_author": {
        "username": "ai_architecture_awards",
        "full_name": "AI Architecture",
        "profile_url": "https://www.instagram.com/ai_architecture_awards",
        "avatar_url": null
      },
      "media": [
        {
          "id": "589cdf02-9abf-4d94-88ef-809734ca5444",
          "type": "StaticImage",
          "url": "https://cdn.cosmos.so/e00a12d4-1e19-45de-9649-b42e9c9f724a",
          "width": 928,
          "height": 1232,
          "ai_generated": false,
          "duration": null,
          "thumbnail_url": null,
          "video_url": null,
          "playback_url": null
        },
        {
          "id": "0e2ebb91-84fc-4700-b076-7c772289b9c7",
          "type": "StaticImage",
          "url": "https://cdn.cosmos.so/4c815d2f-c297-4bee-89f3-bdc8e952440f",
          "width": 928,
          "height": 1232,
          "ai_generated": false,
          "duration": null,
          "thumbnail_url": null,
          "video_url": null,
          "playback_url": null
        }
      ],
      "price": null,
      "brand": null
    },
    {
      "id": 1608649362,
      "url": "https://www.cosmos.so/e/1608649362",
      "created_at": "2025-03-04T23:13:59.334456Z",
      "caption": "Habitat 67, a Brutalist housing complex by Moshe Safdie, was built for Montreal's Expo 67.",
      "text": null,
      "title": null,
      "description": null,
      "owner": null,
      "source_url": "https://www.instagram.com/p/DGuzvRVsZse/",
      "source_author": {
        "username": "archdaily",
        "full_name": "Architecture 🏠",
        "profile_url": "https://www.instagram.com/archdaily",
        "avatar_url": null
      },
      "media": [
        {
          "id": "ebae3229-6112-47a3-9e9d-1a8a66e6924c",
          "type": "StaticImage",
          "url": "https://cdn.cosmos.so/617e1f3d-1ba8-4586-abcf-e78d396b1837",
          "width": 1080,
          "height": 1350,
          "ai_generated": false,
          "duration": null,
          "thumbnail_url": null,
          "video_url": null,
          "playback_url": null
        }
      ],
      "price": null,
      "brand": null
    }
  ],
  "cursor": "cursor://recsys/search?user_id=0&profile=search__dual70_nouser_recql&query=architecture&last=39&count=500",
  "has_more": true,
  "result_count": 500
}

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` içindedir (sayfa başına 40), `cursor`, `has_more` ve `result_count` ile birlikte. `result_count` sayfalanabilen arama penceresinin boyutudur, kesin eşleşme sayısı değildir. Sonraki sayfa için `cursor` değerini geri gönderin. Cosmos anlama göre arar, bu yüzden alışılmadık bir sorgu da genellikle gönderi döndürür; hiçbir şey bulamayan arama 0 krediyle boş liste ile 200 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.