Uniqlo Eccommerce

The Uniqlo API provides developers with structured access to apparel product data, store locations, pricing, inventory availability, and collections inspired by the global fashion retailer Uniqlo.

原始信息汇总

Uniqlo Eccommerce API 数据集概述

基本信息

• API名称: Uniqlo Eccommerce
• 类别: Commerce
• 提供者: Pinto Studio
• 订阅计划: BASIC ($0.00 / mo), PRO ($12.99 / mo), ULTRA ($34.99 / mo), MEGA ($199.00 / mo)
• 技术指标: 8.8 流行度, 100% 服务等级, 825ms 延迟

API 概述

该API为开发者提供对全球时尚零售商Uniqlo的服装产品数据、店铺位置、定价、库存可用性和系列的结构化访问。适用于构建电子商务平台、时尚应用、价格比较工具和零售分析仪表板。

这是一个RESTful API，提供对Uniqlo产品目录、店铺信息、搜索功能等的访问，覆盖多个国家。

基础信息

• Base URL: https://uniqlo-eccommerce.p.rapidapi.com
• 请求方式: 所有端点均使用HTTP GET请求，参数通过URL中的查询字符串传递。

通用参数

参数	类型	默认值	描述
countryIso	string	US	ISO国家代码（例如US、GB、JP）。使用“获取国家列表”端点获取所有有效值。
page	number	1	分页结果的页码。
perPage	number	24	每页结果数量。
sortBy	string	varies	排序方法。参见排序选项参考。

端点列表

🌍 国家

• 获取国家列表: GET /country/list
  • 返回API支持的国家完整列表。用于在调用其他端点前查找有效的countryIso值。
  • 参数：无。

📂 分类

• 获取产品分类: GET /categories
  • 检索特定国家的产品分类树。分类包括上衣、下装、外套等服装类型。
  • 参数：countryIso（非必需，默认US）。

🔍 搜索

• 搜索产品: GET /search
  • 通过关键词搜索Uniqlo产品。返回匹配产品的分页列表。
  • 必需参数：query。
  • 可选参数：countryIso, page, perPage, sortBy。
• 获取搜索建议: GET /search/suggestions
  • 基于部分查询返回自动完成/类型提示建议。适用于构建实时搜索栏。
  • 必需参数：query。
  • 可选参数：countryIso, limit（不能超过50）。

📦 产品

• 通过ID获取产品描述: GET /product/description/byid
  • 使用产品ID获取完整产品详情。
  • 必需参数：productId。
  • 可选参数：countryIso。
• 通过URL获取产品描述: GET /product/description/byurl
  • 直接从Uniqlo产品页面URL获取产品详情。当您有链接但没有产品ID时很有用。
  • 必需参数：productUrl。
• 获取产品评论: GET /product/review/byid
  • 返回特定产品的客户评论，支持分页和排序选项。
  • 必需参数：productId。
  • 可选参数：countryIso, page, perPage, sortBy。
• 获取相似产品: GET /product/similar
  • 返回与给定产品相似的产品列表。适用于“您可能也喜欢”部分。
  • 必需参数：productId。
  • 可选参数：countryIso。
• 获取推荐产品: GET /product/recommended
  • 基于给定产品返回推荐产品。类似于“客户也购买”功能。
  • 必需参数：productId。
  • 可选参数：countryIso, page, perPage, sortBy。
• 获取排名产品: GET /product/ranked
  • 返回给定国家/地区的Uniqlo畅销/顶级排名产品。
  • 可选参数：countryIso, limit。
• 按分类获取产品: GET /product/bycategory
  • 按特定分类ID（从分类端点获取）浏览筛选的产品。
  • 必需参数：categoryId。
  • 可选参数：countryIso, page, perPage, sortBy。

🏪 店铺

• 店铺定位器: GET /store/locator
  • 按城市名称、地址或邮政编码查找Uniqlo店铺。
  • 必需参数：query。
  • 可选参数：countryIso, page, perPage。
• 获取可用店铺州/地区: GET /store/available-states
  • 返回一个国家/地区内至少有一家Uniqlo店铺的州/地区列表。
  • 可选参数：countryIso, page, perPage。

🔥 趋势

• 获取趋势关键词: GET /trending/keywords
  • 返回给定国家/地区Uniqlo上当前趋势的搜索关键词。适用于展示热门搜索或启发用户。
  • 可选参数：countryIso。

排序选项参考

产品排序选项（用于搜索、分类、推荐）

值	描述
featured	默认 - 编辑精选优先
newest	最新添加的产品
price_low	价格：从低到高
price_high	价格：从高到低
rating	评分最高的优先

评论排序选项（用于产品评论）

值	描述
most_helpful	默认 - 点赞最多的评论
most_recent	最新评论优先
highest_rated	5星评论优先
lowest_rated	1星评论优先

错误处理

所有错误遵循一致的响应格式： json { "status": "ERROR", "code": "400", "message": "Please provide the productId" }

常见错误代码

代码	含义	常见原因
400	错误请求	缺少或无效参数
404	未找到	产品/店铺/分类不存在
500	内部服务器错误	服务器出现问题

避免错误的提示

• 始终提供标记为✅的必需参数。
• 使用/country/list端点验证countryIso值。
• 使用/categories端点获取有效的categoryId值。
• 在建议端点中不要超过limit=50。
• 确保sortBy值与排序选项参考中列出的可接受选项匹配。

示例工作流程

典型的集成流程（例如，构建产品搜索页面）：

1. GET /country/list → 选择countryIso = "US"
2. GET /trending/keywords?countryIso=US → 在主页显示趋势搜索
3. GET /search/suggestions?query=fle&countryIso=US&limit=10 → 在用户输入时显示自动完成
4. GET /search?query=fleece&countryIso=US&page=1&perPage=24&sortBy=featured → 显示搜索结果
5. GET /product/description/byid?productId=E471903-000&countryIso=US → 显示完整产品详情页面
6. GET /product/review/byid?productId=E471903-000&countryIso=US&sortBy=most_helpful → 显示客户评论
7. GET /product/similar?productId=E471903-000&countryIso=US → 显示“相似产品”部分
8. GET /store/locator?query=New York&countryIso=US → 帮助用户找到最近的店铺