> **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/posts>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/cosmos/posts.mdx>

---

# Cosmos Post API

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

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

## Request

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

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