Kuaishou (China)

Kuaishou Search API

Run Kuaishou (China)'s own mixed search for a keyword and get back what the app shows: ranked videos with full engagement counts, plus the related-search suggestions Kuaishou surfaces alongside them, as JSON. Costs 10 credits per page — Kuaishou is priced per endpoint (1, 2, 10 or 40), and all four search endpoints are the 10. Cursor-paginated. If you only want one result type, the dedicated video, user and live search endpoints cost the same and come back already filtered.

POST/api/v1/kuaishou/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

keywordstringrequired

Search keyword, 1 to 200 characters. Kuaishou is a Chinese-language platform: Chinese queries return the deep catalogue, and a Latin-script query returns whatever Kuaishou itself matches, which is usually much thinner. No boolean or field syntax is supported.

Example: 美妆

cursorstring

Opaque pagination cursor. Omit it for the first page, then pass back the pcursor value from the previous response. The response field is called pcursor, not next_cursor. Do not send recoPcursor — that is a separate cursor for Kuaishou's recommendation stream. A pcursor of "no_more" means there are no further pages.

Example: 1

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# 10 credits PER PAGE - budget before you loop.
cursor = None
for _ in range(5):
    page = client.kuaishou.search(keyword="美妆", cursor=cursor)
    for item in page["data"].get("mixFeeds", []):
        if item.get("itemType") == 5:                 # a video
            feed = item["feed"]
            print(feed["caption"], feed["view_count"], feed["share_info"])
        elif item.get("itemType") == 9:               # related searches
            print([s["keyword"] for s in item["relatedSearches"]])
    cursor = page["data"].get("pcursor")              # NOT next_cursor / recoPcursor
    if not cursor or cursor == "no_more":
        break

Response

"result": 1,

"pcursor": "1",

"recoPcursor": "no_more",

"isRecommendResult": false,

"llsid": "2006159769548023890"

"response_time": 20171,

"credits_used": 10,

"credits_remaining": 4763

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # 10 credits PER PAGE - budget before you loop. cursor = None for _ in range(5): page = client.kuaishou.search(keyword="美妆", cursor=cursor) for item in page["data"].get("mixFeeds", []): if item.get("itemType") == 5: # a video feed = item["feed"] print(feed["caption"], feed["view_count"], feed["share_info"]) elif item.get("itemType") == 9: # related searches print([s["keyword"] for s in item["relatedSearches"]]) cursor = page["data"].get("pcursor") # NOT next_cursor / recoPcursor if not cursor or cursor == "no_more": break