Profile

GET/v1/kwai/profile1 credit

Returns a Kwai user's public profile: name, bio, avatar and background images, verification, follower, following and like counts, and post counts.

01Query parameters

Name	Type	Description
handleoptional	string	Kwai username, e.g. `KwaiBrasilOficial` (a leading `@` is ignored). One of `handle` or `url` is required.
urloptional	string	Kwai profile URL, e.g. `https://www.kwai.com/@KwaiBrasilOficial`. One of `handle` or `url` is required.

02Request

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

03Responses

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

GET /v1/kwai/profile?handle=KwaiBrasilOficial

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": 558843093,
  "eid": "3xyutri4afq3qks",
  "handle": "KwaiBrasilOficial",
  "username": "Kwai Brasil Oficial",
  "bio": "Votações abertas pro #PrêmioKwai2026!\nVote no seu criador favorito! 🏆",
  "url": "https://www.kwai.com/@KwaiBrasilOficial",
  "avatar_url": "https://ak-eg-pic.kwai.net/bs2/overseaHead/20261008020943_BNTU4ODQzMDkz_s.jpg?ocid=20022002",
  "avatar_urls": [
    {
      "cdn": "ak-eg-pic.kwai.net",
      "url": "https://ak-eg-pic.kwai.net/bs2/overseaHead/20261008020943_BNTU4ODQzMDkz_s.jpg?ocid=20022002"
    },
    {
      "cdn": "ak-eg-pic.kwai.net",
      "url": "https://ak-eg-pic.kwai.net/bs2/overseaHead/20261008020943_BNTU4ODQzMDkz_s.jpg"
    }
  ],
  "background_url": "https://aws-static.kwai.net/s1/i/def/bg3.jpg",
  "verified": true,
  "verified_description": "Conta Oficial",
  "verified_number": 3,
  "gender": "unknown",
  "follower_count": 1,
  "following_count": 1,
  "like_count": 17752846,
  "public_post_count": 3832,
  "private_post_count": 0,
  "is_private": false
}

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. Kwai hides the real follower and following counts of some accounts and reports 1 for them. An unknown profile is a free 404, a private one a free 403; a value that is neither a username nor a kwai.com profile URL 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.