Xiaohongshu Get Keyword Stat
## Xiaohongshu keyword overview Look up a keyword's site-wide popularity and the aggregate profile of cooperating bloggers to support keyword comparison and content planning. ### Input Provide `request_body.search_word` as a string of 1–100 characters, for example: ```json {"request_body":{"search_word":"面膜"}} ``` The request body accepts only `search_word`. ### Results The business payload is located at `response.data.data` when available: - `searchWordData`: `searchScore` is the search index, `noteNum` is the related note count, `userNum` is the number of search users, and `readNum` is the read count. Each metric has a corresponding `*30bm` field describing its 30-day percentage change. - `wordKolProfile`: aggregate content-category and persona shares for cooperating bloggers. This is not a list of individual bloggers or a demographic profile of people searching the keyword. A null payload indicates no result; it should not be treated as zero for every metric. The tool returns an overview, not daily trends or related-keyword lists. Search index and note count can help compare interest with content supply, but do not by themselves establish a keyword's competitiveness.
Pricing
| Condition | Charge |
|---|---|
| Each call | 41.31 credits/call |
The fixed fee for each keyword overview query is 41.31 credits per call. Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 关键词概览查询的请求体对象,包含 search_word 字段,用于指定要查询小红书全站热度统计及合作博主画像的关键词。 | — |
request_body.search_word | string | Yes | 关键词,如 面膜/Keyword | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_xiaohongshu_get_keyword_stat' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"search_word": "走走"
}
}
}'{
"code": 200,
"data": {
"code": 0,
"data": {
"searchWordData": {
"brandTag": 0,
"cmtNum": 152622,
"dateKey": null,
"engageNum": 7614971,
"engageNum30bm": "-20.3",
"favNum": 1132859
},
"wordKolProfile": {
"contentTagStat": [
{
"name": "出行旅游",
"percent": 33.5
}
],
"fansStat": [
{
"end": 5000,
"percent": 61.7,
"start": 1000
}
],
"featureTagStat": [
{
"name": "露营徒步",
"percent": 21.3
}
],
"personalTagStat": [
{
"name": "户外爱好者",
"percent": 42.0
}
],
"picPriceStat": [
{
"end": 1000,
"percent": 80.7,
"start": 0
}
],
"videoPriceStat": [
{
"end": 1000,
"percent": 79.5,
"start": 0
}
]
}
},
"guid": null,
"msg": "成功",
"success": true
},
"docs": "https://api.tikhub.io/#/Xiaohongshu-PGY-API/get_keyword_stat_api_v1_xiaohongshu_pgy_get_keyword_stat_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"search_word": "走走"
}
}This example shows part of the response. Copied content is valid JSON.

