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

---

# Cosmos Collection API

Look up a Cosmos collection by its link.

`GET /v1/cosmos/collections?url=https://www.cosmos.so/joris.kahl/teh-nerd-stuff` returns `data.collection` with `id`, `name`, `slug`, `url`, `description`, `owner`, `coverUrl`, `postCount`, `followers`, `collaboratorCount`, `subCollectionCount` and `isFeatured`. A private, removed or unknown collection returns `lookupStatus: not_found`.

## Request

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

## FAQ

### Which link do I pass?

The collection page link, https://www.cosmos.so/{username}/{collection}.

### How do I get its posts?

Pass the same link to /v1/cosmos/collections/posts.

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