cosmos.so APIcosmos.so ↗
Search a curated database of images, videos, links, notes, and products by content type, color, and sorting preferences, then browse results with pagination to find exactly what you need. Discover and organize collections of related visual content tailored to your search criteria.
curl -X POST 'https://api.parse.bot/scraper/518f0113-a227-49a8-95cf-31124444fa1e/search_elements' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'Search for elements (images, videos, links, notes, products) on Cosmos. Returns up to 40 results per page with metadata including media URLs, captions, source info, and owner details. Supports cursor-based pagination via next_page_cursor in the response.
| Param | Type | Description |
|---|---|---|
| color | string | Filter results by color (hex color code without # prefix, e.g. 'FF0000' for red). Omitted returns all colors. |
| order | string | Sort order for results. Accepts exactly one of: RELEVANT, LATEST, OLDEST, POPULAR, RANDOM. Case-insensitive. Omitted defaults to relevance sorting. |
| queryrequired | string | Search term to find elements (e.g. 'architecture', 'nature', 'minimalist design'). |
| page_cursor | string | Pagination cursor from a previous response's next_page_cursor field. Omitted returns the first page. |
| content_type | string | Filter by content type. Accepts exactly one of: IMAGE, VIDEO, LINK, NOTE, PRODUCT. Case-insensitive. Omitted returns all content types. |
{
"type": "object",
"fields": {
"items": "array of element objects with id, type, created_at, share_url, owner, caption, source, media, and type-specific fields",
"total_count": "integer total number of matching results",
"next_page_cursor": "string cursor for fetching the next page, null if no more pages"
},
"sample": {
"items": [
{
"id": 2019059012,
"type": "MediaElementTile",
"media": {
"url": "https://cdn.cosmos.so/c39f5bbd-3155-44f8-aadf-2ce88422d7c3",
"width": 1200,
"height": 1600,
"mediaId": "c39f5bbd-3155-44f8-aadf-2ce88422d7c3",
"__typename": "StaticImage",
"aiGenerated": false,
"notSafeForWorkStatus": "SAFE"
},
"owner": {
"username": "papillon",
"isVerifiedProfile": false
},
"source": {
"url": "https://baukobox.de/projekte/366-c-f-moeller-danmark-a-s-bestseller-office-aarhus",
"author": null,
"isEditable": false,
"isPublicDomain": false
},
"caption": "The facade of the Bestseller Office Complex in Aarhus, designed by C.F. Møller Architects.",
"share_url": "https://www.cosmos.so/e/2019059012",
"created_at": "2024-09-27T16:02:40.934003Z",
"is_featured": false,
"multiple_media": []
}
],
"total_count": 500,
"next_page_cursor": "cursor://api_gateway/element_search?query=architecture&order=relevant&content_categories=all&hide=explicit&last=39&count=500"
}
}About the cosmos.so API
The cosmos.so API on Parse exposes 2 endpoints for the publicly available data on cosmos.so. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.