> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/kwai>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/kwai.mdx>

---

# Kwai API. Creators and videos as JSON.

Look up a Kwai creator, walk all their videos, and open any video with its counts and transcript. Every response uses the same envelope.

- Profiles + videos
- Every page
- 1 credit per request

`GET /v1/kwai/profiles/{handle}` returns a Kwai creator: display name, bio, avatar, verification, creator level and counts for followers, following, public videos and likes received. `/v1/kwai/profiles/{handle}/videos` walks every public video of that creator, about 20 a page, newest first.

`GET /v1/kwai/videos?url=` opens one video with its caption, hashtags, duration, cover and file, views, likes, comments and shares, the creator and Kwai's transcript. Every answer is JSON in the `{ data, meta }` envelope with `data.lookupStatus`; the videos list reports `page.nextCursor` and `page.hasMore`. A miss comes back as `lookupStatus: not_found`, not as an HTTP error.

## What you can get

- Creator profile with bio, avatar, cover, verification, creator level and counts.
- Every public video of a creator, a page at a time, newest first.
- Single videos with caption, hashtags, duration, cover, file, counts and transcript.

## Kwai endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Profile | GET /v1/kwai/profiles/{handle} | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/kwai/profiles/handle/get) |
| Profile videos | GET /v1/kwai/profiles/{handle}/videos | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/kwai/profiles/handle/videos/get) |
| Video | GET /v1/kwai/videos | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/kwai/videos/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try every route on a few creators.
2. **Pick the creator or video.** Use the Kwai id from the profile link, for example `GET /v1/kwai/profiles/KwaiBrasilOficial`, or a video link for `GET /v1/kwai/videos?url=`. Send `x-api-key` on every request.
3. **Branch and page.** Check `data.lookupStatus` before you store a row. Keep requesting with `page.nextCursor` while `page.hasMore` is true, and bill from `meta.creditsCharged`.

## Pricing

Each Kwai route charges a flat credit amount per completed request, shown on every endpoint page. Each page of videos is its own request. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Social Fetch gives every Kwai route one JSON shape: ISO 8601 UTC timestamps, numeric counts, plain-text captions with their hashtags, video ids as strings, typed `lookupStatus` responses and opaque cursors. You do not need a Kwai account, an app registration or a user session.

## FAQ

### What Kwai data can I get from the API?

Creator profiles, every public video of a creator, and single videos with their counts, files and transcript.

### How do I name a Kwai creator?

Use the Kwai id from the profile link, with or without the @, for example KwaiBrasilOficial or Turma.resenha. An unknown id returns lookupStatus: not_found with profile: null.

### How do I get all of a creator's videos?

Call /v1/kwai/profiles/{handle}/videos and keep passing page.nextCursor back as cursor until page.hasMore is false. Each page has about 20 videos.

### Can I store the video file link?

No. videoUrl is a signed link that expires after a few hours. Download the file if you need it; the video page url stays valid.

### Are video ids numbers or strings?

Strings. Kwai's ids are larger than many languages can hold as numbers, so they are always returned as text.

### Are comments available?

Not yet. Kwai does not show comments to visitors who are not signed in; each video carries its comment count.

### How much does the Kwai API cost?

Every Kwai route charges a flat amount per completed request, shown on each endpoint page, and each page of videos is billed separately. A found or not-found answer is a completed request and costs that amount; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.

## Related

- [Kwai Profile API](https://www.socialfetch.dev/platforms/kwai/profiles-handle): Bio, verification and counts (`GET /v1/kwai/profiles/{handle}`).
- [Kwai Profile Videos API](https://www.socialfetch.dev/platforms/kwai/profiles-handle-videos): Every public video of a creator (`GET /v1/kwai/profiles/{handle}/videos`).
- [Kwai Video API](https://www.socialfetch.dev/platforms/kwai/videos): One video with counts, files and transcript (`GET /v1/kwai/videos`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language Kwai question to the matching operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Kwai tools from Cursor or Claude with the same credit metering as REST.
