Cosmos hub

Cosmos Collection API

Look up a Cosmos collection by its link.

GET /v1/cosmos/collections

1 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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

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.