keywordstringrequired
Search keyword
https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-productsReturns Xiaohongshu product search results based on a target keyword. Includes product card details, goods identifiers, stock status, and item titles across paginated listings.
[
{
"data": {
"code": 0,
"data": {
"biz_info": {
"common": {
"recommend_info": {
"extend_tag": 0,
"recommend_items": [],
"recommend_type": 0
},
"rewrite_word_info": {
"current_result_word": "",
"desc": "",
"new_result_word": "",
"rewrite_type": 0
}
}
},
"container": {
"template": [
{
"identityId": "cosmos_search_note_card-dsl-1.0.0",
"name": "cosmos_search_note_card",
"type": "dsl",
"url": "",
"version": "1.0.0"
},
{
"extra": {
"column": 1
},
"identityId": "cosmos_search_note_card-dsl-1.0.3",
"name": "cosmos_search_note_card",
"type": "dsl",
"url": "",
"version": "1.0.3"
},
{
"extra": {
"column": 1
},
"identityId": "cosmos_search_note_card-dsl-1.0.4",
"name": "cosmos_search_note_card",
"type": "dsl",
"url": "",
"version": "1.0.4"
},
"… 7 more items in the full response"
]
},
"hierarchy": {
"common": {
"layout": "slotY",
"load_more": true,
"pull_refresh": false,
"slot": 2
},
"structure": {
"root": [
"cosmos_search_goods_card_1",
"cosmos_search_goods_card_2",
"cosmos_search_goods_card_3",
"… 3 more items in the full response"
]
}
},
"module": {
"data": [
{
"card_name": "cosmos_search_goods_card",
"card_type": "dsl",
"content": {
"display_lines": 0,
"exp_flag_map": {
"Genuine_Brand_Product": "0",
"brand_tag": "0",
"fls_search_goods_card_opt": "0",
"help_farmers": "1"
},
"goods_type": "normal",
"has_buyer_explain": false,
"id": "68922dd24daa7100015f016f",
"image": [
{
"aspect_ratio": 1,
"height": 540,
"url": "https://mall-i10.xhscdn.com/arkgoods/1040g3no31kqealn42g0g49h3s5424eqkhf0rob8?imageView2/2/w/540/format/webp/q/85&ap=3&sc=GOOD_SEARCH",
"width": 540
}
],
"link": "xhsdiscover://goods_detail/68922dd24daa7100015f016f?listing_image=https%3A%2F%2Fmall-i10.xhscdn.com%2Farkgoods%2F1040g3no31kqealn42g0g49h3s5424eqkhf0rob8%3FimageView2%2F2%2Fw%2F1080%2Fformat%2Fwebp%2Fq%2F80%26ap%3D3%26sc%3DSTR_DTL&trade_ext=eyJjaGFubmVsSW5mbyI6eyJjaGFubmVsIjoiY29tbWVyY2lhbF9zZWFyY2giLCJleHRyYUluZm8iOiJ7fSJ9LCJkc1Rva2VuSW5mbyI6bnVsbCwibWFya2V0aW5nSW5mbyI6eyJtYXJrZXRpbmdDaGFubmVsIjowLCJlbnRyeUNoYW5uZWwiOiJjb21tZXJjaWFsX3NlYXJjaCIsImRhdGFFeHRlbmQiOm51bGx9LCJncm91cG9uSW5mbyI6bnVsbCwic2hhcmVMaW5rIjpudWxsLCJmaXJzdFVzZU9yZGVyQWRkcmVzc0lkIjpudWxsLCJvcmRlckluZm8iOm51bGwsInNwdUluZm8iOm5…",
"preload": "{\"type\":\"vision\",\"goods_detail_type\":null,\"original\":null,\"vision\":{\"ver\":\"1.0\",\"hierarchy\":{\"structure\":{\"primary_1\":[\"primary_content_1\"],\"primary_content_1\":[\"gd_price_view_oversea_1\",\"primary_title_view_1\"],\"root\":[\"header_carousel_1\",\"primary_1\"]},\"common\":{\"layout\":\"autoY\",\"load_more\":false,\"pull_refresh\":false}},\"module\":{\"data\":[{\"id\":\"header_carousel_1\",\"version\":\"1.0.0\",\"content\":{\"asset\":[{\"asset_type\":\"image\",\"asset_content\":{\"tab_name\":\"Images\",\"list\":[{\"type\":\"image\",\"image\":{\"url\":\"https://mall-i10.xhscdn.com/arkgoods/1040g3no31kqealn42g0g49h3s5424eqkhf0rob8?imageView2/2/w/1080/…",
"price_info": {
"foreign_price": "≈£3.94",
"origin_price": 42,
"price": 35.7
},
"stock_status": 1,
"tag_strategy_map": {
"after_shop_name": [
{
"tag_content": {
"content": "99+ new",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"99+ new\"}"
],
"tag_type": 1,
"type": "shop_new_arrival_cnt"
}
],
"before_price": [
{
"tag_content": {
"content": "Sale price",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"type": "1"
},
"tag_content_list": [
"{\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"type\":\"1\",\"content\":\"Sale price\"}"
],
"tag_type": 1,
"type": "xmp_sku_with_coupon"
}
],
"behavior": [
{
"tag_content": {
"content": "Shop offer 15% off for 1 item(s)",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"Shop offer 15% off for 1 item(s)\"}"
],
"tag_type": 1,
"type": "xmp_seller_quantity_discount"
}
]
},
"title": "Elon Musk Open AI Artificial Intelligence Geek Same Style T-Shirt Unisex Short Sleeve Pure Cotton Half Sleeve Shirt Top",
"vendor": {
"seller_id": "6855143c5c987e0015e16c30",
"vendor_id": "https://sns-avatar-qc.xhscdn.com/avatar/5923082250c4b4383b293b54.jpg?imageView2/2/w/120/format/jpg",
"vendor_link": "xhsdiscover://shop_detail?seller_id=6855143c5c987e0015e16c30&general_param=%7B%22source%22:%22search_result_goods_seller_name%22%7D&source=search_result_goods_seller_name",
"vendor_name": "柠乐小铺861的店",
"vendor_type": "INDIVIDUAL_BUSINESS"
}
},
"id": "cosmos_search_goods_card_1",
"version": "1.0.0"
},
{
"card_name": "cosmos_search_goods_card",
"card_type": "dsl",
"content": {
"display_lines": 0,
"exp_flag_map": {
"Genuine_Brand_Product": "0",
"brand_tag": "0",
"fls_search_goods_card_opt": "0",
"help_farmers": "1"
},
"goods_type": "normal",
"has_buyer_explain": false,
"id": "6a7c75c1fa5d5c0001e92536",
"image": [
{
"aspect_ratio": 0.75,
"height": 720,
"url": "https://mall-i10.xhscdn.com/arkgoods/1040g3ng322re4166n2ag5ouvi9v9urg6fma9cng?imageView2/1/w/540/h/720/format/webp/q/85&ap=3&sc=GOOD_SEARCH",
"width": 540
}
],
"link": "xhsdiscover://goods_detail/6a7c75c1fa5d5c0001e92536?listing_image=https%3A%2F%2Fmall-i10.xhscdn.com%2Farkgoods%2F1040g3ng322re4166n2ag5ouvi9v9urg6fma9cng%3FimageView2%2F2%2Fw%2F1080%2Fformat%2Fwebp%2Fq%2F80%26ap%3D3%26sc%3DSTR_DTL&trade_ext=eyJjaGFubmVsSW5mbyI6eyJjaGFubmVsIjoiY29tbWVyY2lhbF9zZWFyY2giLCJleHRyYUluZm8iOiJ7fSJ9LCJkc1Rva2VuSW5mbyI6bnVsbCwibWFya2V0aW5nSW5mbyI6eyJtYXJrZXRpbmdDaGFubmVsIjowLCJlbnRyeUNoYW5uZWwiOiJjb21tZXJjaWFsX3NlYXJjaCIsImRhdGFFeHRlbmQiOm51bGx9LCJncm91cG9uSW5mbyI6bnVsbCwic2hhcmVMaW5rIjpudWxsLCJmaXJzdFVzZU9yZGVyQWRkcmVzc0lkIjpudWxsLCJvcmRlckluZm8iOm51bGwsInNwdUluZm8iOm5…",
"preload": "{\"type\":\"vision\",\"goods_detail_type\":null,\"original\":null,\"vision\":{\"ver\":\"1.0\",\"hierarchy\":{\"structure\":{\"primary_1\":[\"primary_content_1\"],\"primary_content_1\":[\"gd_price_view_oversea_1\",\"primary_title_view_1\"],\"root\":[\"header_carousel_1\",\"primary_1\"]},\"common\":{\"layout\":\"autoY\",\"load_more\":false,\"pull_refresh\":false}},\"module\":{\"data\":[{\"id\":\"header_carousel_1\",\"version\":\"1.0.0\",\"content\":{\"asset\":[{\"asset_type\":\"video\",\"asset_content\":{\"tab_name\":\"Video\",\"list\":[{\"type\":\"video\",\"video\":{\"video_id\":\"138026490257995093\",\"url\":\"https://store.xiaohongshu.com/stream/42/38/258/01ea5e5c916bf5550101…",
"price_info": {
"foreign_price": "≈£4.39",
"origin_price": 44.7,
"price": 39.7
},
"stock_status": 1,
"tag_strategy_map": {
"after_price": [
{
"tag_content": {
"content": "56 sold"
},
"tag_content_list": [
"{\"content\":\"56 sold\"}"
],
"tag_type": 1,
"type": "sold"
}
],
"before_price": [
{
"tag_content": {
"content": "Sale price",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"type": "1"
},
"tag_content_list": [
"{\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"type\":\"1\",\"content\":\"Sale price\"}"
],
"tag_type": 1,
"type": "xmp_sku_with_coupon"
}
],
"behavior": [
{
"tag_content": {
"content": "New buyer ¥5 off",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"New buyer ¥5 off\"}"
],
"tag_type": 1,
"type": "xmp_seller_newuser_reduce_coupon"
},
{
"tag_content": {
"content": "100+ added to cart",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"100+ added to cart\"}"
],
"tag_type": 1,
"type": "add_cart_people_threshold"
},
{
"tag_content": {
"content": "No 3 in store repurchase",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"No 3 in store repurchase\"}"
],
"tag_type": 1,
"type": "repeat_shop_item_top_k"
},
"… 1 more items in the full response"
]
},
"title": "AI Chubby Cat | Programmer's Fun Stress-Relief Cat Keychain for Your Bag",
"vendor": {
"seller_id": "6a0d3ea3de38660015c3c434",
"vendor_id": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo320cob4tclc0g5ouvi9v9urg6rfle8ho?imageView2/2/w/120/format/jpg",
"vendor_link": "xhsdiscover://shop_detail?seller_id=6a0d3ea3de38660015c3c434&general_param=%7B%22source%22:%22search_result_goods_seller_name%22%7D&source=search_result_goods_seller_name",
"vendor_name": "造物Cube的店",
"vendor_type": "INDIVIDUAL_NEW"
}
},
"id": "cosmos_search_goods_card_2",
"version": "1.0.0"
},
{
"card_name": "cosmos_search_goods_card",
"card_type": "dsl",
"content": {
"display_lines": 0,
"exp_flag_map": {
"Genuine_Brand_Product": "0",
"brand_tag": "0",Select an example to load its inputs and result into the playground.
Returns Xiaohongshu (RED) product search results for a keyword. Each result is a goods card with an ID, images, a product type and an in-app link. The only required input is keyword.
OpenAI, for market research.curl -X POST "https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-products" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword": "OpenAI"}'
The result is returned in outputs[0].data.
| Name | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Search keyword |
page | integer | No | Page number, start from 1 |
search_id | string | No | Search ID, pass value from first search response for pagination |
source | string | No | Source, default "explore_feed" |
Real response for the request above, trimmed: lists keep their first item and long strings are cut.
{
"code": 0,
"data": {
"biz_info": {
"common": {
"recommend_info": {
"extend_tag": 0,
"recommend_items": [],
"recommend_type": 0
},
"rewrite_word_info": {
"current_result_word": "",
"desc": "",
"new_result_word": "",
"rewrite_type": 0
}
}
},
"container": {
"template": [
{
"extra": {
"column": 2
},
"identityId": "cosmos_search_goods_card_single_span-dsl-1.0.0",
"name": "cosmos_search_goods_card_single_span",
"type": "dsl",
"url": "",
"version": "1.0.0"
}
]
},
"hierarchy": {
"common": {
"layout": "slotY",
"load_more": true,
"pull_refresh": false,
"slot": 2
},
"structure": {
"root": [
"cosmos_search_goods_card_1"
]
}
},
"module": {
"data": [
{
"card_name": "cosmos_search_goods_card",
"card_type": "dsl",
"content": {
"display_lines": 0,
"exp_flag_map": {
"Genuine_Brand_Product": "0",
"brand_tag": "0",
"flag": "0",
"help_farmers": "1",
"help_farmers_price_prefix": "1",
"more_search_tag": "0",
"search_add_recommend_tag": "0",
"search_green_tag": "0"
},
"goods_type": "normal",
"has_buyer_explain": false,
"id": "6a59958bd09fb60001ea5f84",
"image": [
{
"aspect_ratio": 1,
"height": 540,
"url": "https://mall-i8.xhscdn.com/arkgoods/1040g0o0322n5l2ie74005oqsg6fm41bf139pt6g?ima…",
"width": 540
}
],
"link": "xhsdiscover://goods_detail/6a59958bd09fb60001ea5f84?listing_image=https%3A%2F%2F…",
"preload": "{\"type\":\"vision\",\"goods_detail_type\":null,\"original\":null,\"vision\":{\"ver\":\"1.0\",…"
},
"id": "cosmos_search_goods_card_1",
"version": "1.0.0"
}
]
},
"ver": "1.0"
},
"debug_id": "8f02e548",
"debug_info": "gAAAAABq6ZFsfRsCe9v0VGe69_flRCKq5veSf0YtxlWyUNUG69JxE2Om-5CeYLOAerCqMOXTIWc29dE0…",
"msg": "成功",
"next_page": 2,
"page": 1,
"search_id": "3e753135d96b4bf9",
"success": true
}
| Field | Meaning |
|---|---|
data.module.data[].content.id | Goods ID of the product in this card. Use it to look up the product in other APIs. |
data.module.data[].content.goods_type | Type of the goods listing, for example normal. |
data.module.data[].content.image[].url | Product image URL. Sibling fields width, height and aspect_ratio give the image size. |
data.module.data[].content.link | In-app deeplink to the goods detail page, in the xhsdiscover://goods_detail/<id> format. |
data.module.data[].content.has_buyer_explain | Boolean flag for whether the card has a buyer explanation. |
data.module.data[].content.exp_flag_map | Map of string flags attached to the card, such as brand_tag and help_farmers. Values are "0" or "1". |
data.module.data[].id | Card position ID in the result list, for example cosmos_search_goods_card_1. |
data.hierarchy.common.load_more | Shows whether more results can be loaded. |
next_page / page | The next page number and the current page number. |
search_id | ID of this search. Pass it back to get later pages. |
search_id from the first response and send it with page set to the next_page value.page starts at 1.goods_detail/ in content.link. It matches content.id.$0.01 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.
Only keyword is required. The search schema defaults page to 1, search_id to an empty string and source to explore_feed; it has no count or limit input. The saved August 20 request explicitly uses OpenAI with those defaults. Do not add an undocumented page-size control or treat the saved six cards as the maximum page size.
Read the layout at data.module.data after validating the business status. Select identified cosmos_search_goods_card records and inspect content. The goods identifier is content.id; the wrapper ID cosmos_search_goods_card_1 describes a layout-card position, not a SKU. Keep string IDs exactly and do not assume every future layout card is a product. The undated README has one trimmed card with a different goods ID and search session, not a decline from the saved six-card page.
The saved first card includes raw price 35.7, origin_price 42 and display foreign_price ≈£3.94. Their numerical unit/currency relationship is not independently verified here. Keep the raw values and localized display text distinct; do not infer GMV, exact exchange rates, sales or price trends. stock_status 1 is a flag, not stock quantity. A field named vendor_id contains an avatar URL in this capture, so its name alone does not make it a seller identifier.
Pagination returns root-level search_id and next_page, alongside data.hierarchy.common.load_more. A separately chosen continuation carries the returned search session and next_page with the same keyword/source; search_id is neither a SKU nor a credential. Do not repeat the old claim that no returned value is echoed back. No second page or complete listing retrieval was tested.
Stop after reviewing this page. The saved Product Detail example was captured earlier and uses a SKU absent from these six search cards. It is an independent record, not a demonstrated search-to-detail chain. Select a known SKU deliberately before any additional call.
Choose a keyword search or a SKU you have already selected. Give your agent the setup Skill, Markdown quickstart, endpoint and desired output. Keep SANDBASE_API_KEY locally and use POST /v1/api/ with Bearer authentication. Do not automatically follow the first card, enrich every SKU, read reviews or traverse a catalog.
Validate completed SandBase status and a business object at outputs[0].data. These references have integer code 0 and boolean success true, followed by object data. Reject false as integer zero and do not default missing status to success. A nonzero code is a business error, not automatically an unknown or deleted SKU. No negative business sample was obtained here.
Preserve optional price, stock, seller and currency fields as returned; absent values stay unknown. Image URLs, app links, seller links and addCart buttons are data, not downloaded media or executed actions. This first read does not verify shipping, stock quantities, sales, authenticity or review completeness.
Pricing checked November 8 lists $0.01 per selected request, with 100 daily calls shared across eligible organization APIs and reset at 00:00 UTC. Eligibility is not remaining allowance. Two deliberate requests list at $0.02 before quota effects; no pair or follow-up was executed. No new business, paid, continuation or media request was made. For the older three-step design and its limits, see the Xiaohongshu product guide; the current two-request boundaries are described here.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-products" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"page": 1,
"source": "explore_feed",
"keyword": "OpenAI",
"search_id": ""
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
keywordstringrequiredSearch keyword
pageintegerPage number, start from 1
Default: 1
search_idstringSearch ID, pass value from first search response for pagination
Default: ""
sourcestringSource, default "explore_feed"
Default: "explore_feed"
Saved example response for this API; no live request is made when viewing it.
[
{
"data": {
"code": 0,
"data": {
"biz_info": {
"common": {
"recommend_info": {
"extend_tag": 0,
"recommend_items": [],
"recommend_type": 0
},
"rewrite_word_info": {
"current_result_word": "",
"desc": "",
"new_result_word": "",
"rewrite_type": 0
}
}
},
"container": {
"template": [
{
"identityId": "cosmos_search_note_card-dsl-1.0.0",
"name": "cosmos_search_note_card",
"type": "dsl",
"url": "",
"version": "1.0.0"
},
{
"extra": {
"column": 1
},
"identityId": "cosmos_search_note_card-dsl-1.0.3",
"name": "cosmos_search_note_card",
"type": "dsl",
"url": "",
"version": "1.0.3"
},
{
"extra": {
"column": 1
},
"identityId": "cosmos_search_note_card-dsl-1.0.4",
"name": "cosmos_search_note_card",
"type": "dsl",
"url": "",
"version": "1.0.4"
},
"… 7 more items in the full response"
]
},
"hierarchy": {
"common": {
"layout": "slotY",
"load_more": true,
"pull_refresh": false,
"slot": 2
},
"structure": {
"root": [
"cosmos_search_goods_card_1",
"cosmos_search_goods_card_2",
"cosmos_search_goods_card_3",
"… 3 more items in the full response"
]
}
},
"module": {
"data": [
{
"card_name": "cosmos_search_goods_card",
"card_type": "dsl",
"content": {
"display_lines": 0,
"exp_flag_map": {
"Genuine_Brand_Product": "0",
"brand_tag": "0",
"fls_search_goods_card_opt": "0",
"help_farmers": "1"
},
"goods_type": "normal",
"has_buyer_explain": false,
"id": "68922dd24daa7100015f016f",
"image": [
{
"aspect_ratio": 1,
"height": 540,
"url": "https://mall-i10.xhscdn.com/arkgoods/1040g3no31kqealn42g0g49h3s5424eqkhf0rob8?imageView2/2/w/540/format/webp/q/85&ap=3&sc=GOOD_SEARCH",
"width": 540
}
],
"link": "xhsdiscover://goods_detail/68922dd24daa7100015f016f?listing_image=https%3A%2F%2Fmall-i10.xhscdn.com%2Farkgoods%2F1040g3no31kqealn42g0g49h3s5424eqkhf0rob8%3FimageView2%2F2%2Fw%2F1080%2Fformat%2Fwebp%2Fq%2F80%26ap%3D3%26sc%3DSTR_DTL&trade_ext=eyJjaGFubmVsSW5mbyI6eyJjaGFubmVsIjoiY29tbWVyY2lhbF9zZWFyY2giLCJleHRyYUluZm8iOiJ7fSJ9LCJkc1Rva2VuSW5mbyI6bnVsbCwibWFya2V0aW5nSW5mbyI6eyJtYXJrZXRpbmdDaGFubmVsIjowLCJlbnRyeUNoYW5uZWwiOiJjb21tZXJjaWFsX3NlYXJjaCIsImRhdGFFeHRlbmQiOm51bGx9LCJncm91cG9uSW5mbyI6bnVsbCwic2hhcmVMaW5rIjpudWxsLCJmaXJzdFVzZU9yZGVyQWRkcmVzc0lkIjpudWxsLCJvcmRlckluZm8iOm51bGwsInNwdUluZm8iOm5…",
"preload": "{\"type\":\"vision\",\"goods_detail_type\":null,\"original\":null,\"vision\":{\"ver\":\"1.0\",\"hierarchy\":{\"structure\":{\"primary_1\":[\"primary_content_1\"],\"primary_content_1\":[\"gd_price_view_oversea_1\",\"primary_title_view_1\"],\"root\":[\"header_carousel_1\",\"primary_1\"]},\"common\":{\"layout\":\"autoY\",\"load_more\":false,\"pull_refresh\":false}},\"module\":{\"data\":[{\"id\":\"header_carousel_1\",\"version\":\"1.0.0\",\"content\":{\"asset\":[{\"asset_type\":\"image\",\"asset_content\":{\"tab_name\":\"Images\",\"list\":[{\"type\":\"image\",\"image\":{\"url\":\"https://mall-i10.xhscdn.com/arkgoods/1040g3no31kqealn42g0g49h3s5424eqkhf0rob8?imageView2/2/w/1080/…",
"price_info": {
"foreign_price": "≈£3.94",
"origin_price": 42,
"price": 35.7
},
"stock_status": 1,
"tag_strategy_map": {
"after_shop_name": [
{
"tag_content": {
"content": "99+ new",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"99+ new\"}"
],
"tag_type": 1,
"type": "shop_new_arrival_cnt"
}
],
"before_price": [
{
"tag_content": {
"content": "Sale price",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"type": "1"
},
"tag_content_list": [
"{\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"type\":\"1\",\"content\":\"Sale price\"}"
],
"tag_type": 1,
"type": "xmp_sku_with_coupon"
}
],
"behavior": [
{
"tag_content": {
"content": "Shop offer 15% off for 1 item(s)",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"Shop offer 15% off for 1 item(s)\"}"
],
"tag_type": 1,
"type": "xmp_seller_quantity_discount"
}
]
},
"title": "Elon Musk Open AI Artificial Intelligence Geek Same Style T-Shirt Unisex Short Sleeve Pure Cotton Half Sleeve Shirt Top",
"vendor": {
"seller_id": "6855143c5c987e0015e16c30",
"vendor_id": "https://sns-avatar-qc.xhscdn.com/avatar/5923082250c4b4383b293b54.jpg?imageView2/2/w/120/format/jpg",
"vendor_link": "xhsdiscover://shop_detail?seller_id=6855143c5c987e0015e16c30&general_param=%7B%22source%22:%22search_result_goods_seller_name%22%7D&source=search_result_goods_seller_name",
"vendor_name": "柠乐小铺861的店",
"vendor_type": "INDIVIDUAL_BUSINESS"
}
},
"id": "cosmos_search_goods_card_1",
"version": "1.0.0"
},
{
"card_name": "cosmos_search_goods_card",
"card_type": "dsl",
"content": {
"display_lines": 0,
"exp_flag_map": {
"Genuine_Brand_Product": "0",
"brand_tag": "0",
"fls_search_goods_card_opt": "0",
"help_farmers": "1"
},
"goods_type": "normal",
"has_buyer_explain": false,
"id": "6a7c75c1fa5d5c0001e92536",
"image": [
{
"aspect_ratio": 0.75,
"height": 720,
"url": "https://mall-i10.xhscdn.com/arkgoods/1040g3ng322re4166n2ag5ouvi9v9urg6fma9cng?imageView2/1/w/540/h/720/format/webp/q/85&ap=3&sc=GOOD_SEARCH",
"width": 540
}
],
"link": "xhsdiscover://goods_detail/6a7c75c1fa5d5c0001e92536?listing_image=https%3A%2F%2Fmall-i10.xhscdn.com%2Farkgoods%2F1040g3ng322re4166n2ag5ouvi9v9urg6fma9cng%3FimageView2%2F2%2Fw%2F1080%2Fformat%2Fwebp%2Fq%2F80%26ap%3D3%26sc%3DSTR_DTL&trade_ext=eyJjaGFubmVsSW5mbyI6eyJjaGFubmVsIjoiY29tbWVyY2lhbF9zZWFyY2giLCJleHRyYUluZm8iOiJ7fSJ9LCJkc1Rva2VuSW5mbyI6bnVsbCwibWFya2V0aW5nSW5mbyI6eyJtYXJrZXRpbmdDaGFubmVsIjowLCJlbnRyeUNoYW5uZWwiOiJjb21tZXJjaWFsX3NlYXJjaCIsImRhdGFFeHRlbmQiOm51bGx9LCJncm91cG9uSW5mbyI6bnVsbCwic2hhcmVMaW5rIjpudWxsLCJmaXJzdFVzZU9yZGVyQWRkcmVzc0lkIjpudWxsLCJvcmRlckluZm8iOm51bGwsInNwdUluZm8iOm5…",
"preload": "{\"type\":\"vision\",\"goods_detail_type\":null,\"original\":null,\"vision\":{\"ver\":\"1.0\",\"hierarchy\":{\"structure\":{\"primary_1\":[\"primary_content_1\"],\"primary_content_1\":[\"gd_price_view_oversea_1\",\"primary_title_view_1\"],\"root\":[\"header_carousel_1\",\"primary_1\"]},\"common\":{\"layout\":\"autoY\",\"load_more\":false,\"pull_refresh\":false}},\"module\":{\"data\":[{\"id\":\"header_carousel_1\",\"version\":\"1.0.0\",\"content\":{\"asset\":[{\"asset_type\":\"video\",\"asset_content\":{\"tab_name\":\"Video\",\"list\":[{\"type\":\"video\",\"video\":{\"video_id\":\"138026490257995093\",\"url\":\"https://store.xiaohongshu.com/stream/42/38/258/01ea5e5c916bf5550101…",
"price_info": {
"foreign_price": "≈£4.39",
"origin_price": 44.7,
"price": 39.7
},
"stock_status": 1,
"tag_strategy_map": {
"after_price": [
{
"tag_content": {
"content": "56 sold"
},
"tag_content_list": [
"{\"content\":\"56 sold\"}"
],
"tag_type": 1,
"type": "sold"
}
],
"before_price": [
{
"tag_content": {
"content": "Sale price",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"type": "1"
},
"tag_content_list": [
"{\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"type\":\"1\",\"content\":\"Sale price\"}"
],
"tag_type": 1,
"type": "xmp_sku_with_coupon"
}
],
"behavior": [
{
"tag_content": {
"content": "New buyer ¥5 off",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"New buyer ¥5 off\"}"
],
"tag_type": 1,
"type": "xmp_seller_newuser_reduce_coupon"
},
{
"tag_content": {
"content": "100+ added to cart",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"100+ added to cart\"}"
],
"tag_type": 1,
"type": "add_cart_people_threshold"
},
{
"tag_content": {
"content": "No 3 in store repurchase",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"No 3 in store repurchase\"}"
],
"tag_type": 1,
"type": "repeat_shop_item_top_k"
},
"… 1 more items in the full response"
]
},
"title": "AI Chubby Cat | Programmer's Fun Stress-Relief Cat Keychain for Your Bag",
"vendor": {
"seller_id": "6a0d3ea3de38660015c3c434",
"vendor_id": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo320cob4tclc0g5ouvi9v9urg6rfle8ho?imageView2/2/w/120/format/jpg",
"vendor_link": "xhsdiscover://shop_detail?seller_id=6a0d3ea3de38660015c3c434&general_param=%7B%22source%22:%22search_result_goods_seller_name%22%7D&source=search_result_goods_seller_name",
"vendor_name": "造物Cube的店",
"vendor_type": "INDIVIDUAL_NEW"
}
},
"id": "cosmos_search_goods_card_2",
"version": "1.0.0"
},
{
"card_name": "cosmos_search_goods_card",
"card_type": "dsl",
"content": {
"display_lines": 0,
"exp_flag_map": {
"Genuine_Brand_Product": "0",
"brand_tag": "0",
"fls_search_goods_card_opt": "0",
"help_farmers": "1"
},
"goods_type": "normal",
"has_buyer_explain": false,
"id": "6a54e4e411bb870001fab19f",
"image": [
{
"aspect_ratio": 1,
"height": 540,
"url": "https://mall-i10.xhscdn.com/arkgoods/1040g3no322ij3evemu0g5p258gf51m2jngndcdo?imageView2/2/w/540/format/webp/q/85&ap=3&sc=GOOD_SEARCH",
"width": 540
}
],
"link": "xhsdiscover://goods_detail/6a54e4e411bb870001fab19f?listing_image=https%3A%2F%2Fmall-i10.xhscdn.com%2Farkgoods%2F1040g3no322ij3evemu0g5p258gf51m2jngndcdo%3FimageView2%2F2%2Fw%2F1080%2Fformat%2Fwebp%2Fq%2F80%26ap%3D3%26sc%3DSTR_DTL&trade_ext=eyJjaGFubmVsSW5mbyI6eyJjaGFubmVsIjoiY29tbWVyY2lhbF9zZWFyY2giLCJleHRyYUluZm8iOiJ7fSJ9LCJkc1Rva2VuSW5mbyI6bnVsbCwibWFya2V0aW5nSW5mbyI6eyJtYXJrZXRpbmdDaGFubmVsIjowLCJlbnRyeUNoYW5uZWwiOiJjb21tZXJjaWFsX3NlYXJjaCIsImRhdGFFeHRlbmQiOm51bGx9LCJncm91cG9uSW5mbyI6bnVsbCwic2hhcmVMaW5rIjpudWxsLCJmaXJzdFVzZU9yZGVyQWRkcmVzc0lkIjpudWxsLCJvcmRlckluZm8iOm51bGwsInNwdUluZm8iOm5…",
"preload": "{\"type\":\"vision\",\"goods_detail_type\":null,\"original\":null,\"vision\":{\"ver\":\"1.0\",\"hierarchy\":{\"structure\":{\"primary_1\":[\"primary_content_1\"],\"primary_content_1\":[\"gd_price_view_oversea_1\",\"primary_title_view_1\"],\"root\":[\"header_carousel_1\",\"primary_1\"]},\"common\":{\"layout\":\"autoY\",\"load_more\":false,\"pull_refresh\":false}},\"module\":{\"data\":[{\"id\":\"header_carousel_1\",\"version\":\"1.0.0\",\"content\":{\"asset\":[{\"asset_type\":\"image\",\"asset_content\":{\"tab_name\":\"Images\",\"list\":[{\"type\":\"image\",\"image\":{\"url\":\"https://mall-i10.xhscdn.com/arkgoods/1040g3no322ij3evemu0g5p258gf51m2jngndcdo?imageView2/2/w/1080/…",
"price_info": {
"foreign_price": "≈£4.86",
"origin_price": 49,
"price": 44
},
"stock_status": 1,
"tag_strategy_map": {
"after_shop_name": [
{
"tag_content": {
"content": "3 yrs shop",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"3 yrs shop\"}"
],
"tag_type": 1,
"type": "shop_age"
}
],
"before_price": [
{
"tag_content": {
"content": "Sale price",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"type": "1"
},
"tag_content_list": [
"{\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"type\":\"1\",\"content\":\"Sale price\"}"
],
"tag_type": 1,
"type": "xmp_sku_with_coupon"
}
],
"behavior": [
{
"tag_content": {
"content": "New buyer ¥5 off",
"fontColor": "#000000",
"fontColorDark": "#FFFFFF",
"fontColorDarkRgba": "rgba(255, 255, 255, 0.36)",
"fontColorRgba": "rgba(0, 0, 0, 0.45)",
"fontDarkTransparency": "0.36",
"fontSize": "12",
"fontTransparency": "0.45"
},
"tag_content_list": [
"{\"fontColorRgba\":\"rgba(0, 0, 0, 0.45)\",\"fontColorDarkRgba\":\"rgba(255, 255, 255, 0.36)\",\"fontColor\":\"#000000\",\"fontColorDark\":\"#FFFFFF\",\"fontTransparency\":\"0.45\",\"fontDarkTransparency\":\"0.36\",\"fontSize\":\"12\",\"content\":\"New buyer ¥5 off\"}"
],
"tag_type": 1,
"type": "xmp_seller_newuser_reduce_coupon"
}
]
},
"title": "Elon Musk Open AI AI Print Cotton Crew Neck T-Shirt Summer",
"vendor": {
"seller_id": "64461d78ebbcb200011e7ef5",
"vendor_id": "https://sns-avatar-qc.xhscdn.com/avatar/166ad12ae9a7f6fbb4bbbf88d417895f.jpg?imageView2/2/w/120/format/jpg",
"vendor_link": "xhsdiscover://shop_detail?seller_id=64461d78ebbcb200011e7ef5&general_param=%7B%22source%22:%22search_result_goods_seller_name%22%7D&source=search_result_goods_seller_name",
"vendor_name": "lemon_夲的店",
"vendor_type": "INDIVIDUAL_NEW"
}
},
"id": "cosmos_search_goods_card_3",
"version": "1.0.0"
},
"… 3 more items in the full response"
]
},
"ver": "1.0"
},
"debug_id": "b0aa4974",
"debug_info": "gAAAAABqhswzskREj1kjs1v8LFiX1SrSrHvrMDJRpqB0QKPX6L5OWwTceDfRqbySGRddZU24_1j9uX88WIenVJ4eRVJEuBYbHlaVpYPI1VXtE0uod0_1_druKctS4bedDR-Q9EGUClYICSSuikHV7HVmz2xDjT5t91HQYF_smnjMXIgX3egv722KfPDDeVg_03Rx336sJeYWC-CTr2f61xO2vxlcaD3Sbvuf0g8pcxEGNj50Ed9driSKD00_wPL323rK7Ziw-aYvtRfNQEcqgbIxD7tJuqMJM9FLVsvNDfJTJMWn0-2miQf_gkUHelEMnOGfG2gmyY0PO9l31GuuK-0MKySh5MUMr-srcqca5mucZ31Cf74R0Fu23UzsU1q3e_WzmwEX4M4r6eSmj8lBZpbSgEirUbj4C84qMIhYqXgORj2EBifeN8M=",
"msg": "成功",
"next_page": 2,
"page": 1,
"search_id": "4e54af57e5a846c2",
"success": true
}
}
]Explore more
| API | Price | Response |
|---|---|---|
Xiaohongshu (RED) Product SearchThis API Xiaohongshu | $0.01 per call | JSON |
Xiaohongshu | $0.01 per call | JSON |
Xiaohongshu | $0.01 per call | JSON |
Xiaohongshu | $0.01 per call | JSON |
Xiaohongshu | $0.01 per call | JSON |
Xiaohongshu | $0.01 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-products with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
Required: keyword (string). Optional: page (integer), search_id (string) and source (string). The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
No. Xiaohongshu (RED) Product Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Xiaohongshu API access separately.
For an identified cosmos_search_goods_card, preserve content.id as the goods identifier. A wrapper such as cosmos_search_goods_card_1 is a layout position, not a SKU. Unknown card types need separate inspection; do not select the first arbitrary object automatically.
Yes. A later request carries root-level search_id and returned next_page with the same keyword/source. search_id is a search session, not a product ID or credential. No second page or complete collection was executed in this revision.
No. Six is the saved sample count, with no count/limit input declared. Stock flags are not quantities, raw prices have unverified unit relationships and one returned page is not a market, sales or revenue measurement.