Search APIs
Loading…
← API Store
Social

Cosmos

Cosmos

Cosmos user saved elements

GET /cosmos/v1/user/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
handlerequiredstring Example: design
cursorstringValue of `next_cursor` from the previous page.

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

{
  "cached": false,
  "count": 25,
  "credits_used": 1,
  "elements": [
    {
      "caption": null,
      "caption_raw": null,
      "created_at": "2026-04-01T15:24:45.897845Z",
      "id": 1307496415,
      "media": {
        "ai_generated": false,
        "height": 1920,
        "id": "34647529-5d71-4c17-83c1-876e5500317c",
        "nsfw_status": "SAFE",
        "type": "image",
        "typename": "StaticImage",
        "url": "https://cdn.cosmos.so/34647529-5d71-4c17-83c1-876e5500317c",
        "width": 1440
      },
      "media_count": 1,
      "owner_id": 14413015,
      "saved_by": "esther.yang",
      "saved_by_avatar": "https://cdn.cosmos.so/default-avatars/018.png",
      "saved_by_name": "Esther Yang",
      "slate_id": null,
      "source_author": null,
      "source_url": null,
      "type": "media",
      "url": "https://www.cosmos.so/e/1307496415"
    },
    {
      "caption": "Ad for Halston colognes with bottles designed by Elsa Peretti.",
      "caption_raw": "Ad for <n>Halston</n> colognes with bottles designed by <n>Elsa Peretti</n>.",
      "created_at": "2026-07-22T04:24:41.491306Z",
      "id": 231368414,
      "media": {
        "ai_generated": false,
        "height": 799,
        "id": "1d0d58e8-19b8-4ebf-b773-dc7da702df1e",
        "nsfw_status": "SAFE",
        "type": "image",
        "typename": "StaticImage",
        "url": "https://cdn.cosmos.so/1d0d58e8-19b8-4ebf-b773-dc7da702df1e",
        "width": 564
      },
      "media_count": 1,
      "owner_id": 234172146,
      "saved_by": "design",
      "saved_by_avatar": "https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0",
      "saved_by_name": "Design",
      "slate_id": null,
      "source_author": null,
      "source_url": "https://www.pinterest.com/pin/65443000829576944/",
      "type": "media",
      "url": "https://www.cosmos.so/e/231368414"
    },
    "… 23 more"
  ],
  "handle": "design",
  "meta": {
    "count": 25,
    "nextPageCursor": null
  },
  "next_cursor": null,
  "total": 25
}
Response fields (35)

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

$object
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.elementsarray
$.elements[]object | string
$.elements[].captionnull | string
$.elements[].caption_rawnull | string
$.elements[].created_atstring
$.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_authornull
$.elements[].source_urlnull | string
$.elements[].typestring
$.elements[].urlstring
$.handlestring
$.metaobject
$.meta.countinteger
$.meta.nextPageCursornull
$.next_cursornull
$.totalinteger