Kwai User Posts API

What is the Kwai User Posts API?

Pass a Kwai profile URL or @handle and get that creator's public posts as clean JSON. Each post: id/url, text (the post caption only — empty string when none; never Kwai's SEO title / "Áudio original criado por …" boilerplate), hashtags[] (always present — [] when the caption has no tags), publishedAt, durationSeconds, thumbnailUrl, videoUrl with videoType ("mp4" or "hls"), mediaUrlsExpireAt parsed from the signed CDN tag=, engagement{views,likes,comments,shares}, and transcript when Kwai's JSON-LD auto-captions are present (duplicate merged tracks are deduped). Author{id,username,displayName,avatar,url} is returned once at the top — not repeated on every row. Envelope uses url (the requested profile) — same key as /kwai/post and /kwai/profile. HARD PAGE LIMIT: Kwai's public web only SSR-embeds a first-page window of posts (typically a handful — observed ~6 on large accounts), not the full postCount from /kwai/profile. hasMore/nextCursor page within that window; hasMore=false means the window is exhausted, not that the account has no more posts upstream. ~1 credit per post returned (min 2; default limit 20 → ~20 credits). Transcript is included when Kwai publishes it — not a separate Whisper bill. Shares _normalize_post with /kwai/post.

What you get

• Posts with engagement + signed mp4 videoUrl
• hashtags[] always present ([] when none)
• hasMore/nextCursor within SSR first-page window
• Author{} once; envelope url

Platform limits

Honest ceilings from the upstream platform surface — not Captapi bugs. Unexpected truncation here is usually the platform, not us.

• hasMore=false is end of Kwai's SSR first-page window, not the account archive. Use /kwai/profile postCount for universe size — there is no public deep-archive pagination API.

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

curl "https://api.captapi.com/v1/kwai/user-posts?url=https%3A%2F%2Fwww.kwai.com%2F%40topfilmeseseriesnatv" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Example response

{
  "success": true,
  "data": {
    "profileUrl": "https://www.kwai.com/@topfilmeseseriesnatv",
    "author": {
      "id": "3x9mhse7ekkvfa9",
      "username": "topfilmeseseriesnatv",
      "displayName": "Topseriesfilmetv",
      "avatar": "https://aws-br-pic.kwai.net/bs2/overseaHead/20250507231107_BMTUwMDAxNDU1MDE5OTQ1_s.jpg",
      "url": "https://www.kwai.com/@topfilmeseseriesnatv"
    },
    "totalReturned": 5,
    "nextCursor": null,
    "hasMore": false,
    "posts": [
      {
        "platform": "kwai",
        "id": "5240932700689736196",
        "url": "https://www.kwai.com/@topfilmeseseriesnatv/video/5240932700689736196",
        "transcript": "BANDIDO ESTAVA ESPERANDO ELE NA SAIDA DO BANCO.",
        "publishedAt": "2026-01-24T00:50:13Z",
        "durationSeconds": 156,
        "thumbnailUrl": "https://aws-br-pic.kwai.net/upic/2026/01/24/08/BMjAyNjAxMjQwODQ4MTNfMTUwMDAxNDU1MDE5OTQ1XzE1MDExMDI4NTA4NDg3NF8yXzM=_oscn2_Befd2f922b58f2b5f72e4cb3c375d043d.webp",
        "videoUrl": "https://aws-br-cdn.kwai.net/upic/2026/01/24/08/BMjAyNjAxMjQwODQ4MTNfMTUwMDAxNDU1MDE5OTQ1XzE1MDExMDI4NTA4NDg3NF8yXzM=_b_Bf1ce0ec42b4fe4482cd50678b3abd2d4.mp4?tag=1-1784753172-s-0-afgxvdpz8w-4a78f339bd4accdf",
        "engagement": {
          "views": 138841,
          "likes": 9232,
          "comments": 91,
          "shares": 169
        },
        "videoType": "mp4",
        "mediaUrlsExpireAt": "2026-07-22T20:46:12.000Z"
      },
      {
        "platform": "kwai",
        "id": "5197304080333126332",
        "url": "https://www.kwai.com/@topfilmeseseriesnatv/video/5197304080333126332",
        "publishedAt": "2026-07-21T01:41:02Z",
        "durationSeconds": 125,
        "thumbnailUrl": "https://p16-kimg.kwai.net/kimg/EKzM1y8qmQEKAnMzEg1waG90by1vdmVyc2VhGoMBdXBpYy8yMDI2LzA3LzIxLzAxL0JNakF5TmpBM01qRXdNVFF3TVRCZk1UVXdNREF4TkRVMU1ERTVPVFExWHpFMU1ERXhNVEUwTlRFMU9UUTBNRjh5WHpNPV9vdXVfQjVkMzdmMDZiZTFmMmU5NjQ0MGNkNjhhMjc3ZTg1MjRlLndlYnA.webp",
        "videoUrl": "https://aws-br-cdn.kwai.net/upic/2026/07/21/01/BMjAyNjA3MjEwMTQwMTBfMTUwMDAxNDU1MDE5OTQ1XzE1MDExMTE0NTE1OTQ0MF8yXzM=_b_B9e078740aaad1692190abe5e2e2e61c6.mp4?tag=1-1784753179-s-0-46g59inljw-0d434501e8fb5c1c",
        "engagement": {
          "views": 8998,
          "likes": 441,
          "comments": 7,
          "shares": 16
        },
        "videoType": "mp4",
        "mediaUrlsExpireAt": "2026-07-22T20:46:19.000Z"
      }
    ]
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs ~20 credits (1/result) — billed per result, so the exact amount scales with how many items you request. Pass cache=true for a free 24h cache hit; default is always fresh (metrics refresh within ~1 hour).

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/kwai/user-posts and parse the JSON response.

Use cases

Frequently asked questions

More Kwai APIs