Cosmos hub

Cosmos Profile Posts API

See what a Cosmos curator saved most recently, with media and sources.

GET /v1/cosmos/profiles/{handle}/posts

1 credit Failed requests are free Found and not-found answers are both charged

About this endpoint

GET /v1/cosmos/profiles/joris.kahl/posts returns data.posts (about 40, newest first) and data.total, the account's public post count. Each post has id, url, createdAt, caption, media (type, file, size, duration), savedBy, collectionId, sourceUrl and sourceAuthor.

Without signing in Cosmos shows the latest page only, so this endpoint returns that page; page.hasMore is false.

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 Profile Posts API FAQ

How many posts do I get?

The latest page Cosmos shows, about 40. total says how many public posts the account has.

What is sourceUrl?

Where the image or video came from, such as the Instagram or Pinterest post it was saved from.

How many credits does a page of posts 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.