> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/cosmos/search-posts>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/cosmos/search-posts.mdx>

---

# Cosmos Post Search API

Find images and videos on Cosmos by describing them.

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

## Request

- **Endpoint:** `GET /v1/cosmos/search/posts`
- **Credits:** 1 credit
Failed requests are free
Found and not-found answers are both charged
- **Input:** by query
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/cosmos/search/posts/get)
- **Platform page:** [/platforms/cosmos](https://www.socialfetch.dev/platforms/cosmos)

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