User Collections

GET/v1/cosmos/user/clusters1 credit

Returns a page of a user's public collections, each with name, description, cover image, post and follower counts and owner.

01Query parameters

Name	Type	Description
handlerequired	string	Cosmos username, e.g. `design` (a leading `@` or a profile URL is accepted too).
cursoroptional	string	The `cursor` value of the previous answer, to get the next page. The literal `null` returns an empty end page for free.

02Pricing

1 credit per page. `cursor=null` answers an empty end page (`end_of_pagination: true`) for 0 credits, and an empty page is free too.

03Request

curl "https://api.scrapesocial.ai/v1/cosmos/user/clusters?handle=design" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Responses

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

GET /v1/cosmos/user/clusters?handle=design

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "items": [
    {
      "id": 1444486570,
      "name": "ransom note lettering",
      "slug": "ransom-note-lettering",
      "description": "cut from whatever was lying around",
      "url": "https://www.cosmos.so/design/ransom-note-lettering",
      "cover_image_url": "https://cdn.cosmos.so/13ab2335-6d21-4cbb-899d-ebb313170a71",
      "post_count": 38,
      "follower_count": 957,
      "owner": {
        "id": 234172146,
        "username": "design",
        "full_name": "Design",
        "avatar_url": "https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0"
      }
    },
    {
      "id": 1691653994,
      "name": "kids tv logos",
      "slug": "kids-tv-logos",
      "description": "all i'd want to see when school was over",
      "url": "https://www.cosmos.so/design/kids-tv-logos",
      "cover_image_url": "https://cdn.cosmos.so/a3c300f7-9e89-4f3e-914e-e8d4e4afea73?rect=0,80,324,324",
      "post_count": 48,
      "follower_count": 957,
      "owner": {
        "id": 234172146,
        "username": "design",
        "full_name": "Design",
        "avatar_url": "https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0"
      }
    }
  ],
  "total_count": 70,
  "cursor": "eyJ2MSI6IjE5NzAtMDEtMDFUMDA6MDA6MDBaIiwidjIiOiIyMDI2LTA5LTIzVDIxOjE4OjIyLjQxMDY1NloiLCJ2MyI6MTUxMDg2Mzl9",
  "has_more": true
}

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"
}

05Notes

Collections are in `items` (20 per page), with `total_count`, `cursor` and `has_more`; on the last page `cursor` is null and `has_more` false. An unknown user is a free 404.

06Errors & 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.