Profile

GET/v1/cosmos/profile1 credit

Returns a Cosmos (cosmos.so) user's public profile: name, bio, avatar, website, verification and premium status, follower, following and public post counts, and linked Instagram, X and TikTok accounts.

01Query parameters

Name	Type	Description
handlerequired	string	Cosmos username, e.g. `design` (a leading `@` or a profile URL is accepted too).

02Request

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

03Responses

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

GET /v1/cosmos/profile?handle=design

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": 234172146,
  "username": "design",
  "full_name": "Design",
  "url": "https://www.cosmos.so/design",
  "bio": "where systems learn to speak to people",
  "avatar_url": "https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0",
  "website_url": null,
  "is_premium": true,
  "is_verified": false,
  "follower_count": 957,
  "following_count": 1,
  "public_post_count": 25,
  "instagram_url": null,
  "twitter_url": null,
  "tiktok_url": null
}

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 profile fields sit at the top level of the answer. An unknown user is a free 404.

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.