Cosmos Profile Collections API
See how a Cosmos curator organises their saves.
GET /v1/cosmos/profiles/{handle}/collections1 credit Failed requests are free Found and not-found answers are both charged
About this endpoint
GET /v1/cosmos/profiles/joris.kahl/collections returns data.collections (up to 20, most recently updated first) and data.total. Each collection has id, name, slug, url, description, owner, coverUrl, postCount, collaboratorCount, subCollectionCount and isFeatured. Pass a collection's url to the collection endpoints.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Cosmos Profile Collections API FAQ
How many collections do I get?
Up to 20, the first page Cosmos shows. total says how many public collections the account has.
Are private collections listed?
No. Only public collections appear.
How many credits does a page of collections cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.