Cosmos

Get Cosmos profile

Get a Cosmos profile by handle, with its bio, links and counts.

GET/v1/cosmos/profiles/{handle}
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
handlestringrequiredpath

Cosmos username from the profile link, with or without a leading @, for example `joris.kahl`.

min 1 chars · max 41 chars

Response fields
28

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no account has this username.

one of: found, not_found

The account when `lookupStatus` is `found`; otherwise null.

dataprofileid
string

Cosmos user id.

dataprofilehandle
string

Username, as in cosmos.so/{handle}.

dataprofileurl
string

Profile page.

dataprofiledisplayName
stringnullable

Full name.

dataprofilebio
stringnullable

Bio.

dataprofileavatarUrl
stringnullable

Profile picture.

dataprofilewebsiteUrl
stringnullable

Website from the profile.

dataprofileisPremium
booleannullable

True for a paying Cosmos member.

dataprofileisVerified
booleannullable

True when Cosmos verified the profile.

Social profiles linked from the profile.

dataprofilesocialLinksinstagram
stringnullable

Instagram profile.

dataprofilesocialLinksx
stringnullable

X profile.

dataprofilesocialLinkstiktok
stringnullable

TikTok profile.

dataprofilesocialLinksspotify
stringnullable

Spotify profile.

Cosmos's own counters.

dataprofilestatsposts
integernullable

Public posts.

dataprofilestatscollections
integernullable

Public collections.

dataprofilestatsfollowers
integernullable

Followers, when Cosmos shows them.

dataprofilestatsfollowing
integernullable

Accounts followed, when Cosmos shows them.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.