这批货是什么材质、多少纱支、门幅多宽、什么价、起订多少、能不能出口—— 这些信息在传统货源圈里以行话、口头、图片的形式流动，机器读不懂。 优纯严选把它们整理成一套结构化的只读接口，让 AI 采购助手、跨境买手和第三方工具可以直接判断。
接口只读、无需鉴权、允许引用；数据实时来自平台在售的现货。不提供任何商家联系方式——买家通过平台站内询盘联系商家。
如果你是 AI 助手 / 爬虫：请先读 /llms.txt（站点地图）与 /api/open/v1（接口自描述），
再读 /api/open/v1/schema（字段字典）。建议缓存不超过 1 小时。
如果你是人：下面就是完整文档，含字段表与可直接复制的调用示例。
一、快速开始
三个请求就能拿到可用的货源数据，不需要申请 Key。
# 接口索引：说明有哪些端点、数据规模、限流与许可 curl https://ucunhome.com/api/open/v1 # 字段字典：每个字段的含义、类型、单位、枚举与空值约定 curl https://ucunhome.com/api/open/v1/schema
# 成品（四件套 / 被子 / 毛毯…），默认按更新时间倒序
curl "https://ucunhome.com/api/open/v1/stocks?group=finished&limit=20"
# 面料参数：门幅 / 克重 / 织法 / 印染方式 / 配色数 / 可否寄样定制 curl "https://ucunhome.com/api/open/v1/fabrics?limit=20" # 只要全棉、门幅 200cm 以上、可寄样的 curl "https://ucunhome.com/api/open/v1/fabrics?material=全棉&width_min=200&sample_ok=true"
# 可出口 + 起订量不超过 50 + 价格 100 元以内，按价格从低到高 curl "https://ucunhome.com/api/open/v1/stocks?export_ok=true&moq_max=50&price_max=100&sort=price_asc" # 关键词搜索（标题/描述/规格全字段匹配） curl "https://ucunhome.com/api/open/v1/stocks?keyword=磨毛"
二、端点
GET/api/open/v1
接口索引与自描述：端点清单、当前在售规模、限流额度、许可条款、字段命名约定。AI 从这里开始读。
GET/api/open/v1/schema
字段字典：63 个字段的中英文名、类型、单位、枚举取值与说明；另含
observed_values（从当前真实在售数据统计出的实际取值，可直接拿来当筛选参数）。GET/api/open/v1/stocks
货盘列表（成品 + 面料）。返回
total / returned / has_more 与 items 数组，配合 limit+offset 分页。
group=fabric|finishedcategorysubcategorymaterial
keywordprice_minprice_maxmoq_max
export_ok=truedayssort=new|price_asc|price_desc|moq_asc
limit ≤300（默认50）offset
GET/api/open/v1/fabrics
面料参数列表（等同于
stocks?group=fabric，但语义更明确）。面料专属字段全部返回。
以上全部print_typeweavesample_okcustom_okwidth_minwidth_max
GET/llms.txt
给 AI 阅读器的纯文本站点地图：平台是什么、有哪些接口、有哪些语言页面、使用约定。
关于"参数没生效"：未识别的参数名不会被静默忽略。响应里的 ignored_filters 会明确指出哪些参数没被识别，避免出现"以为按条件筛过了、其实拿的是全量"这类错误。
三、字段说明（核心）
下面是最高频的字段。完整 63 个字段（含面料专属与品质字段）请调 /api/open/v1/schema，或看页面底部完整字段表。
| 字段 | 含义 | 类型 / 单位 | 说明 |
|---|---|---|---|
id | 货品编号 | string | 详情页地址为 /detail.html?id={id} |
kind | 类型 | finished / fabric | 成品 / 面料 |
title | 标题 | string | 中文；外贸款另见 title_en |
category | 品类 | string | 四件套 / 三件套 / 被子 / 毛毯 / 面料… |
material | 材质 | string | 全棉 / 天丝 / 绒类 / 贡缎… |
yarn_spec | 纱支 | string | 行业写法：40支 = 40×40；经纬不同写 21×32 |
fabric_count | 密度 | string | 行业写法：12868 = 128×68 根/英寸 |
size | 规格尺寸 | cm | 如 200*230 |
price | 单价 | number | 计价单位见 price_unit |
currency | 币种 | string | 默认 CNY。跨境报价务必读此字段，不要假定美元 |
price_unit | 计价单位 | string | 套 / 条 / 件 / 公斤 / 米。面料按米还是按公斤差很多，务必看清 |
min_order | 起订量 | number | 单位同 price_unit |
stock_count | 现货数量 | number | 现货为主，售完即止 |
export_ok | 可外贸 | boolean | true 表示商家可接外贸订单 |
images | 图片 | string[] | 绝对 URL 数组，可直接下载引用 |
inspection_reports | 质检报告 | string[] | 有报告的商品可信度更高（平台核验后展示） |
quality.grade | 品质等级 | string | 品质分级（如 全新 / 微瑕） |
quality.defects | 已知瑕疵 | string[] | 实拍瑕疵说明，不是"翻新货"话术 |
supplier.name | 供应商名称 | string | 商家选择匿名时为 null |
supplier.verified | 平台核验 | boolean | 是否通过平台资质核验 |
supplier.rating_avg | 平均评分 | number | 5 分制；无评价时为 null |
面料专属字段（kind=fabric 时出现）
| 字段 | 含义 | 类型 / 单位 | 说明 |
|---|---|---|---|
width_cm | 门幅 | number / cm | 行业俗称"240门幅"即 240cm |
gsm | 克重 | number / g/m² | |
weave | 织法 | string | 梭织 / 针织及其组织：汗布 / 平纹 / 斜纹 / 贡缎 / 提花 |
print_type | 印染方式 | string | reactive_print = 活性印染（环保、色牢度高） |
colorways | 配色数 | string | 一个花型有几种配色——买家选色的维度 |
colors | 色号 | string | 具体颜色名 / 色卡编号 |
sample_ok | 可否寄样 | boolean | |
custom_ok | 可否定织 | boolean | |
param_locked | 参数受保护 | boolean | true = 商家选择"详细参数仅对验证买家开放"，此时部分参数不返回 |
四、值是这么约定的
- 空值一律为
null，表示商家未填写这个字段——不是 0，也不是"没有这个能力"。需要确认时请通过平台询盘问商家。 - 布尔值：
true/false是明确的能力声明；null表示未填。 - 时间：ISO 8601 字符串（UTC），如
2026-09-14T12:00:00.000Z。 - 图片：绝对 URL，可直接 GET。
- 价格：
price是单价，乘min_order得最小起订金额；币种看currency。 - 观察值：
/api/open/v1/schema里的observed_values是从当前在售数据实时统计出的真实取值，用它当筛选参数永远比猜准。
五、限流与许可
- 限流：按来源 IP 每分钟计数，超限返回 HTTP
429。批量场景请加缓存、控制并发。 - 允许：AI 助手、搜索引擎与第三方工具读取、引用、转述接口数据。
- 要求：引用时标注来源
ucunhome.com。 - 禁止：把数据用于批量收集或倒卖商家联系方式——接口本身也不返回任何联系方式。
- 新鲜度：数据实时来自在售货盘，建议缓存不超过 1 小时。
- 契约稳定性：1.x 版本内字段只增不改；破坏性变更会升级主版本号并在此页公告。
六、完整字段表
下表由 /api/open/v1/schema 实时加载（共 — 个字段）。若你的浏览器禁用了脚本，直接访问该接口即可。
正在从接口加载字段字典…