Cosmos Collection API
Look up a Cosmos collection by its link.
GET /v1/cosmos/collections1 credit Failed requests are free Found and not-found answers are both charged
About this endpoint
GET /v1/cosmos/collections?url=https://www.cosmos.so/joris.kahl/teh-nerd-stuff returns data.collection with id, name, slug, url, description, owner, coverUrl, postCount, followers, collaboratorCount, subCollectionCount and isFeatured. A private, removed or unknown collection returns lookupStatus: not_found.
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 Collection API FAQ
Which link do I pass?
The collection page link, https://www.cosmos.so/{username}/{collection}.
How do I get its posts?
Pass the same link to /v1/cosmos/collections/posts.
How many credits does a collection lookup 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.