万有引擎
搜索⌘K
中文
登录免费开始

电商数据 · 数据 API

淘宝

淘宝 API

搜索淘宝与天猫商品，按商品或卖家标识查看单品规格和店铺商品列表，再分别读取评价与“问大家”，便于核对购买规格、反馈和购买前疑问。 调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始 看文档

5

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

淘宝 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordmax_price, min_price, sort, tmall_only默认 20 · 最多 20同步$1.39 / 千次id · url · title · price · currency · sold_count · rating · rating_scale · location · shop_name · image_url · stock · platform
product_detailurl——同步$1.39 / 千次id · url · title · brand · price · original_price · currency · stock · sold_count · category_id · location · is_tmall · shop_name · shop_id · shipping_fee · ems_fee · express_fee · skus · sku_count · spec_values · props_images · attributes · main_image_url · description_images · description_html · video_url · coupon_price · price_usd · total_price · suggestive_price · has_discount · is_promotion · promo_type · is_virtual · brand_id · root_category_id · category_path · weight · size · favorite_count · fans_count · min_order_quantity · shipping_to · listed_at · modified_at · delist_at · images · platform
shopshopseller, sort, user_id默认 20 · 最多 100同步$1.39 / 千次id · url · title · price · currency · category_id · sold_count_30d · comment_count · free_shipping · shop_name · shop_id · seller_id · rating · rating_scale · image_url · platform
reviewsurl——同步$1.39 / 千次id · text · rating · rating_scale · posted_at · sku · buy_count · useful_count · author_name · images · platform · seller_reply
questionsurl——同步$1.39 / 千次id · url · text · answer_count · posted_at · answers · platform

淘宝 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 淘宝 商品详情 API？

product_detail

使用 platform="taobao"、action="product_detail" 调用“商品详情”能力；返回单个对象，主要包含 id、url、title、brand、price、original_price 等 48 个字段。

淘宝 product_detail 的参数分别是什么意思？

url必填
product_detail / reviews / questions 接收商品数字 ID、淘宝/天猫商品 URL，或含唯一商品 URL 的分享文本；e.tb.cn / m.tb.cn 短链仅在可安全解析为商品页时接受。纯淘口令、过期链接和非商品页会拒绝。

淘宝将商品 ID 说明为商品链接中 id= 后的数字，并将 SKU 解释为颜色、尺码等具体规格组合；商品 ID 与 SKU 不应混用。官方来源：淘宝：商品 ID 与 SKU 名词说明来源核查：

淘宝 特有返回字段与含义（41）
shop_name
店铺名。
sold_count
销量。
stock
库存。
is_tmall
是否为天猫店（区别于淘宝 C 店，开店门槛和保障不同）。
shop_id
店铺 ID。
brand
品牌。
category_id
类目 ID。
original_price
原价。
shipping_fee
运费。
skus
规格列表（全量，最多 500 条）。每条可含 id/name/price/original_price/coupon_price/stock/props_ids/image_url。
sku_count
SKU 数量。
coupon_price
券后价（有优惠券时低于 price，无券时缺省）。
spec_values
商品规格值全表（含未在售组合），id 为规格值标识、text 为规格文本。
props_images
规格值配图，id 与 spec_values/props_ids 同一标识，image_url 为该规格的展示图。
attributes
商品属性列表（品牌、型号、产地等 {name, value} 行）。
main_image_url
主图（首图）。
description_images
详情页描述区长图列表（按页面出现顺序）。
description_html
详情页描述区原始 HTML（以图片标签为主）。
video_url
主图视频直链（无视频时缺省）。
price_usd
美元参考价（按返回数据中的折算值）。
total_price
总价（以返回数据为准，常缺省）。
suggestive_price
建议零售价（常缺省）。
has_discount
是否有折扣。
is_promotion
是否促销中。
promo_type
促销类型。
is_virtual
是否虚拟商品。
brand_id
品牌 ID。
root_category_id
根类目 ID。
category_path
类目路径（面包屑）。
weight
商品重量（以返回数据为准，常为 0 或缺省）。
size
商品尺寸（常缺省）。
favorite_count
收藏数。
fans_count
粉丝数（以返回数据为准，常缺省）。
min_order_quantity
最小起订量。
ems_fee
EMS 运费。
express_fee
快递运费。
shipping_to
配送范围说明（常缺省）。
listed_at
上架时间（ISO 8601，数据缺省时字段不出现）。
modified_at
最近修改时间（ISO 8601，数据缺省时字段不出现）。
delist_at
下架时间（ISO 8601，数据缺省时字段不出现）。
images
商品图。

