Search APIs
Loading…
← API Store
Social

Cosmos

Cosmos

Search Cosmos

GET /cosmos/v1/search
Test this endpoint

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
qrequiredstring Example: architecture
typestringelements or collections. Example: elements
cursorstringValue of `next_cursor` from the previous page.

Every endpoint also takes: raw、fields、fresh、output、records

{
  "cached": false,
  "count": 40,
  "credits_used": 1,
  "meta": {
    "count": 500,
    "nextPageCursor": "cursor://recsys/search?user_id=0&profile=search__dual70_nouser_recql&query=architecture&last=39&count=500"
  },
  "next_cursor": "cursor://recsys/search?user_id=0&profile=search__dual70_nouser_recql&query=architecture&last=39&count=500",
  "query": "architecture",
  "results": [
    {
      "caption": "An architectural poster created using Midjourney v7.",
      "caption_raw": "An architectural poster created using <n>Midjourney v7</n>.",
      "created_at": "2025-06-19T12:57:19.994842Z",
      "gallery": [
        {
          "ai_generated": false,
          "height": 1232,
          "id": "589cdf02-9abf-4d94-88ef-809734ca5444",
          "nsfw_status": "SAFE",
          "type": "image",
          "typename": "StaticImage",
          "url": "https://cdn.cosmos.so/e00a12d4-1e19-45de-9649-b42e9c9f724a",
          "width": 928
        },
        {
          "ai_generated": false,
          "height": 1232,
          "id": "0e2ebb91-84fc-4700-b076-7c772289b9c7",
          "nsfw_status": "SAFE",
          "type": "image",
          "typename": "StaticImage",
          "url": "https://cdn.cosmos.so/4c815d2f-c297-4bee-89f3-bdc8e952440f",
          "width": 928
        },
        "… 3 more"
      ],
      "id": 547956585,
      "media": {
        "ai_generated": false,
        "height": 1232,
        "id": "589cdf02-9abf-4d94-88ef-809734ca5444",
        "nsfw_status": "SAFE",
        "type": "image",
        "typename": "StaticImage",
        "url": "https://cdn.cosmos.so/e00a12d4-1e19-45de-9649-b42e9c9f724a",
        "width": 928
      },
      "media_count": 5,
      "owner_id": 2059029120,
      "saved_by": "joris.kahl",
      "saved_by_avatar": "https://cdn.cosmos.so/29346e3f-2124-4aa2-a1a3-cff02cd1ce56",
      "saved_by_name": "Joris Kahl",
      "slate_id": "d601ba7d-7ba8-4af1-aecb-49b93d71b4df",
      "source_author": {
        "name": "AI Architecture",
        "url": "https://www.instagram.com/ai_architecture_awards",
        "username": "ai_architecture_awards"
      },
      "source_url": "https://www.instagram.com/p/DK2wZxvMsbf/?igsh=MW9ubmc3NzRucHBkNg==",
      "type": "media",
      "url": "https://www.cosmos.so/e/547956585"
    },
    {
      "caption": null,
      "caption_raw": null,
      "created_at": "2026-04-20T22:32:26.886048Z",
      "gallery": [
        {
          "ai_generated": false,
          "height": 800,
          "id": "f064daec-8e14-49c4-a0f8-318833b0dc4f",
          "nsfw_status": "SAFE",
          "type": "image",
          "typename": "StaticImage",
          "url": "https://cdn.cosmos.so/b350c21f-3abd-483b-8e0d-168d9d96015c",
          "width": 640
        },
        {
          "ai_generated": false,
          "height": 800,
          "id": "f85f72e7-1922-41ac-9215-62a0afda42e5",
          "nsfw_status": "SAFE",
          "type": "image",
          "typename": "StaticImage",
          "url": "https://cdn.cosmos.so/06377029-11c3-4ab6-a276-a051ce44b0cd",
          "width": 639
        },
        "… 4 more"
      ],
      "id": 448317524,
      "media": {
        "ai_generated": false,
        "height": 800,
        "id": "f064daec-8e14-49c4-a0f8-318833b0dc4f",
        "nsfw_status": "SAFE",
        "type": "image",
        "typename": "StaticImage",
        "url": "https://cdn.cosmos.so/b350c21f-3abd-483b-8e0d-168d9d96015c",
        "width": 640
      },
      "media_count": 6,
      "owner_id": 876856709,
      "saved_by": "markbraydon91",
      "saved_by_avatar": "https://cdn.cosmos.so/52a1b35c-7f63-4432-8e85-a5bf63ecfafb",
      "saved_by_name": "Mark",
      "slate_id": "d601ba7d-7ba8-4af1-aecb-49b93d71b4df",
      "source_author": {
        "name": "Architecture Wave",
        "url": "https://www.instagram.com/architecture.wave",
        "username": "architecture.wave"
      },
      "source_url": "https://www.instagram.com/p/DXHVrtXj95A/?img_index=5&igsh=MWE0aGZtd2VqMXJnOQ==",
      "type": "media",
      "url": "https://www.cosmos.so/e/448317524"
    },
    "… 38 more"
  ],
  "total": 500,
  "type": "elements"
}
Response fields (49)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.metaobject
$.meta.countinteger
$.meta.nextPageCursorstring
$.next_cursorstring
$.querystring
$.resultsarray
$.results[]object | string
$.results[].captionnull | string
$.results[].caption_rawnull | string
$.results[].created_atstring
$.results[].galleryarray
$.results[].gallery[]object | string
$.results[].gallery[].ai_generatedboolean
$.results[].gallery[].heightinteger
$.results[].gallery[].idstring
$.results[].gallery[].nsfw_statusstring
$.results[].gallery[].typestring
$.results[].gallery[].typenamestring
$.results[].gallery[].urlstring
$.results[].gallery[].widthinteger
$.results[].idinteger
$.results[].mediaobject
$.results[].media.ai_generatedboolean
$.results[].media.heightinteger
$.results[].media.idstring
$.results[].media.nsfw_statusstring
$.results[].media.typestring
$.results[].media.typenamestring
$.results[].media.urlstring
$.results[].media.widthinteger
$.results[].media_countinteger
$.results[].owner_idinteger
$.results[].saved_bystring
$.results[].saved_by_avatarstring
$.results[].saved_by_namestring
$.results[].slate_idstring
$.results[].source_authorobject
$.results[].source_author.namestring
$.results[].source_author.urlstring
$.results[].source_author.usernamestring
$.results[].source_urlstring
$.results[].typestring
$.results[].urlstring
$.totalinteger
$.typestring