Xiaohongshu E-commerce (RedNote) Product Search API (V1)

Search for Xiaohongshu E-commerce (RedNote) products by keyword with page and search-ID pagination. pages after the first require the search ID returned by the initial search. Supply a keyword and optionally set a page number. Use it for catalog research or marketplace monitoring. The GET request schema also lists searchId. Use the results to organize a research workflow and cross-check the relevant source records.

Selected price
$0.030769 / callPublished pricing
Providers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
Search keyword.
Page number, starting from 1.
Search ID returned by the first-page response; required when page is greater than 1.

Sample response

"code": 0
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": [
    {
      "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 [1]
[0] {}
"card_name": "cosmos_search_goods_card"
"card_type": "dsl"
content {}
"display_lines": 0
"exp_flag_map": {
  "Genuine_Brand_Product": "0",
  "brand_tag": "1",
  "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": "6a0410185a83230001c2e48d"
"image": [
  {
    "aspect_ratio": 1,
    "height": 540,
    "url": "https://mall-i10.xhscdn.com/arkgoods/1040g0o03203ln7ock8105o1lr5a086somrc9tog?imageView2/2/w/540/format/webp/q/85&ap=3&sc=GOOD_SEARCH",
    "width": 540
  }
]
"link": "xhsdiscover://goods_detail/6a0410185a83230001c2e48d?listing_image=https%3A%2F%2Fmall-i10.xhscdn.com%2Farkgoods%2F1040g0o03203ln7ock8105o1lr5a086somrc9tog%3FimageView2%2F2%2Fw%2F1080%2Fformat%2Fwebp%2Fq%2F80%26ap%3D3%26sc%3DSTR_DTL&trade_ext=eyJjaGFubmVsSW5mbyI6eyJjaGFubmVsIjoiY29tbWVyY2lhbF9zZWFyY2giLCJleHRyYUluZm8iOiJ7fSJ9LCJkc1Rva2VuSW5mbyI6bnVsbCwibWFya2V0aW5nSW5mbyI6eyJtYXJrZXRpbmdDaGFubmVsIjowLCJlbnRyeUNoYW5uZWwiOiJjb21tZXJjaWFsX3NlYXJjaCIsImRhdGFFeHRlbmQiOm51bGx9LCJncm91cG9uSW5mbyI6bnVsbCwic2hhcmVMaW5rIjpudWxsLCJmaXJzdFVzZU9yZGVyQWRkcmVzc0lkIjpudWxsLCJvcmRlckluZm8iOm51bGwsInNwdUluZm8iOm51bGwsInNrdURldGFpbExpbmtMaXN0IjpudWxsLCJsaXZlSW5mbyI6bnVsbCwic2hvcEluZm8iOm51bGwsImdvb2RzTm90ZUluZm8iOm51bGwsImNoYXRJbmZvIjpudWxsLCJzZWFyY2hJbmZvIjpudWxsLCJjdXN0b21TZXJ2aWNlSW5mbyI6bnVsbH0=&img_width=1135&rate_limit_meta=itemId%3D6809d371914017000100b686&img_height=1135&pre_page=mall_search&xhs_g_s=0001&source=mall_search&naviHidden=yes&searchId=6281af71eb7a4aae"
preloadJSON string · parsed preview
data.data.module.data[0].content.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/1040g0o03203ln7ock8105o1lr5a086somrc9tog?imageView2/2/w/1080/format/webp/q/80&ap=3&sc=STR_DTL",
                        "thumbnail": "https://mall-i10.xhscdn.com/arkgoods/1040g0o03203ln7ock8105o1lr5a086somrc9tog?imageView2/2/w/360/format/webp/q/85&ap=3&sc=STR_THUMB",
                        "width": 1135,
                        "height": 1135,
                        "image_search_route": "xhsdiscover://search/imagesearch?source=goods_detail&file_id=arkgoods/1040g0o03203ln7ock8105o1lr5a086somrc9tog&goods_id=6a0410185a83230001c2e48d&goods_url=https://mall-i10.xhscdn.com/arkgoods/1040g0o03203ln7ock8105o1lr5a086somrc9tog?imageView2/2/w/1080/format/webp/q/80&ap=3&sc=STR_DTL&item_id=6809d371914017000100b686",
                        "goods_search_route": "xhsdiscover://search/result?mode=goods_image&source=goods_detail&keyword=%E3%80%90%E8%AF%95%E7%94%A8%E4%B8%93%E4%BA%AB%E3%80%91%E5%B0%8F%E9%BB%84%E5%B8%BD%E9%98%B2%E6%99%9210ml%E6%B3%B0%E7%89%88%E9%98%B2%E6%99%92%E9%9C%9C%E4%B9%B3%E9%9D%A2%E9%83%A8%E5%AD%A6%E7%94%9F%E9%98%B2%E6%99%92%E5%AE%98%E6%96%B9&target_search=goods&trade_extra_info=%7B%22file_id%22%3A%22arkgoods%2F1040g0o03203ln7ock8105o1lr5a086somrc9tog%22%2C%22goods_id%22%3A%226a0410185a83230001c2e48d%22%7D"
                      },
                      "container": {
                        "ratio": 1.0
                      }
                    },
                    {
                      "type": "image",
                      "image": {
                        "url": "https://mall-i10.xhscdn.com/arkgoods/1040g0o031u38jroohk005o1lr5a086so7e9ls20?imageView2/2/w/1080/format/webp/q/80&ap=3&sc=STR_DTL",
                        "thumbnail": "https://mall-i10.xhscdn.com/arkgoods/1040g0o031u38jroohk005o1lr5a086so7e9ls20?imageView2/2/w/360/format/webp/q/85&ap=3&sc=STR_THUMB",
                        "width": 800,
                        "height": 800,
                        "image_search_route": "xhsdiscover://search/imagesearch?source=goods_detail&file_id=arkgoods/1040g0o031u38jroohk005o1lr5a086so7e9ls20&goods_id=6a0410185a83230001c2e48d&goods_url=https://mall-i10.xhscdn.com/arkgoods/1040g0o031u38jroohk005o1lr5a086so7e9ls20?imageView2/2/w/1080/format/webp/q/80&ap=3&sc=STR_DTL&item_id=6809d371914017000100b686",
                        "goods_search_route": "xhsdiscover://search/result?mode=goods_image&source=goods_detail&keyword=%E3%80%90%E8%AF%95%E7%94%A8%E4%B8%93%E4%BA%AB%E3%80%91%E5%B0%8F%E9%BB%84%E5%B8%BD%E9%98%B2%E6%99%9210ml%E6%B3%B0%E7%89%88%E9%98%B2%E6%99%92%E9%9C%9C%E4%B9%B3%E9%9D%A2%E9%83%A8%E5%AD%A6%E7%94%9F%E9%98%B2%E6%99%92%E5%AE%98%E6%96%B9&target_search=goods&trade_extra_info=%7B%22file_id%22%3A%22arkgoods%2F1040g0o031u38jroohk005o1lr5a086so7e9ls20%22%2C%22goods_id%22%3A%226a0410185a83230001c2e48d%22%7D"
                      },
                      "container": {
                        "ratio": 1.0
                      }
                    },
                    {
                      "type": "image",
                      "image": {
                        "url": "https://mall-i10.xhscdn.com/arkgoods/1040g0o031u38jreggo005o1lr5a086so0jc4teo?imageView2/2/w/1080/format/webp/q/80&ap=3&sc=STR_DTL",
                        "thumbnail": "https://mall-i10.xhscdn.com/arkgoods/1040g0o031u38jreggo005o1lr5a086so0jc4teo?imageView2/2/w/360/format/webp/q/85&ap=3&sc=STR_THUMB",
                        "width": 800,
                        "height": 800,
                        "image_search_route": "xhsdiscover://search/imagesearch?source=goods_detail&file_id=arkgoods/1040g0o031u38jreggo005o1lr5a086so0jc4teo&goods_id=6a0410185a83230001c2e48d&goods_url=https://mall-i10.xhscdn.com/arkgoods/1040g0o031u38jreggo005o1lr5a086so0jc4teo?imageView2/2/w/1080/format/webp/q/80&ap=3&sc=STR_DTL&item_id=6809d371914017000100b686",
                        "goods_search_route": "xhsdiscover://search/result?mode=goods_image&source=goods_detail&keyword=%E3%80%90%E8%AF%95%E7%94%A8%E4%B8%93%E4%BA%AB%E3%80%91%E5%B0%8F%E9%BB%84%E5%B8%BD%E9%98%B2%E6%99%9210ml%E6%B3%B0%E7%89%88%E9%98%B2%E6%99%92%E9%9C%9C%E4%B9%B3%E9%9D%A2%E9%83%A8%E5%AD%A6%E7%94%9F%E9%98%B2%E6%99%92%E5%AE%98%E6%96%B9&target_search=goods&trade_extra_info=%7B%22file_id%22%3A%22arkgoods%2F1040g0o031u38jreggo005o1lr5a086so0jc4teo%22%2C%22goods_id%22%3A%226a0410185a83230001c2e48d%22%7D"
                      },
                      "container": {
                        "ratio": 1.0
                      }
                    },
                    {
                      "type": "image",
                      "image": {
                        "url": "https://mall-i10.xhscdn.com/arkgoods/1040g3no31u38jrfo1k005o1lr5a086son5daq8o?imageView2/2/w/1080/format/webp/q/80&ap=3&sc=STR_DTL",
                        "thumbnail": "https://mall-i10.xhscdn.com/arkgoods/1040g3no31u38jrfo1k005o1lr5a086son5daq8o?imageView2/2/w/360/format/webp/q/85&ap=3&sc=STR_THUMB",
                        "width": 800,
                        "height": 800,
                        "image_search_route": "xhsdiscover://search/imagesearch?source=goods_detail&file_id=arkgoods/1040g3no31u38jrfo1k005o1lr5a086son5daq8o&goods_id=6a0410185a83230001c2e48d&goods_url=https://mall-i10.xhscdn.com/arkgoods/1040g3no31u38jrfo1k005o1lr5a086son5daq8o?imageView2/2/w/1080/format/webp/q/80&ap=3&sc=STR_DTL&item_id=6809d371914017000100b686",
                        "goods_search_route": "xhsdiscover://search/result?mode=goods_image&source=goods_detail&keyword=%E3%80%90%E8%AF%95%E7%94%A8%E4%B8%93%E4%BA%AB%E3%80%91%E5%B0%8F%E9%BB%84%E5%B8%BD%E9%98%B2%E6%99%9210ml%E6%B3%B0%E7%89%88%E9%98%B2%E6%99%92%E9%9C%9C%E4%B9%B3%E9%9D%A2%E9%83%A8%E5%AD%A6%E7%94%9F%E9%98%B2%E6%99%92%E5%AE%98%E6%96%B9&target_search=goods&trade_extra_info=%7B%22file_id%22%3A%22arkgoods%2F1040g3no31u38jrfo1k005o1lr5a086son5daq8o%22%2C%22goods_id%22%3A%226a0410185a83230001c2e48d%22%7D"
                      },
                      "container": {
                        "ratio": 1.0
                      }
                    },
                    {
                      "type": "image",
                      "image": {
                        "url": "https://mall-i10.xhscdn.com/arkgoods/1040g3no31u38jrf71o0g5o1lr5a086so530h8mo?imageView2/2/w/1080/format/webp/q/80&ap=3&sc=STR_DTL",
                        "thumbnail": "https://mall-i10.xhscdn.com/arkgoods/1040g3no31u38jrf71o0g5o1lr5a086so530h8mo?imageView2/2/w/360/format/webp/q/85&ap=3&sc=STR_THUMB",
                        "width": 800,
                        "height": 800,
                        "image_search_route": "xhsdiscover://search/imagesearch?source=goods_detail&file_id=arkgoods/1040g3no31u38jrf71o0g5o1lr5a086so530h8mo&goods_id=6a0410185a83230001c2e48d&goods_url=https://mall-i10.xhscdn.com/arkgoods/1040g3no31u38jrf71o0g5o1lr5a086so530h8mo?imageView2/2/w/1080/format/webp/q/80&ap=3&sc=STR_DTL&item_id=6809d371914017000100b686",
                        "goods_search_route": "xhsdiscover://search/result?mode=goods_image&source=goods_detail&keyword=%E3%80%90%E8%AF%95%E7%94%A8%E4%B8%93%E4%BA%AB%E3%80%91%E5%B0%8F%E9%BB%84%E5%B8%BD%E9%98%B2%E6%99%9210ml%E6%B3%B0%E7%89%88%E9%98%B2%E6%99%92%E9%9C%9C%E4%B9%B3%E9%9D%A2%E9%83%A8%E5%AD%A6%E7%94%9F%E9%98%B2%E6%99%92%E5%AE%98%E6%96%B9&target_search=goods&trade_extra_info=%7B%22file_id%22%3A%22arkgoods%2F1040g3no31u38jrf71o0g5o1lr5a086so530h8mo%22%2C%22goods_id%22%3A%226a0410185a83230001c2e48d%22%7D"
                      },
                      "container": {
                        "ratio": 1.0
                      }
                    }
                  ]
                }
              }
            ],
            "header_ext": {}
          },
          "card_name": "header_carousel",
          "card_type": "native",
          "card_attributes": {
            "padding": {
              "top": 12.0,
              "bottom": 12.0
            }
          }
        },
        {
          "id": "primary_1",
          "version": "1.0.0",
          "cards": [
            {
              "id": "primary_content_1",
              "version": "1.0.0",
              "cards": [
                {
                  "id": "gd_price_view_oversea_1",
                  "version": "1.0.0",
                  "content": {
                    "price": 39.9,
                    "price_integer_part": "39",
                    "price_decimal_part": ".9",
                    "attr": {
                      "bg_color": "#00000000",
                      "bg_dark_color": "#00000000",
                      "padding": {
                        "left": 16,
                        "right": 16
                      }
                    },
                    "en_version": true,
                    "card_type": "default",
                    "experiment_flags": []
                  },
                  "card_name": "gd_price_view_oversea",
                  "card_type": "dsl",
                  "card_attributes": {
                    "bg_color": "#FFFFFF"
                  }
                },
                {
                  "id": "primary_title_view_1",
                  "version": "1.0.0",
                  "content": {
                    "content_light": true,
                    "name": "蜜丝婷MISTINE · 【试用专享】小黄帽防晒10ml泰版防晒霜乳面部学生防晒官方",
                    "sku_id": "6a0410185a83230001c2e48d",
                    "tags": [],
                    "is_followed": false,
                    "has_followed": false,
                    "attr": {
                      "bg_color": "#00000000",
                      "bg_dark_color": "#00000000"
                    },
                    "accessibility": {
                      "label": "商品名称",
                      "traits": "staticText",
                      "value": "蜜丝婷MISTINE · 【试用专享】小黄帽防晒10ml泰版防晒霜乳面部学生防晒官方",
                      "is_accessibility_element": true,
                      "elements_hidden": false
                    }
                  },
                  "card_name": "primary_title_view",
                  "card_type": "native",
                  "card_attributes": {
                    "bg_color": "#FFFFFF"
                  }
                }
              ],
              "card_name": "primary_content",
              "card_type": "stack",
              "card_attributes": {
                "padding": {
                  "top": 12.0,
                  "bottom": 12.0
                },
                "margin": {
                  "top": 0.0,
                  "bottom": 0.0,
                  "left": 0.0,
                  "right": 0.0
                },
                "corner_radius": {
                  "top_left": 0.0,
                  "top_right": 0.0,
                  "bottom_left": 0.0,
                  "bottom_right": 0.0
                },
                "bg_color": "#FFFFFF"
              }
            }
          ],
          "card_name": "primary",
          "card_type": "stack",
          "card_attributes": {
            "bg_color": "#00000000"
          }
        }
      ]
    },
    "container": {
      "template": [
        {
          "name": "gd_price_view_oversea",
          "type": "dsl",
          "version": "1.0.0",
          "url": "https://www.xiaohongshu.com",
          "extra": {
            "column": 2
          },
          "identityId": "gd_price_view_oversea-dsl-1.0.0"
        }
      ]
    },
    "biz_info": {
      "common": {
        "bottom_bar": {
          "sku_id": "6a0410185a83230001c2e48d",
          "deal_in_price_template_id": [],
          "func_buttons": [
            {
              "type": "seller",
              "name": "Shop"
            },
            {
              "type": "service",
              "name": "Service"
            },
            {
              "type": "cart",
              "name": "Cart"
            }
          ],
          "shop_buttons": [
            {
              "button_text": "",
              "action_type": "addCart",
              "type": "addCart",
              "style_type": "RedA6"
            }
          ],
          "coupon_infos": []
        },
        "common": {
          "sku_id": "6a0410185a83230001c2e48d",
          "seller_id": "5aea84bd692a5924ba351aad",
          "origin_price": 3990,
          "is_boutique": false,
          "fancy_ui": "2",
          "image_search_flag": "1",
          "auto_refresh": false,
          "rec_component": {
            "new_rec_api": true
          },
          "goods_detail_big_video": "big",
          "goods_type": "防晒霜",
          "prefetch_image": [
            "https://mall-i10.xhscdn.com/arkgoods/1040g0o03203ln7ock8105o1lr5a086somrc9tog?imageView2/2/w/360/format/webp/q/85&ap=3&sc=STR_THUMB"
          ],
          "app_language": "en",
          "current_content_language": "en",
          "cache_timestamp_ms": 1793970937824
        }
      }
    }
  }
}
"price_info": {
  "foreign_price": "≈£1.12",
  "origin_price": 39.9,
  "price": 9.9,
  "rds_price": 1.12,
  "symbol": "£"
}
"stock_status": 1
"tag_strategy_map": {
  "after_price": [
    {
      "style": "blank",
      "tag_content": {
        "content": "5498 sold"
      },
      "tag_content_list": [
        "{\"content\":\"5498 sold\"}"
      ],
      "tag_ext_info": {
        "sold": "5498"
      },
      "tag_type": 1,
      "type": "sold"
    }
  ],
  "after_shop_name": [
    {
      "style": "recommend_reason_gray",
      "tag_content": {
        "content": "8 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\":\"8 yrs shop\"}"
      ],
      "tag_type": 1,
      "type": "shop_age"
    }
  ],
  "before_price": [
    {
      "style": "promo_black",
      "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"
    }
  ],
  "before_title": [
    {
      "style": "brand_flagship_style",
      "tag_ext_info": {
        "detailStyleType": "1",
        "detailTagType": "1"
      },
      "tag_image": {
        "aspect_ratio": 0,
        "dark_url": "https://fe-platform.xhscdn.com/platform/104101l032114oqg37k06ichtr8jp60000000004f12mog",
        "height": 14,
        "url": "https://fe-platform.xhscdn.com/platform/104101l032114oqg37k06ichtr8jp60000000004f12mog",
        "width": 44
      },
      "tag_type": 2,
      "type": "brand_flagship"
    }
  ],
  "behavior": [
    {
      "style": "recommend_reason_gray",
      "tag_content": {
        "content": "Flash sale ¥30 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\":\"Flash sale ¥30 off\"}"
      ],
      "tag_ext_info": {
        "discount_amount": "3000",
        "in_deal_price": "true",
        "profit_type": "PROMOTION",
        "promotion_id": "6a0410a56f6b250015bedb5b",
        "promotion_type": "TIME_LIMIT_SPECIAL_PRICE"
      },
      "tag_type": 1,
      "type": "xmp_single_price"
    }
  ],
  "upon_title": [
    {
      "style": "search_gold",
      "tag_content": {
        "content": "“小小一个,挺可爱的”",
        "fontColor": "#9F6A37",
        "fontColorDark": "#BFA177",
        "fontColorDarkRgba": "rgba(191, 161, 119, 1)",
        "fontColorRgba": "rgba(159, 106, 55, 1)",
        "fontDarkTransparency": 1,
        "fontSize": 12,
        "fontTransparency": 1
      },
      "tag_content_list": [
        "{\"fontColorRgba\":\"rgba(159, 106, 55, 1)\",\"fontColorDarkRgba\":\"rgba(191, 161, 119, 1)\",\"fontColor\":\"#9F6A37\",\"fontColorDark\":\"#BFA177\",\"fontTransparency\":1.0,\"fontSize\":12.0,\"fontDarkTransparency\":1.0,\"content\":\"“小小一个,挺可爱的”\"}"
      ],
      "tag_type": 1,
      "type": "positive_review"
    }
  ]
}
"title": "蜜丝婷MISTINE·【试用专享】小黄帽防晒10ml泰版防晒霜乳面部学生防晒官方"
"vendor": {
  "seller_id": "5aea84bd692a5924ba351aad",
  "vendor_id": "https://sns-avatar-qc.xhscdn.com/avatar/63dc7ed3ad29e300019a87b2.jpg?imageView2/2/w/120/format/jpg",
  "vendor_link": "xhsdiscover://shop_detail?seller_id=5aea84bd692a5924ba351aad&general_param=%7B%22source%22:%22search_result_goods_seller_name%22%7D&source=search_result_goods_seller_name",
  "vendor_name": "Mistine海外旗舰店",
  "vendor_type": "FLAGSHIP_SHOP"
}
"id": "cosmos_search_goods_card_1"
"version": "1.0.0"
"ver": "1.0"
"debug_id": "ef695a7b"
"debug_info": "gAAAAABq7dL6cdquEg5d0Eh_mPvbdGwO4mQjZt2A2dvnKMezSvpL7v70uUZ3yUbgfyGRuix-KwgK2-ZPjdLJEBAHZm5HisakBe0fKWpf8CkgIxK0fakb728DUcn0QAlBleZD4wLi9VDyTniIATbH1_cf9KR47hklFhwk11hfDCZrRQNbu4O6QIIjRf3oKdLzgXbq4iX8GyWfT8UTQ8YEWb8WUP6-MRuEFORmQGZ75x4B6hyNf6frjyZuFKF-CUkB84c2XkUxhc8v9rlcU8UFLT1-oZDlrfZhVvvABqwIseI2avCsGdEHKsWejt3iAE1geHQHK7rMOksQu_ENongD5n-rRQ9v-Lhy2Cyys6FQZYe8LVT2AWcPAYSAS_t8aFftU34TOhDf1BaPtAXapCeZvfLJyIYfOjbeg1nJoe1tB_koTzuwuayu-rg="
"msg": "成功"
"next_page": 2
"page": 1
"search_id": "6281af71eb7a4aae"
"success": true
"message": null
"openany_cost": 30769
"recordTime": "2026-11-06T21:15:39.19866098"
"requestId": "4d1eb5facfde4c858d5cae8cfd26a90f"
"requestParams": {
  "body": null,
  "query": {
    "keyword": "防晒霜"
  }
}