怎么调用 淘宝 店铺资料 API？

shop

使用 platform="taobao"、action="shop" 调用“店铺资料”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、title、price、currency、category_id 等 16 个字段。

淘宝 shop 的参数分别是什么意思？

shop必填
shop 的卖家数字 userId，返回该卖家的在售商品；不是店铺名称或 shop 域名。

官方接口证明当前授权卖家可以读取自己的在售商品列表；它不能证明任意第三方卖家的数字 userId 都可返回完整在售目录，也不能为 EveryInfra 固定的销售排序或最大页数背书。官方来源：淘宝开放平台：授权卖家的在售商品来源核查：

seller可选
卖家 userId 的兼容输入，不是卖家昵称；优先级低于 shop 和 user_id。
sort可选
search 使用 popular、price_desc、relevance，当前不提供低价优先；默认/relevance 最多 20 条，popular/price_desc 最多 10 条。reviews 使用 newest、relevance。shop 的标准目录排序语义未完整确认，当前不公开 sort。
查看全部 9 个允许值

best_sellinghighest_pricelowest_pricenewnewly_listedpopularprice_ascprice_descsales

user_id可选
卖家数字 userId 的兼容输入，低于 shop 优先级，不是商品 ID。
淘宝 特有返回字段与含义（7）
shop_name
店铺名。
shop_id
店铺 ID。
category_id
类目 ID。
sold_count_30d
近 30 天销量（店铺在售商品行）。
comment_count
评论数（店铺在售商品行）。
free_shipping
是否包邮（店铺在售商品行）。
seller_id
卖家 ID。

怎么调用 淘宝 评价 API？

reviews

使用 platform="taobao"、action="reviews" 调用“评价”能力；返回列表，主要包含 id、text、rating、rating_scale、posted_at、sku 等 12 个字段。

淘宝 reviews 的参数分别是什么意思？

url必填
product_detail / reviews / questions 接收商品数字 ID、淘宝/天猫商品 URL，或含唯一商品 URL 的分享文本；e.tb.cn / m.tb.cn 短链仅在可安全解析为商品页时接受。纯淘口令、过期链接和非商品页会拒绝。

淘宝将商品 ID 说明为商品链接中 id= 后的数字，并将 SKU 解释为颜色、尺码等具体规格组合；商品 ID 与 SKU 不应混用。官方来源：淘宝：商品 ID 与 SKU 名词说明来源核查：

淘宝 特有返回字段与含义（5）
images
商品图。
buy_count
购买人数。
sku
规格。
useful_count
评价被标有用次数。
seller_reply
卖家对该评价的回复。

怎么调用 淘宝 问题列表 API？

questions

使用 platform="taobao"、action="questions" 调用“问题列表”能力；返回列表，主要包含 id、url、text、answer_count、posted_at、answers 等 7 个字段。

淘宝 questions 的参数分别是什么意思？

url必填
product_detail / reviews / questions 接收商品数字 ID、淘宝/天猫商品 URL，或含唯一商品 URL 的分享文本；e.tb.cn / m.tb.cn 短链仅在可安全解析为商品页时接受。纯淘口令、过期链接和非商品页会拒绝。

淘宝将商品 ID 说明为商品链接中 id= 后的数字，并将 SKU 解释为颜色、尺码等具体规格组合；商品 ID 与 SKU 不应混用。官方来源：淘宝：商品 ID 与 SKU 名词说明来源核查：

淘宝 特有返回字段与含义（2）
answer_count
「问大家」回答数。
answers
问大家的回答内容。
淘宝 search 调用流程一次 淘宝 search 调用的全过程：向 POST /api/v1/social 发送 platform="taobao"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、price、currency 等字段；返回列表，单次最多 20 条，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "taobao"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idurltitlepricecurrency
一次 淘宝 search 调用的全过程：向 POST /api/v1/social 发送 platform="taobao"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、price、currency 等字段；返回列表，单次最多 20 条，计费 $1.39 / 千次，失败与空结果不计费。

淘宝 原始字段名

EveryInfra 统一字段名

左边是 淘宝 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

