Cosmos API

Endpoints

Quick start

Coverage & limits

• Paged routes accept limit 1 to 40. User Collections defaults to 20 records; element feeds and search default to 40. Supply the returned cursor with the same endpoint and inputs to request another page. Request cursors contain 1 to 4,096 characters with no control characters.
• Usernames contain 1 to 64 letters, digits, underscores, dots or hyphens, begin with a letter, digit, underscore or hyphen, and contain no consecutive dots. Search text contains 1 to 300 characters after trimming and no control characters.
• Element and collection URLs are HTTPS cosmos.so or www.cosmos.so URLs with at most 1,500 characters. Element IDs are positive integers at most 2,147,483,647. Collection and optional subcollection slugs contain 1 to 120 letters, digits, underscores, dots or hyphens and no consecutive dots.
• Each operation has a 30-second deadline, a 4 MiB decoded-response budget and at most three upstream requests, including at most one transient retry. Parsing is bounded to depth 32 and 60,000 nodes.
• At most four requests run concurrently; excess requests receive busy.
• Each result page contains at most 40 records. Each element retains at most 40 media records and metadata records. Each collection retains at most 40 subcollections.
• Responses include status, coverage and accounting. Bounded media or subcollection truncation, omitted subcollections and an incomplete source media or subcollection result produce explicit coverage warnings. Ordinary cursor-paginated pages can report success with has_more true.