← API Store
Social
Cosmos
Cosmos
Cosmos user saved elements
GET /cosmos/v1/user/postsEvery 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
| Name | Type | Description |
|---|---|---|
handlerequired | string | Example: design |
cursor | string | Value 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 |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.elements | array |
$.elements[] | object | string |
$.elements[].caption | null | string |
$.elements[].caption_raw | null | string |
$.elements[].created_at | string |
$.elements[].id | integer |
$.elements[].media | object |
$.elements[].media.ai_generated | boolean |
$.elements[].media.height | integer |
$.elements[].media.id | string |
$.elements[].media.nsfw_status | string |
$.elements[].media.type | string |
$.elements[].media.typename | string |
$.elements[].media.url | string |
$.elements[].media.width | integer |
$.elements[].media_count | integer |
$.elements[].owner_id | integer |
$.elements[].saved_by | string |
$.elements[].saved_by_avatar | string |
$.elements[].saved_by_name | string |
$.elements[].slate_id | null |
$.elements[].source_author | null |
$.elements[].source_url | null | string |
$.elements[].type | string |
$.elements[].url | string |
$.handle | string |
$.meta | object |
$.meta.count | integer |
$.meta.nextPageCursor | null |
$.next_cursor | null |
$.total | integer |