淘宝 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 25 个字段名只在 淘宝 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • is_tmall
  • shipping_fee
  • ems_fee
  • express_fee
  • spec_values
  • props_images
  • main_image_url
  • description_html
  • coupon_price
  • price_usd
  • suggestive_price
  • has_discount
  • is_promotion
  • promo_type
  • is_virtual
  • root_category_id
  • fans_count
  • shipping_to

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url
该记录在原平台上的可访问链接。
title
标题。平台无标题概念时（如纯文本帖）为 null。
price
价格数值，不含货币符号；币种见 currency。
currency
价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
sold_count
销量。
rating
评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
location
地理位置描述，原文透传，格式随平台而异。
shop_name
店铺名。
image_url
图片链接。多图能力可能返回 image_urls 数组。
stock
库存。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
brand
品牌。
original_price
原价。
category_id
类目 ID。
is_tmall
是否为天猫店（区别于淘宝 C 店，开店门槛和保障不同）。
shop_id
店铺 ID。
shipping_fee
运费。
ems_fee
EMS 运费。
express_fee
快递运费。
skus
规格列表（全量，最多 500 条）。每条可含 id/name/price/original_price/coupon_price/stock/props_ids/image_url。
sku_count
SKU 数量。
spec_values
商品规格值全表（含未在售组合），id 为规格值标识、text 为规格文本。
props_images
规格值配图，id 与 spec_values/props_ids 同一标识，image_url 为该规格的展示图。
attributes
商品属性列表（品牌、型号、产地等 {name, value} 行）。
main_image_url
主图（首图）。
description_images
详情页描述区长图列表（按页面出现顺序）。
description_html
详情页描述区原始 HTML（以图片标签为主）。
video_url
主图视频直链（无视频时缺省）。
coupon_price
券后价（有优惠券时低于 price，无券时缺省）。
price_usd
美元参考价（按返回数据中的折算值）。
total_price
总价（以返回数据为准，常缺省）。
suggestive_price
建议零售价（常缺省）。
has_discount
是否有折扣。
is_promotion
是否促销中。
promo_type
促销类型。
is_virtual
是否虚拟商品。
brand_id
品牌 ID。
root_category_id
根类目 ID。
category_path
类目路径（面包屑）。
weight
商品重量（以返回数据为准，常为 0 或缺省）。
size
商品尺寸（常缺省）。
favorite_count
收藏数。
fans_count
粉丝数（以返回数据为准，常缺省）。
min_order_quantity
最小起订量。
shipping_to
配送范围说明（常缺省）。
listed_at
上架时间（ISO 8601，数据缺省时字段不出现）。
modified_at
最近修改时间（ISO 8601，数据缺省时字段不出现）。
delist_at
下架时间（ISO 8601，数据缺省时字段不出现）。
images
商品图。
sold_count_30d
近 30 天销量（店铺在售商品行）。
comment_count
评论数（店铺在售商品行）。
free_shipping
是否包邮（店铺在售商品行）。
seller_id
卖家 ID。
text
正文内容，已去除 HTML 标签。长文可能被截断。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
sku
规格。
buy_count
购买人数。
useful_count
评价被标有用次数。
author_name
作者昵称（显示名）。
seller_reply
卖家对该评价的回复。
answer_count
「问大家」回答数。
answers
问大家的回答内容。

请求填写示例

这里检索商品；店铺查询使用店铺目标，排序语义也不同。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