Response result

Response structure

Inferred from examples
  • codeinteger
  • dataobject
    • codeinteger
    • dataobject
      • biz_infoobject
        • commonobject
          • recommend_infoobject
            • extend_taginteger
            • recommend_itemsunknown[]
            • recommend_typeinteger
          • rewrite_word_infoobject
            • current_result_wordstring
            • descstring
            • new_result_wordstring
            • rewrite_typeinteger
      • containerobject
        • templateobject[]
          • extraobject
            • columninteger
          • identityIdstring
          • namestring
          • typestring
          • urlstring
          • versionstring
      • hierarchyobject
        • commonobject
          • layoutstring
          • load_moreboolean
          • pull_refreshboolean
          • slotinteger
        • structureobject
          • rootstring[]
      • moduleobject
        • dataobject[]
          • card_namestring
          • card_typestring
          • contentobject
            • display_linesinteger
            • exp_flag_mapobject
              • Genuine_Brand_Productstring
              • brand_tagstring
              • flagstring
              • help_farmersstring
              • help_farmers_price_prefixstring
              • more_search_tagstring
              • search_add_recommend_tagstring
              • search_green_tagstring
            • goods_typestring
            • has_buyer_explainboolean
            • idstring
            • imageobject[]
              • aspect_ratiointeger
              • heightinteger
              • urlstring
              • widthinteger
            • linkstring
            • preloadstring
            • price_infoobject
              • foreign_pricestring
              • origin_pricenumber
              • pricenumber
              • rds_pricenumber
              • symbolstring
            • stock_statusinteger
            • tag_strategy_mapobject
              • after_priceobject[]
                • stylestring
                • tag_contentobject
                  • contentstring
                • tag_content_liststring[]
                • tag_ext_infoobject
                  • soldstring
                • tag_typeinteger
                • typestring
              • after_shop_nameobject[]
                • stylestring
                • tag_contentobject
                  • contentstring
                  • fontColorstring
                  • fontColorDarkstring
                  • fontColorDarkRgbastring
                  • fontColorRgbastring
                  • fontDarkTransparencystring
                  • fontSizestring
                  • fontTransparencystring
                • tag_content_liststring[]
                • tag_typeinteger
                • typestring
              • before_priceobject[]
                • stylestring
                • tag_contentobject
                  • contentstring
                  • fontColorstring
                  • fontColorDarkstring
                  • typestring
                • tag_content_liststring[]
                • tag_typeinteger
                • typestring
              • before_titleobject[]
                • stylestring
                • tag_ext_infoobject
                  • detailStyleTypestring
                  • detailTagTypestring
                • tag_imageobject
                  • aspect_ratiointeger
                  • dark_urlstring
                  • heightinteger
                  • urlstring
                  • widthinteger
                • tag_typeinteger
                • typestring
              • behaviorobject[]
                • stylestring
                • tag_contentobject
                  • contentstring
                  • fontColorstring
                  • fontColorDarkstring
                  • fontColorDarkRgbastring
                  • fontColorRgbastring
                  • fontDarkTransparencystring
                  • fontSizestring
                  • fontTransparencystring
                • tag_content_liststring[]
                • tag_ext_infoobject
                  • discount_amountstring
                  • in_deal_pricestring
                  • profit_typestring
                  • promotion_idstring
                  • promotion_typestring
                • tag_typeinteger
                • typestring
              • upon_titleobject[]
                • stylestring
                • tag_contentobject
                  • contentstring
                  • fontColorstring
                  • fontColorDarkstring
                  • fontColorDarkRgbastring
                  • fontColorRgbastring
                  • fontDarkTransparencyinteger
                  • fontSizeinteger
                  • fontTransparencyinteger
                • tag_content_liststring[]
                • tag_typeinteger
                • typestring
            • titlestring
            • vendorobject
              • seller_idstring
              • vendor_idstring
              • vendor_linkstring
              • vendor_namestring
              • vendor_typestring
          • idstring
          • versionstring
      • verstring
    • debug_idstring
    • debug_infostring
    • msgstring
    • next_pageinteger
    • pageinteger
    • search_idstring
    • successboolean
  • messagenull
  • openany_costinteger
  • recordTimestring
  • requestIdstring
  • requestParamsobject
    • bodynull
    • queryobject
      • keywordstring

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use Xiaohongshu E-commerce (RedNote) Product Search API (V1) with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.