Kwai API

Get Kwai data as clean JSON with one key: 3 endpoints, 2 credits per call, the same response shape as every other platform.

What you get#

Onekey exposes Kwai as 3 endpoints behind one API key: 2 endpoints return one record (data is an object) and 1 endpoint return a list (data is an array). Every answer uses the same envelope (success, data, metadata, error), the cost is reported in metadata.credits_charged, and fields are mapped onto the unified schema so the code you write for Kwai also works for the rest of the social networks category.

Endpoints#

EndpointWhat it doesParametersCreditsStatus
postGet a Kwai post.url*2beta needs a pack
profileGet a Kwai user profile.handle, url2beta needs a pack
user_postsList a Kwai user's posts.handle, url, cursor2beta needs a pack

A * marks a required parameter. Each endpoint name links to its reference page with the full parameter table, caching window and a recorded response.

Make a request#

This calls kwai.post (2 credits, beta). Replace YOUR_API_KEY with your key; sign up, no card. 1,000 free credits cover the open-platform endpoints. Hard-to-reach platforms (X, TikTok, Instagram, Reddit, and others marked on their page) need a verified email and a purchased pack.

curl "https://api.onekey.dev/v1/kwai/post?url=https%3A%2F%2Fwww.kwai.com%2F%40kwaiuser%2Fvideo%2F5123456789" \
  -H "x-api-key: YOUR_API_KEY"

Fields you get back#

These unified fields come back from Kwai, with the same names as on every other platform. The count is how many of its 3 mapped endpoints return the field; a field the source lacks is null, never missing.

FieldTypeEndpoints
author.usernamestring3
content.createdAtISO 8601 date2
content.idstring2
content.textstring2
content.titlestring2
content.urlURL2
engagement.commentsinteger2
engagement.likesinteger2
engagement.sharesinteger2
engagement.viewsinteger2
media.thumbnailUrlURL2
author.avatarUrlURL1
author.biostring1
author.contentCountinteger1
author.displayNamestring1
author.followersinteger1
author.followinginteger1
author.idstring1
author.urlURL1
author.verifiedboolean1

The full schema is in Unified schema.

Pricing#

Every Kwai endpoint costs 2 credits per call. Free when served from cache (0.2 credit for a cached response over 100 KB). Invalid, failed or not-found calls are not charged. See pricing for credit packs.