Get Cosmos profile
Get a Cosmos profile by handle, with its bio, links and counts.
Headers
Get your API keyAPI key (`sfk_...`)
Cosmos username from the profile link, with or without a leading @, for example `joris.kahl`.
min 1 chars · max 41 chars
Endpoint-specific response payload.
`not_found` when no account has this username.
one of: found, not_found
The account when `lookupStatus` is `found`; otherwise null.
Cosmos user id.
Username, as in cosmos.so/{handle}.
Profile page.
Full name.
Bio.
Profile picture.
Website from the profile.
True for a paying Cosmos member.
True when Cosmos verified the profile.
Social profiles linked from the profile.
Instagram profile.
X profile.
TikTok profile.
Spotify profile.
Cosmos's own counters.
Public posts.
Public collections.
Followers, when Cosmos shows them.
Accounts followed, when Cosmos shows them.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/cosmos/profiles/joris.kahl" \
-H "x-api-key: YOUR_API_KEY"Responses
A Cosmos profile.