# Kwai (/docs/kwai)



Kwai [#kwai]

Kwai is Kuaishou's international short-video app, and it is where a large share of Brazilian,
Latin American and Southeast Asian short-form creators publish — audiences that barely register
on TikTok's international index. Three endpoints cover it: an account snapshot, that account's
feed, and one post in detail. All three are 1 credit.

Base URL: `/v1/kwai/...`

<Callout>
  Kwai post URLs take the form 

  `kwai.com/@{handle}/photo/{id}`

   

  **for videos as well as photos**

  . Do not filter on the 

  `/photo/`

   path segment to detect media type.
</Callout>

Getting started [#getting-started]

Every endpoint is a `GET` with query parameters and an `x-api-key` header. Accounts are
addressable by `handle` (without the `@`) or by profile `url` — one of the two is required, and
sending neither is a `400` before billing.

```bash
# 1. The account
curl "https://www.socialcrawl.dev/v1/kwai/profile?handle=KwaiBrasilOficial" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

# 2. Its posts, cursor-paged
curl "https://www.socialcrawl.dev/v1/kwai/user/posts?handle=KwaiBrasilOficial&count=50" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"
```

What each endpoint gives you [#what-each-endpoint-gives-you]

`profile` returns the account's username, bio, avatar, verification status, and its follower,
following, like and post counts.

`user/posts` returns a page of public posts, each with the caption, video and cover URLs,
engagement counts and author details. `count` sets the page size up to 50, and the response
carries a `cursor` to pass back for the next page. This is the endpoint to walk when you are
building a creator's history.

`post` takes a single post `url` and returns that one video in full — caption, video and cover
URLs, view, like, comment and share counts, author details, and **the music track used**. That
last field is the reason to reach for `post` over a feed row when you are tracking a sound.

```bash
curl "https://www.socialcrawl.dev/v1/kwai/post?url=https://www.kwai.com/@KwaiBrasilOficial/photo/5193363430624671876" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"
```

Endpoints [#endpoints]

<PlatformEndpoints platform="kwai" />

Read this before you build [#read-this-before-you-build]

**Post URLs say `/photo/` even for videos.** A Kwai post URL takes the form
`kwai.com/@{handle}/photo/{id}` regardless of media type. Do not filter on the path segment.

**There is no keyword search and no comment endpoint here.** Discovery and comment threads are
not covered on this platform — start from a handle or a URL you already have. For cross-platform
keyword discovery, [`/v1/search/everywhere`](/docs/search/everywhere.md) is the right call.

**Regional coverage is the point.** If you are researching a Brazilian or Southeast Asian
creator and TikTok's index looks thin, checking Kwai for the same handle is usually worth one
credit.

Notes [#notes]

* All endpoints use `GET` with query parameters
* Authentication via the `x-api-key` header
* Responses follow the unified SocialCrawl schema
* All three endpoints are 1 credit
* `handle` is passed without the leading `@`