Cosmos hub

Cosmos Post Search API

Find images and videos on Cosmos by describing them.

GET /v1/cosmos/search/posts

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

About this endpoint

GET /v1/cosmos/search/posts?query=architecture returns data.posts (about 40, best match first) and data.total, how many posts Cosmos counts as matching, up to 500. Cosmos searches by meaning, so words in other languages and descriptions such as red car work, and a rare word still returns related posts.

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 Search API FAQ

Can I search in other languages?

Yes. Cosmos matches by meaning, so a query in Russian or Japanese returns related posts.

Why do unrelated words still return posts?

Cosmos ranks posts by how close their meaning is, so it always returns its nearest matches.

How many credits does a search 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.