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

---

# Cosmos Profile API

Look up any public Cosmos curator by username and get their profile and counts.

`GET /v1/cosmos/profiles/joris.kahl` returns `data.profile` with `id`, `handle`, `url`, `displayName`, `bio`, `avatarUrl`, `websiteUrl`, `isPremium`, `isVerified`, `socialLinks` (Instagram, X, TikTok, Spotify) and `stats` (posts, collections, followers, following).

Follower and following counts are null for accounts that do not show them. An unknown username returns `lookupStatus: not_found` with `profile: null`.

## Request

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

## FAQ

### Which handle do I pass?

The username from the profile link, cosmos.so/{username}, with or without an @. Usernames can contain dots, as in joris.kahl.

### Why are followers null for some accounts?

Some accounts, such as Cosmos's own, do not show follower counts on their profile, so there is no number to return.

### What happens with a username that does not exist?

The request completes with lookupStatus: not_found and profile: null, and it is billed like any completed lookup.

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