Kwai

List Kwai profile videos

List a Kwai creator's videos, newest first, about 20 a page with a cursor.

GET/v1/kwai/profiles/{handle}/videos
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
handlestringrequiredpath

Kwai id from the profile link, with or without a leading @, for example `KwaiBrasilOficial`.

min 1 chars · max 65 chars

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same handle.

min 1 chars · max 4096 chars

Response fields
47

Endpoint-specific response payload.

datalookupStatus
string

`private` when the account is private: Kwai shows logged-out visitors none of its videos, so the list is empty. `not_found` when no account has this Kwai id.

one of: found, private, not_found

The account, when the page names it; null when `private` or `not_found`.

dataprofileid
stringnullable

Kwai's numeric user id, the same on every endpoint.

dataprofileencryptedId
stringnullable

Kwai's encrypted user id (its `eid`), as in m.kwai.com/user/{encryptedId}, when the page carries it.

dataprofilehandle
string

Kwai id, as in kwai.com/@{handle}.

dataprofiledisplayName
stringnullable

Display name.

dataprofileavatarUrl
stringnullable

Profile picture.

dataprofileisVerified
booleannullable

True when Kwai verified the account.

dataprofileurl
string

Profile page.

dataprofileisBanned
booleannullable

True when Kwai banned the account. Kwai then shows no videos, so the list is empty.

Newest first, with pinned videos where the creator put them.

datavideos[]id
string

Kwai video id.

datavideos[]url
string

Video page.

datavideos[]caption
stringnullable

Caption as plain text.

Hashtags in the caption, without the `#`.

datavideos[]hashtags[]
stringoptional
datavideos[]createdAt
stringnullable

When the video was posted, ISO 8601 UTC.

datavideos[]durationSeconds
numbernullable

Length in seconds, when known.

datavideos[]width
integernullable

Width in pixels.

datavideos[]height
integernullable

Height in pixels.

datavideos[]coverUrl
stringnullable

Cover image.

datavideos[]videoUrl
stringnullable

The MP4 file. A signed link that expires after a few hours: download it, do not store it.

Engagement counters as Kwai reports them.

datavideos[]statsviews
integernullable

Views.

datavideos[]statslikes
integernullable

Likes.

datavideos[]statscomments
integernullable

Comments.

datavideos[]statsshares
integernullable

Shares.

datavideos[]soundName
stringnullable

The sound's name, or the creator of an original sound.

datavideos[]isPinned
booleannullable

True when the creator pinned it to the top of the profile.

The creator.

datavideos[]authorid
stringnullable

Kwai's numeric user id, the same on every endpoint.

datavideos[]authorencryptedId
stringnullable

Kwai's encrypted user id (its `eid`), as in m.kwai.com/user/{encryptedId}, when the page carries it.

datavideos[]authorhandle
string

Kwai id, as in kwai.com/@{handle}.

datavideos[]authordisplayName
stringnullable

Display name.

datavideos[]authoravatarUrl
stringnullable

Profile picture.

datavideos[]authorisVerified
booleannullable

True when Kwai verified the account.

datavideos[]authorurl
string

Profile page.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/kwai/profiles/Turma.resenha/videos" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Kwai creator's videos.