Search Xiaohongshu hot content by keyword
justoneapi.x.xiaohongshu-hot-search-v1Searches Xiaohongshu (RedNote) hot-content entries with optional keyword, pagination, ranking metric, and time-range controls.
- Price
- $0.02214/successAt provider cost
- Success rate
- —No success-rate data yetNo success-rate data yet
- Latency p50
- ——
- Last verified
- Jul 28, 2026Verified working
GEThttps://toolswitch.dev/v1/tools/justoneapi.x.xiaohongshu-hot-search-v1?nd=DAY_7&orderBy=premium_imp_num&pageNum=1&searchWord=%E5%92%96%E5%95%A1Preview- Uses platform quota
- Synchronous response
- Reads public data
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Query parameters | ||||
nd | string | Optional | Time range in days. Available Values: - `DAY_3`: Last 3 days - `DAY_7`: Last 7 days - `DAY_14`: Last 14 days - `DAY_30`: Last 30 days One of: DAY_3, DAY_7, DAY_14, DAY_30. | DAY_7 |
orderBy | string | Optional | Sort metric for the result set. Available Values: - `premium_imp_num`: Exposure - `premium_good_read_rate`: Read rate - `premium_read_num`: Read count - `premium_engage_num`: Engagement count - `premium_engage_rate`: Engagement rate - `premium_like_num`: Like count - `premium_fav_num`: Favorite coun One of: premium_imp_num, premium_good_read_rate, premium_read_num, premium_engage_num, premium_engage_rate, premium_like_num, premium_fav_num, premium_cmt_num. | premium_imp_num |
pageNum | integer | Optional | Page number for pagination. | 1 |
searchWord | string | Optional | Search keyword. | |
- Query parameters
ndstringOptionalTime range in days. Available Values: - `DAY_3`: Last 3 days - `DAY_7`: Last 7 days - `DAY_14`: Last 14 days - `DAY_30`: Last 30 days One of: DAY_3, DAY_7, DAY_14, DAY_30.
Example:
DAY_7orderBystringOptionalSort metric for the result set. Available Values: - `premium_imp_num`: Exposure - `premium_good_read_rate`: Read rate - `premium_read_num`: Read count - `premium_engage_num`: Engagement count - `premium_engage_rate`: Engagement rate - `premium_like_num`: Like count - `premium_fav_num`: Favorite coun One of: premium_imp_num, premium_good_read_rate, premium_read_num, premium_engage_num, premium_engage_rate, premium_like_num, premium_fav_num, premium_cmt_num.
Example:
premium_imp_numpageNumintegerOptionalPage number for pagination.
Example:
1searchWordstringOptionalSearch keyword.
Code samples
Replace $TOOLSWITCH_KEY with the key you created in the console.
curl -X GET 'https://toolswitch.dev/v1/tools/justoneapi.x.xiaohongshu-hot-search-v1?nd=DAY_7&orderBy=premium_imp_num&pageNum=1&searchWord=%E5%92%96%E5%95%A1' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/justoneapi.x.xiaohongshu-hot-search-v1?nd=DAY_7&orderBy=premium_imp_num&pageNum=1&searchWord=%E5%92%96%E5%95%A1",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/justoneapi.x.xiaohongshu-hot-search-v1?nd=DAY_7&orderBy=premium_imp_num&pageNum=1&searchWord=%E5%92%96%E5%95%A1", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.02214/success, including the service fee.