Xiaohongshu Get Product Recommendations
Get related product recommendations using a product SKU ID. Inputs: - sku_id (required): A valid product SKU ID, supplied as a string. - cursor_score (optional, default ""): Leave empty or omit for the first page. For the next page, use the cursor_score returned in the previous response. - region (optional, default "US"): Region for the request. Returns: Recommended product list data in the response's data field. The documented response does not specify individual product fields. Note: An incorrect or nonexistent SKU ID may still receive a normal response, but data may contain a service error instead of recommendations. Check the returned data before using it.
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.65 credits/call |
20.65 credits/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 |
|---|---|---|---|---|
region | string | No | 地区/Region | US |
sku_id | string | Yes | 商品SKU ID/Product SKU ID | — |
cursor_score | string | No | 分页游标,首次请求留空/Pagination cursor, leave empty for first request | "" |
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_product_recommendations' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"sku_id": "68b949999a16410001c59e0b"
}
}'{
"code": 200,
"data": {
"code": 0,
"data": {
"components": [
{
"component_data": {
"component_v_o_list": [],
"empty": false,
"extra_info": {},
"has_more": true
},
"component_name": "DefaultMixCardComponentV2"
}
],
"result": {
"success": true
}
}
},
"docs": "https://api.tikhub.io/#/Xiaohongshu-App-V2-API/get_product_recommendations_api_v1_xiaohongshu_app_v2_get_product_recommendations_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "71daccb7-e62e-4459-919e-0802bf1308da"
}This example shows part of the response. Copied content is valid JSON.

