Search APIs
Loading…
← API Store
Social

Cosmos

Cosmos

Cosmos collection elements

GET /cosmos/v1/collection/posts
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
urlrequiredstring Example: https://www.cosmos.so/markbraydon91/architecture
cursorstringValue of `next_cursor` from the previous page.

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

{
  "cached": false,
  "collection": "markbraydon91/architecture",
  "count": 40,
  "credits_used": 1,
  "elements": [
    {
      "caption": null,
      "caption_raw": null,
      "created_at": "2026-10-23T18:40:50.763974Z",
      "gallery": [
        {
          "ai_generated": false,
          "height": 1799,
          "id": "a06c586a-57df-41ed-b65b-de190c08635d",
          "nsfw_status": "SAFE",
          "type": "image",
          "typename": "StaticImage",
          "url": "https://cdn.cosmos.so/01a16a10-f85a-7d07-a065-adcdddca5f5e",
          "width": 1440
        },
        {
          "ai_generated": false,
          "height": 1799,
          "id": "36a72456-fc7e-4063-a594-64423289d1d2",
          "nsfw_status": "SAFE",
          "type": "image",
          "typename": "StaticImage",
          "url": "https://cdn.cosmos.so/01a16a10-e65b-7fe3-b021-b690ff43fff2",
          "width": 1440
        },
        "… 5 more"
      ],
      "id": 57596350,
      "media": {
        "ai_generated": false,
        "height": 1799,
        "id": "a06c586a-57df-41ed-b65b-de190c08635d",
        "nsfw_status": "SAFE",
        "type": "image",
        "typename": "StaticImage",
        "url": "https://cdn.cosmos.so/01a16a10-f85a-7d07-a065-adcdddca5f5e",
        "width": 1440
      },
      "media_count": 7,
      "owner_id": 876856709,
      "saved_by": "markbraydon91",
      "saved_by_avatar": "https://cdn.cosmos.so/52a1b35c-7f63-4432-8e85-a5bf63ecfafb",
      "saved_by_name": "Mark",
      "slate_id": null,
      "source_author": {
        "name": "Adam Štěch",
        "url": "https://www.instagram.com/okolo_architecture",
        "username": "okolo_architecture"
      },
      "source_url": "https://www.instagram.com/p/De1JGliDTXS/?xtok=ZDN1dzYzYXY2dTh6",
      "type": "media",
      "url": "https://www.cosmos.so/e/57596350"
    },
    {
      "caption": null,
      "caption_raw": null,
      "created_at": "2026-10-23T00:16:25.336759Z",
      "gallery": [
        {
          "ai_generated": false,
          "height": 1339,
          "id": "6bea860a-6fd6-49d5-96a2-d76e20cc5b27",
          "nsfw_status": "SAFE",
          "type": "image",
          "typename": "StaticImage",
          "url": "https://cdn.cosmos.so/01a1661d-d1df-7113-94bf-083467791183",
          "width": 1080
        },
        {
          "ai_generated": false,
          "height": 1339,
          "id": "be39728f-3b66-48ef-9a8a-7a6e345fabbc",
          "nsfw_status": "SAFE",
          "type": "image",
          "typename": "StaticImage",
          "url": "https://cdn.cosmos.so/01a1661d-ce96-78ee-80b3-35e727b0d835",
          "width": 1080
        },
        "… 1 more"
      ],
      "id": 1288969847,
      "media": {
        "ai_generated": false,
        "height": 1339,
        "id": "6bea860a-6fd6-49d5-96a2-d76e20cc5b27",
        "nsfw_status": "SAFE",
        "type": "image",
        "typename": "StaticImage",
        "url": "https://cdn.cosmos.so/01a1661d-d1df-7113-94bf-083467791183",
        "width": 1080
      },
      "media_count": 3,
      "owner_id": 876856709,
      "saved_by": "markbraydon91",
      "saved_by_avatar": "https://cdn.cosmos.so/52a1b35c-7f63-4432-8e85-a5bf63ecfafb",
      "saved_by_name": "Mark",
      "slate_id": null,
      "source_author": {
        "name": "Historic Decorative Materials",
        "url": "https://www.instagram.com/historicdecorativematerial",
        "username": "historicdecorativematerial"
      },
      "source_url": "https://www.instagram.com/p/DeunxGpmMpB/?img_index=3&vrfl=azdlZzNjMGxkaXZ4",
      "type": "media",
      "url": "https://www.cosmos.so/e/1288969847"
    },
    "… 38 more"
  ],
  "meta": {
    "count": 3624,
    "nextPageCursor": "eyJ2MSI6MzYzMi4wLCJ2MiI6NjM5OTg2MDZ9"
  },
  "next_cursor": "eyJ2MSI6MzYzMi4wLCJ2MiI6NjM5OTg2MDZ9",
  "total": 3624
}
Response fields (48)

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

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