Cosmos Post API
Turn a Cosmos post link into structured JSON with its media and source.
GET /v1/cosmos/posts1 credit Failed requests are free Found and not-found answers are both charged
About this endpoint
GET /v1/cosmos/posts?url=https://www.cosmos.so/e/547956585 returns data.post with id, url, createdAt, caption, media, savedBy, sourceUrl and sourceAuthor. You can pass the numeric id instead of the link. A removed or unknown post 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 Post API FAQ
Who wrote the caption?
Cosmos generates a short description for each post; caption is that text.
Can I pass the id instead of the link?
Yes. url accepts https://www.cosmos.so/e/{id} or the id on its own.
How many credits does a post 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.