Elimapi

如何在 Taobao/1688 上搜索产品

何时使用本指南

当您需要从 Taobao/1688 获取产品数据时使用：按关键词或图片搜索产品、应用过滤器，以及获取单个产品的详情。

本指南使用产品 API v2（当前版本）。如果您正在使用 v1，请参阅产品 API v1（旧版）。

所有参数和值的完整参考：产品 API 参考

前提条件

  • API 身份验证信息（JWT 或 API Key）— 参见身份验证 API 请求
  • Base URL：https://openapi.elim.asia

按关键词搜索

第 1 步 — 调用搜索端点

POST /v2/products/search

{
  "platform": "taobao",
  "q": "áo thun cotton",
  "page": 1,
  "size": 20,
  "lang": "vi"
}

platform 参数（taobao 或 alibaba）在 v2 API 中是必填的。

第 2 步 — 翻译结果语言

使用 lang 参数（vi/en/ru/ko/ja）获取已翻译的标题。翻译数据位于 title_en 键中；title 键仍是原始中文。

第 3 步 — 结果排序

使用 sort 参数：

值含义
PRICE_ASC / PRICE_DESC价格升序/降序
SALE_QTY_ASC / SALE_QTY_DESC销量升序/降序

第 4 步 — 过滤结果（可选）

使用 filter 参数并配合以下条件（大多数仅适用于 1688）：

  • filter.priceRange — 价格区间（CNY）：{ "min": 0, "max": 100 } — ✅ Taobao ✅ 1688
  • filter.shopId — 同卖家产品 — ✅ Taobao ✅ 1688
  • filter.sellerLevel（L1–L4）— 卖家等级
  • filter.isFactory — 仅取超级工厂货源
  • filter.ffmOutbound（FFMO1–FFMO6）— 快速出库率
  • filter.ffmDelivery（FFMD0–FFMD2）— 配送速度
  • filter.allowDropship、filter.freeshipForDropship — 支持代发货
  • filter.newArrival（7DAY/30DAY）— 新上架更新
  • filter.platformPick、filter.globalPick、filter.dropshipPick — 平台精选货源

每个过滤器的完整值列表：产品 API 参考

按图搜索

注意： 此功能不适用于免费套餐。

POST /v2/products/search-by-image

有两种方式：

方式 1 — 使用图片 URL（仅限 *.alicdn.com 链接）：

{
  "platform": "taobao",
  "imgUrl": "https://img.alicdn.com/bao/uploaded/i3/694223667/O1CN01zSjKgp1cxXRQZsDLA_!!694223667.jpg",
  "lang": "vi"
}

方式 2 — 使用已上传的图片：

  1. 通过 API POST /v2/products/upload-image 上传图片以获取 imageId。
  2. 使用 imgId 代替 imgUrl 调用 search-by-image：
{
  "platform": "alibaba",
  "imgId": "image-123",
  "lang": "vi"
}

获取单个产品详情

第 1 步 — 处理短链接（如有）

格式为 https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd 的短链接必须先展开。使用 Unshorten link API 获取原始链接和产品 ID。

第 2 步 — 调用详情端点

POST /v2/products/find

{
  "platform": "taobao",
  "id": "734467086498"
}

响应包括：价格、库存、变体（颜色/尺寸）、图片相册、描述和物流政策。如需更完整的 1688 数据，请使用 POST /v2/products/detail，请求结构相同。

第 3 步 — 正确显示价格

  • Taobao： 优先使用 promotion_price；如果没有，则使用 price。
  • 1688： 价格逻辑取决于 quote_type（direct/by_sku/by_volume）。

[!WARNING] API 返回的价格可能高于 Taobao/1688 网站上的价格，因为 API 无法应用复杂的促销活动。如果您在扩展/网站/应用中显示价格，请向客户补充此警告。

验证结果

  • 请求返回 HTTP 200，并带有包含 title、price、img_url 的产品数组。
  • 按图搜索返回与原始图片中商品相似的产品。

相关链接