Kuaishou (China)

Kuaishou Trending API

Read Kuaishou (China)'s live leaderboards — the hot-search list plus the live, shopping, brand and music rankings — one board per call, as JSON. The hot board comes back as 50 ranked keywords with Kuaishou's own heat score, which is the cheapest trend signal on the platform at 1 credit and the natural feed into Hashtag Feed or Video Search. Kuaishou is priced per endpoint (1, 2, 10 or 40); this is one of the 1s. Not paginated: one board, one snapshot.

POST/api/v1/kuaishou/trending

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

boardenum<string>default:hot

Which leaderboard to read. One board per call — there is no way to fetch several at once, and each call bills 1 credit. Each board is a DIFFERENT upstream ranking with its own response shape, so read the one you need once before mapping fields.

hot — Default. The hot-search keyword list: 50 ranked entries under data.hots, plus a pinned data.topHots.
live — The live-stream leaderboard.
shopping — The shopping / e-commerce leaderboard.
brand — The brand leaderboard.
music — The music ranking.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# 1 credit. Omitting board is the same as board="hot".
board = client.kuaishou.trending(board="hot")

for row in board["data"]["hots"][:10]:
    print(row["hotValue"], row["keyword"])

# Feed a trending keyword straight into the cheap discovery endpoints
top = board["data"]["hots"][0]["keyword"]
feed = client.kuaishou.tag_feed(tag=top)          # 1 credit
print(len(feed["data"].get("mixFeeds", [])), "posts for", top)

Response

"result": 1,

"llsid": "2009970839368476817"

"response_time": 1612,

"credits_used": 1,

"credits_remaining": 4731

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # 1 credit. Omitting board is the same as board="hot". board = client.kuaishou.trending(board="hot") for row in board["data"]["hots"][:10]: print(row["hotValue"], row["keyword"]) # Feed a trending keyword straight into the cheap discovery endpoints top = board["data"]["hots"][0]["keyword"] feed = client.kuaishou.tag_feed(tag=top) # 1 credit print(len(feed["data"].get("mixFeeds", [])), "posts for", top)