taobao_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"taobao","action":"search","params":{"keyword":"便携咖啡秤"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "title": null,
  "price": null,
  "currency": null,
  "sold_count": null,
  "rating": null,
  "rating_scale": null,
  "location": null,
  "shop_name": null,
  "image_url": null,
  "stock": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

区分淘宝与天猫商品搜索

按商品关键词搜索，用 tmall_only 决定是否仅查天猫商品。

查看 search 的 tmall_only 参数 →
  • tmall_only 使用 JSON 布尔值 true / false，不要传字符串；结合 id、title、shop_name、price 与 currency 整理商品。首发固定只取一页，不把一次结果当作完整商品池。
  • title 按实际返回语言保留，可能不是中文；shop_name 或 location 缺失时保持 unknown，不从标题、商品 ID 或其他样本补齐。字符串 false 目前会被当作真值；keyword 也不是店铺名称的精确查询入口。

核对淘宝单品规格与运费

按商品数字 ID 定位单品，分别查看商品资料、SKU 和运费信息。

查看 product_detail 的 url 参数 →
  • url 使用带 id=数字 的商品链接或纯数字 ID；结合 skus、stock、shipping_fee、shop_name、location 与 currency 核对实际取得的条件。
  • 淘口令或短链不能直接解析；缺失库存、店铺或地区保持 unknown，展示价格也不保证已经包含运费或覆盖所有 SKU。没有商品 ID，或只有状态占位而没有标题、价格、图片等可用商品数据时，不形成最终扣款；如有预留则恢复。

按卖家 userId 读取淘宝在售商品

用 shop 查询指定卖家的商品列表，建立自己的店铺观察记录。

查看 shop 的 shop 参数 →
  • shop 填卖家数字 userId，不是店铺名称、店铺域名或商品 ID；只有同时取得商品 id 与 title 的记录才作为商品返回。
  • 当前固定只读取一页，不承诺全店完整目录；price、category、rating 或 good_rate 缺失时保持 unknown。店铺 sort 映射尚未正确覆盖，不应依赖它调整商品排序。

按商品规格整理淘宝评价

用 reviews 读取单品评价，按购买规格和反馈内容归类。

查看 reviews 的 url 参数 →
  • url 定位商品，结合 text、sku、posted_at 与 useful_count 整理实际取得的评价。
  • 评分字段需结合 rating_scale 理解，不把 rating 直接当作好评率；一次结果也不代表全部历史评价。

从淘宝问大家整理购买疑问

用 questions 读取商品问答，发现规格、使用或购买前的常见疑问。

查看 questions 的 url 参数 →
  • url 使用商品链接或数字 ID；text 是问题，answers 是实际返回的回答，answer_count 是回答数量信息。
  • 问大家不是商品评价接口；answers 长度不保证等于 answer_count，也不能把用户回答当作商家的正式承诺。

淘宝 API 常见问题

淘宝 API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="taobao"、action 和 params。以 search 为例，必填 keyword，可选 max_price、min_price、sort、tmall_only。这里检索商品；店铺查询使用店铺目标，排序语义也不同。 淘宝 共 5 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

淘宝 API 怎么收费？

$1.39 / 千次，淘宝 全部 5 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 淘宝 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

淘宝 API 一次能返回多少条数据？

淘宝 有 4 个列表接口，包括 search、shop、reviews、questions。其余 1 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

淘宝 API 返回哪些字段？

当前目录为 search 列出 id、url、title、price、currency、sold_count 等 13 个字段名。按全站当前目录统计，25 个字段名只在 淘宝 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「区分淘宝与天猫商品搜索」怎样接入 淘宝 API？

按商品关键词搜索，用 tmall_only 决定是否仅查天猫商品。 tmall_only 使用 JSON 布尔值 true / false，不要传字符串；结合 id、title、shop_name、price 与 currency 整理商品。首发固定只取一页，不把一次结果当作完整商品池。 title 按实际返回语言保留，可能不是中文；shop_name 或 location 缺失时保持 unknown，不从标题、商品 ID 或其他样本补齐。字符串 false 目前会被当作真值；keyword 也不是店铺名称的精确查询入口。

「核对淘宝单品规格与运费」怎样接入 淘宝 API？

按商品数字 ID 定位单品，分别查看商品资料、SKU 和运费信息。 url 使用带 id=数字 的商品链接或纯数字 ID；结合 skus、stock、shipping_fee、shop_name、location 与 currency 核对实际取得的条件。 淘口令或短链不能直接解析；缺失库存、店铺或地区保持 unknown，展示价格也不保证已经包含运费或覆盖所有 SKU。没有商品 ID，或只有状态占位而没有标题、价格、图片等可用商品数据时，不形成最终扣款；如有预留则恢复。

「按卖家 userId 读取淘宝在售商品」怎样接入 淘宝 API？

用 shop 查询指定卖家的商品列表，建立自己的店铺观察记录。 shop 填卖家数字 userId，不是店铺名称、店铺域名或商品 ID；只有同时取得商品 id 与 title 的记录才作为商品返回。 当前固定只读取一页，不承诺全店完整目录；price、category、rating 或 good_rate 缺失时保持 unknown。店铺 sort 映射尚未正确覆盖，不应依赖它调整商品排序。

「按商品规格整理淘宝评价」怎样接入 淘宝 API？

用 reviews 读取单品评价，按购买规格和反馈内容归类。 url 定位商品，结合 text、sku、posted_at 与 useful_count 整理实际取得的评价。 评分字段需结合 rating_scale 理解，不把 rating 直接当作好评率；一次结果也不代表全部历史评价。

可以先免费试用 淘宝 API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 淘宝 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 5 个能力。无需信用卡。

更多电商数据 API

1688 API速卖通 APIAmazon APICraigslist API得物 Dewu APIeBay APIEtsy API京东 JD.com API全部 89 平台 ↗

开始调用 淘宝 API

加微信领 $1 免费额度，先选一个 淘宝 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始