← API Store
Social
Cosmos
Cosmos
Cosmos collection elements
GET /cosmos/v1/collection/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 |
|---|---|---|
urlrequired | string | Example: https://www.cosmos.so/markbraydon91/architecture |
cursor | string | Value 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 |
$.cached | boolean |
$.collection | string |
$.count | integer |
$.credits_used | integer |
$.elements | array |
$.elements[] | object | string |
$.elements[].caption | null |
$.elements[].caption_raw | null |
$.elements[].created_at | string |
$.elements[].gallery | array |
$.elements[].gallery[] | object | string |
$.elements[].gallery[].ai_generated | boolean |
$.elements[].gallery[].height | integer |
$.elements[].gallery[].id | string |
$.elements[].gallery[].nsfw_status | string |
$.elements[].gallery[].type | string |
$.elements[].gallery[].typename | string |
$.elements[].gallery[].url | string |
$.elements[].gallery[].width | integer |
$.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 | object |
$.elements[].source_author.name | string |
$.elements[].source_author.url | string |
$.elements[].source_author.username | string |
$.elements[].source_url | string |
$.elements[].type | string |
$.elements[].url | string |
$.meta | object |
$.meta.count | integer |
$.meta.nextPageCursor | string |
$.next_cursor | string |
$.total | integer |