Collection

GET/v1/cosmos/cluster1 credit

Returns a Cosmos collection: name, description, cover image, post and follower counts, owner and its sub-collections.

01Query parameters

Name	Type	Description
urlrequired	string	Collection URL, e.g. `https://www.cosmos.so/design/the-best-band-posters`.

02Request

curl "https://api.scrapesocial.ai/v1/cosmos/cluster?url=https%3A%2F%2Fwww.cosmos.so%2Fdesign%2Fthe-best-band-posters" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/cosmos/cluster?url=https%3A%2F%2Fwww.cosmos.so%2Fdesign%2Fthe-best-band-posters

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": 1632840802,
  "name": "the best band posters",
  "slug": "the-best-band-posters",
  "description": "have you seen one of these in a room before?",
  "url": "https://www.cosmos.so/design/the-best-band-posters",
  "cover_image_url": "https://cdn.cosmos.so/images/b3964bde-a6d7-418d-91a6-09b1b7b6b9aa?rect=0,0,736,736",
  "post_count": 46,
  "follower_count": 1156,
  "owner": {
    "id": 234172146,
    "username": "design",
    "full_name": "Design",
    "avatar_url": "https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0"
  },
  "subcollections": []
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

The collection fields sit at the top level of the answer, with the sub-collections in `subcollections`. An unknown collection is a free 404; a URL that is not a Cosmos collection is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.