Xiaohongshu (RED) Product Search

API docs
https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-products

Returns Xiaohongshu product search results based on a target keyword. Includes product card details, goods identifiers, stock status, and item titles across paginated listings.

Price
$0.01USD / call
Method
POST
Response
JSON
Parameters
1 required · 3 optional

Playground

Input
Search keyword
Page number, start from 1
Search ID, pass value from first search response for pagination
Source, default "explore_feed"
OutputExample
Responseoutputs · 21.6 KB · 404 lines
[
  {
    "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",

Examples

Select an example to load its inputs and result into the playground.

API README

Xiaohongshu (RED) Product Search API

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.

Use cases

  • Collect product IDs that match a brand or topic keyword, such as OpenAI, for market research.
  • Build a product image list for a keyword from the card image URLs.
  • Inspect one returned goods-card page; completeness and a new continuation have not been verified.
  • Preserve selected goods IDs for a separately chosen detail task; no complete listing or search-to-detail chain is established here.

Request

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.

Parameters

NameTypeRequiredDescription
keywordstringYesSearch keyword
pageintegerNoPage number, start from 1
search_idstringNoSearch ID, pass value from first search response for pagination
sourcestringNoSource, default "explore_feed"

Example response

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
}

Response fields

FieldMeaning
data.module.data[].content.idGoods ID of the product in this card. Use it to look up the product in other APIs.
data.module.data[].content.goods_typeType of the goods listing, for example normal.
data.module.data[].content.image[].urlProduct image URL. Sibling fields width, height and aspect_ratio give the image size.
data.module.data[].content.linkIn-app deeplink to the goods detail page, in the xhsdiscover://goods_detail/<id> format.
data.module.data[].content.has_buyer_explainBoolean flag for whether the card has a buyer explanation.
data.module.data[].content.exp_flag_mapMap of string flags attached to the card, such as brand_tag and help_farmers. Values are "0" or "1".
data.module.data[].idCard position ID in the result list, for example cosmos_search_goods_card_1.
data.hierarchy.common.load_moreShows whether more results can be loaded.
next_page / pageThe next page number and the current page number.
search_idID of this search. Pass it back to get later pages.

Notes

  • Pagination: take search_id from the first response and send it with page set to the next_page value.
  • page starts at 1.
  • The goods ID is the segment after goods_detail/ in content.link. It matches content.id.
  • A selected Product Detail request is a separate task and charge. The independently saved examples do not demonstrate a current search-to-detail chain.

Pricing

$0.01 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Inspect one keyword's product cards

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.

Give your agent one product-read task

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.

Explore more

Related APIs

All APIs
APIPriceResponse
Xiaohongshu$0.01 per callJSON
Xiaohongshu$0.01 per callJSON
Xiaohongshu$0.01 per callJSON
Xiaohongshu$0.01 per callJSON
Xiaohongshu$0.01 per callJSON
Xiaohongshu$0.01 per callJSON

Questions

FAQ

How do I use the Xiaohongshu (RED) Product Search API?

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.

How much does the Xiaohongshu (RED) Product Search API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the Xiaohongshu (RED) Product Search API accept?

Required: keyword (string). Optional: page (integer), search_id (string) and source (string). The Parameters table and the Playground on this page list every field.

What does the Xiaohongshu (RED) Product Search API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Xiaohongshu developer account or API key?

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.

Which value is the goods ID and which is the layout-card ID?

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.

Does pagination reuse a returned search value?

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.

Do six cards or a stock flag establish a complete market and inventory?

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.