Cosmos API
Get public Cosmos data as typed JSON: profile, user posts, user collections, collection, collection posts and search. One API key, and a published credit cost for every endpoint.
Cosmos endpoints
All endpoints authenticate via x-api-key
Profile
/v1/cosmos/profile
Get a public Cosmos profile with bio, links, and follower counts.
User Posts
/v1/cosmos/user/posts
Get the public posts saved to a Cosmos user profile.
User Collections
/v1/cosmos/user/clusters
Get the public collections owned by a Cosmos user.
Collection
/v1/cosmos/cluster
Get a public Cosmos collection with its owner, description, cover, counts, and public subcollections.
Collection Posts
/v1/cosmos/cluster/posts
Get public posts saved to a Cosmos collection. Supports cursor pagination.
Search
/v1/cosmos/search
Search public Cosmos posts by keyword. Cosmos may return related posts even when there is no exact keyword match.
Cosmos API FAQ
How much does the Cosmos API cost?
Every Cosmos endpoint costs 1 credit per call by default. New accounts get 100 free credits with no card. After that, credits come in one-time packs that never expire: 25,000 for $27 and 500,000 for $297 (plus any tax). There is no subscription.
Do I need a Cosmos account or developer app?
No. You call Fetchproof with one API key in the x-api-key header. It returns public Cosmos data only, so there's no Cosmos login, OAuth or app review.
What happens when a call fails or finds nothing?
Errors cost 0 credits, and so do cache hits on endpoints that take cache_max_age. An empty result costs 0 on User Posts, User Collections, Collection Posts and Search. Each endpoint page lists its own rules.
Which Cosmos data can I get?
6 endpoints: Profile, User Posts, User Collections, Collection, Collection Posts and Search.
Is there a free trial?
Yes. Sign up with an email address to get 100 free credits, with no card. Credits never expire.
Ready to try it? Get 100 free credits or compare credit packs.