Cosmos hub

Cosmos Post API

Turn a Cosmos post link into structured JSON with its media and source.

GET /v1/cosmos/posts

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

Request
cURL

Example response

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

Request
JSON

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.