Cosmos

Get Cosmos collection

Get a Cosmos collection by URL with its owner, size and followers.

GET/v1/cosmos/collections
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
urlstringrequiredquery

Link to the Cosmos collection, as in https://www.cosmos.so/joris.kahl/teh-nerd-stuff.

min 1 chars · max 512 chars

Response fields
27

Endpoint-specific response payload.

datalookupStatus
string

`not_found` for a private, removed or unknown collection.

one of: found, not_found

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

datacollectionid
string

Cosmos collection (cluster) id.

datacollectionname
stringnullable

Collection name.

datacollectionslug
stringnullable

The name in its link.

datacollectionurl
stringnullable

Collection page.

datacollectiondescription
stringnullable

Description.

The owner.

datacollectionownerid
stringnullable

Cosmos user id.

datacollectionownerhandle
string

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

datacollectionownerdisplayName
stringnullable

Full name.

datacollectionowneravatarUrl
stringnullable

Profile picture.

datacollectionownerisVerified
booleannullable

True when Cosmos verified the profile.

datacollectionownerurl
string

Profile page.

datacollectioncoverUrl
stringnullable

Cover image.

datacollectionpostCount
integernullable

Posts in it.

datacollectionfollowers
integernullable

Followers, when Cosmos shows them.

datacollectioncollaboratorCount
integernullable

People who add to it, the owner included.

datacollectionsubCollectionCount
integernullable

Collections inside it.

datacollectionisFeatured
booleannullable

True when Cosmos features it.

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/collections?url=https://www.cosmos.so/joris.kahl/teh-nerd-stuff" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Cosmos collection.