Cosmos

List Cosmos profile collections

List a Cosmos profile's public collections with their covers and sizes.

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

API key (`sfk_...`)

Parameters
2
handlestringrequiredpath

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

min 1 chars · max 41 chars

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same handle, collection or query.

min 1 chars · max 4096 chars

Response fields
39

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no account has this username.

one of: found, not_found

The account, when found.

dataprofileid
stringnullable

Cosmos user id.

dataprofilehandle
string

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

dataprofiledisplayName
stringnullable

Full name.

dataprofileavatarUrl
stringnullable

Profile picture.

dataprofileisVerified
booleannullable

True when Cosmos verified the profile.

dataprofileurl
string

Profile page.

The account's public collections, 20 a page, most recently updated first.

datacollections[]id
string

Cosmos collection (cluster) id.

datacollections[]name
stringnullable

Collection name.

datacollections[]slug
stringnullable

The name in its link.

datacollections[]url
stringnullable

Collection page.

datacollections[]description
stringnullable

Description.

The owner.

datacollections[]ownerid
stringnullable

Cosmos user id.

datacollections[]ownerhandle
string

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

datacollections[]ownerdisplayName
stringnullable

Full name.

datacollections[]owneravatarUrl
stringnullable

Profile picture.

datacollections[]ownerisVerified
booleannullable

True when Cosmos verified the profile.

datacollections[]ownerurl
string

Profile page.

datacollections[]coverUrl
stringnullable

Cover image.

datacollections[]postCount
integernullable

Posts in it.

datacollections[]followers
integernullable

Followers, when Cosmos shows them.

datacollections[]collaboratorCount
integernullable

People who add to it, the owner included.

datacollections[]subCollectionCount
integernullable

Collections inside it.

datacollections[]isFeatured
booleannullable

True when Cosmos features it.

datatotal
integernullable

How many public collections the account has.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

datapagetruncated
boolean

True when the list stops here before its end: more rows exist (see `total`) but no further page can be read.

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/collections" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Cosmos account's collections.