← API Store
Social
Cosmos
Cosmos
Search Cosmos
GET /cosmos/v1/searchEvery 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 |
|---|---|---|
qrequired | string | Example: architecture |
type | string | elements or collections. Example: elements |
cursor | string | Value 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 |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.meta | object |
$.meta.count | integer |
$.meta.nextPageCursor | string |
$.next_cursor | string |
$.query | string |
$.results | array |
$.results[] | object | string |
$.results[].caption | null | string |
$.results[].caption_raw | null | string |
$.results[].created_at | string |
$.results[].gallery | array |
$.results[].gallery[] | object | string |
$.results[].gallery[].ai_generated | boolean |
$.results[].gallery[].height | integer |
$.results[].gallery[].id | string |
$.results[].gallery[].nsfw_status | string |
$.results[].gallery[].type | string |
$.results[].gallery[].typename | string |
$.results[].gallery[].url | string |
$.results[].gallery[].width | integer |
$.results[].id | integer |
$.results[].media | object |
$.results[].media.ai_generated | boolean |
$.results[].media.height | integer |
$.results[].media.id | string |
$.results[].media.nsfw_status | string |
$.results[].media.type | string |
$.results[].media.typename | string |
$.results[].media.url | string |
$.results[].media.width | integer |
$.results[].media_count | integer |
$.results[].owner_id | integer |
$.results[].saved_by | string |
$.results[].saved_by_avatar | string |
$.results[].saved_by_name | string |
$.results[].slate_id | string |
$.results[].source_author | object |
$.results[].source_author.name | string |
$.results[].source_author.url | string |
$.results[].source_author.username | string |
$.results[].source_url | string |
$.results[].type | string |
$.results[].url | string |
$.total | integer |
$.type | string |