Cosmos Profile API
Look up any public Cosmos curator by username and get their profile and counts.
GET /v1/cosmos/profiles/{handle}1 credit Failed requests are free Found and not-found answers are both charged
About this endpoint
GET /v1/cosmos/profiles/joris.kahl returns data.profile with id, handle, url, displayName, bio, avatarUrl, websiteUrl, isPremium, isVerified, socialLinks (Instagram, X, TikTok, Spotify) and stats (posts, collections, followers, following).
Follower and following counts are null for accounts that do not show them. An unknown username returns lookupStatus: not_found with profile: null.
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 API FAQ
Which handle do I pass?
The username from the profile link, cosmos.so/{username}, with or without an @. Usernames can contain dots, as in joris.kahl.
Why are followers null for some accounts?
Some accounts, such as Cosmos's own, do not show follower counts on their profile, so there is no number to return.
What happens with a username that does not exist?
The request completes with lookupStatus: not_found and profile: null, and it is billed like any completed lookup.
How many credits does a profile 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.