小红书商品搜索 API

curl -G "https://api.dataxapi.com/v1/xiaohongshu/shop/products/search" \
  --data-urlencode "query=防晒霜" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

{
  "code": "ok",
  "request_id": "1057f8a1-fd9b-4c22-8a64-0b39cef3c0ca",
  "data": {
    "items": [
      {
        "id": "607f46a700000000d2ac43b7",
        "title": "防晒霜装备清单，新手照着买就行",
        "price": "17.9",
        "original_price": null,
        "currency": "CNY",
        "images": [
          "https://sns-webpic-qc.xhscdn.com/20261015/d34e2e29ca04742dcce6!nd_dft_wlteh_webp_3"
        ],
        "metrics": { "sold": 4027 },
        "shop": { "id": "61f3eff20000000059f57a3b", "name": "木与光家居店" }
      },
      // … 另有 18 条
    ]
  },
  "page": {
    "next_cursor": "c1.U7GaOWwl4KEr-8bH3IgJ8L9E0bROr0O-MTl8yQHt",
    "cursor_expires_at": "2026-10-12T22:55:07.000Z",
    "has_more": true,
    "returned": 19
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.shop.products.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T21:55:07.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "url": "capability",
      "description": "capability",
      "rating": "capability",
      "metrics.reviews": "capability"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}

取自 2026-10-12 21:55 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。

返回大小：标准档 8.7 KB（精简 5.4 KB，完整 8.7 KB）。

{
  "code": "ok",
  "request_id": "997f3d31-91cb-4a34-8764-eceba6b97e15",
  "data": { "items": [] },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 0
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.shop.products.search",
    "result_status": "empty",
    "fetched_at": "2026-10-12T21:56:24.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "url": "capability",
      "description": "capability",
      "rating": "capability",
      "metrics.reviews": "capability"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}

取自 2026-10-12 21:56 UTC 录下的真实返回。请求号和余额是示意。

返回大小：标准档 513 B（精简 513 B，完整 513 B）。

curl -G "https://api.dataxapi.com/v1/xiaohongshu/shop/products/search" \
  --data-urlencode "query=防晒霜" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.xiaohongshu.shop.products.search(query="防晒霜")
print(result["data"]["items"])

import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.xiaohongshu.shop.products.search({ query: "防晒霜" });
console.log(result.data.items);

dataxapi call xiaohongshu.shop.products.search 'query=防晒霜'

{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

把这段加进你的 MCP 客户端，然后让你的 AI 调用 xiaohongshu.shop.products.search。