淘宝

淘宝 API

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

平台可用度

24h 健康值
85%
可用

30 天趋势

淘宝 能力清单

能力做什么单价24 小时可用度
关键词搜索search按商品关键词搜索,用 tmall_only 决定是否仅查天猫商品。$1.39 / 千次少量可用 · 健康值 66%
商品详情product_detail按商品数字 ID 定位单品,分别查看商品资料、SKU 和运费信息。$1.39 / 千次可用 · 健康值 86%
店铺资料shop用 shop 查询指定卖家的商品列表,建立自己的店铺观察记录。$1.39 / 千次暂不可用
评价reviews用 reviews 读取单品评价,按购买规格和反馈内容归类。$1.39 / 千次正常
问题列表questions用 questions 读取商品问答,发现规格、使用或购买前的常见疑问。$1.39 / 千次暂不可用

点能力名进它的文档:参数、返回字段、代码示例和试用。

淘宝 每个接口分别做什么

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

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

能力必填参数可选参数单次条数模式单价返回字段
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 · shop_id · sold_text · original_price · coupon_price · discount_type · is_tmall · brand · category_id · seller_credit_level · seller_positive_rate · shop_score_description · shop_score_service · shop_score_delivery · subtitle · search_rank · free_shipping · selling_points · review_tags · 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 · category_name · description · keywords · titleOriginal · has_cn_title · shop_score_description · shop_score_service · shop_score_delivery · free_shipping · promotion_price · discount_price · discount_type · price_note · has_price_range · payment_methods · seller_id · seller_credit_level · seller_type · seller_type_label · selling_points · shop_logo_url · shop_url · shop_item_count · shop_new_item_count · shop_opened_at · review_tags · review_count · positive_rate · seven_day_return · 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—默认 20 · 最多 100同步$1.39 / 千次id · text · rating · rating_scale · posted_at · sku · buy_count · useful_count · author_name · author_avatar_url · images · review_append · platform · seller_reply
questionsurl—默认 10 · 最多 100同步$1.39 / 千次id · url · text · answer_count · posted_at · answers · platform

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

product_detail

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

查看完整接口文档:参数、代码示例、响应样例与健康状态 →

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

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

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

淘宝 返回字段与含义(66)
is_tmall
是否为天猫店(区别于淘宝 C 店,开店门槛和保障不同)。
shop_id
店铺 ID(search 行与详情、店铺商品行同一口径)。
shop_name
店铺名。
brand
品牌。
category_id
类目 ID。
original_price
原价。
sold_count
销量。
stock
库存。
coupon_price
券后价(有优惠券时低于 price,无券时缺省)。
free_shipping
是否包邮。
discount_type
折扣/活动类型原文(如「特价秒杀」)。
seller_credit_level
卖家信用等级(数字,越大越高)。
shop_score_description
店铺动态评分·描述相符(5 分制)。
shop_score_service
店铺动态评分·服务态度(5 分制)。
shop_score_delivery
店铺动态评分·物流服务(5 分制)。
selling_points
商品卖点标签列表。
review_tags
评价标签列表,每项 tag(标签文字)与 count(提到次数,可能缺省)。
shipping_fee
运费。
skus
规格列表(全量,有多少给多少)。每条可含 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
主图视频直链(无视频时缺省)。
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
图片链接列表:product_detail 是商品图,reviews 是买家晒图(没晒图时没有这个字段)。
seller_id
卖家 ID。
category_name
叶子类目名(product_detail)。
keywords
商品页关键词(product_detail)。
promotion_price
促销价(product_detail,常缺省)。
discount_price
折后价(product_detail,常缺省)。
price_note
价格说明原文(product_detail)。
has_price_range
是否区间价(多规格价格不同,product_detail)。
payment_methods
支持的支付方式(product_detail)。
seller_type
卖家类型代码(product_detail)。
seller_type_label
卖家类型名称(product_detail,如天猫、企业店)。
shop_logo_url
店铺 Logo 链接(product_detail)。
shop_url
店铺链接(product_detail)。
shop_item_count
店铺在售商品数(product_detail)。
shop_new_item_count
店铺新品数(product_detail)。
shop_opened_at
开店时间原文(product_detail)。
positive_rate
商品好评率(product_detail,百分数,常缺省)。
seven_day_return
是否支持七天无理由退货(product_detail)。

怎么调用 淘宝 店铺资料 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、questions 不接受 sort。shop 不接受 sort。
查看全部 9 个允许值

best_sellinghighest_pricelowest_pricenewnewly_listedpopularprice_ascprice_descsales

user_id可选
卖家数字 userId 的兼容输入,低于 shop 优先级,不是商品 ID。
淘宝 返回字段与含义(7)
shop_id
店铺 ID(search 行与详情、店铺商品行同一口径)。
shop_name
店铺名。
category_id
类目 ID。
free_shipping
是否包邮。
seller_id
卖家 ID。
sold_count_30d
近 30 天销量(店铺在售商品行)。
comment_count
评论数(店铺在售商品行)。

怎么调用 淘宝 评价 API?

reviews

使用 platform="taobao"、action="reviews" 调用“评价”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 id、text、rating、rating_scale、posted_at、sku 等 14 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态 →

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

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

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

淘宝 返回字段与含义(7)
images
图片链接列表:product_detail 是商品图,reviews 是买家晒图(没晒图时没有这个字段)。
buy_count
购买人数。
sku
规格。
useful_count
评价被标有用次数。
seller_reply
卖家对该评价的回复。
review_append
买家追评正文(有多条时按时间顺序换行拼接;没有追评时字段不出现)。
author_avatar_url
评价人头像链接(reviews)。

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

questions

使用 platform="taobao"、action="questions" 调用“问题列表”能力;返回列表,默认 10 条、单次最多 100 条,主要包含 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 统一字段名

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

淘宝 的独有字段名(当前目录)

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

  • coupon_price
  • discount_type
  • is_tmall
  • seller_positive_rate
  • shop_score_description
  • shop_score_service
  • shop_score_delivery
  • selling_points
  • ems_fee
  • express_fee
  • spec_values
  • props_images
  • main_image_url
  • description_html
  • price_usd
  • suggestive_price
  • has_discount
  • is_promotion

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/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
库存。
shop_id
店铺 ID(search 行与详情、店铺商品行同一口径)。
sold_text
销量原文(search,如「10万+」);带「+」或「万」的是平台展示的约数,不是精确销量。
original_price
原价。
coupon_price
券后价(有优惠券时低于 price,无券时缺省)。
discount_type
折扣/活动类型原文(如「特价秒杀」)。
is_tmall
是否为天猫店(区别于淘宝 C 店,开店门槛和保障不同)。
brand
品牌。
category_id
类目 ID。
seller_credit_level
卖家信用等级(数字,越大越高)。
seller_positive_rate
卖家好评率(search,百分数,100 即 100%)。
shop_score_description
店铺动态评分·描述相符(5 分制)。
shop_score_service
店铺动态评分·服务态度(5 分制)。
shop_score_delivery
店铺动态评分·物流服务(5 分制)。
subtitle
商品副标题(search,卖点短句)。
search_rank
在本次搜索结果中的位置(search,从 1 起)。
free_shipping
是否包邮。
selling_points
商品卖点标签列表。
review_tags
评价标签列表,每项 tag(标签文字)与 count(提到次数,可能缺省)。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
shipping_fee
运费。
ems_fee
EMS 运费。
express_fee
快递运费。
skus
规格列表(全量,有多少给多少)。每条可含 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
主图视频直链(无视频时缺省)。
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
图片链接列表:product_detail 是商品图,reviews 是买家晒图(没晒图时没有这个字段)。
category_name
叶子类目名(product_detail)。
description
简介或描述,通常比 text 短。
keywords
商品页关键词(product_detail)。
promotion_price
促销价(product_detail,常缺省)。
discount_price
折后价(product_detail,常缺省)。
price_note
价格说明原文(product_detail)。
has_price_range
是否区间价(多规格价格不同,product_detail)。
payment_methods
支持的支付方式(product_detail)。
seller_id
卖家 ID。
seller_type
卖家类型代码(product_detail)。
seller_type_label
卖家类型名称(product_detail,如天猫、企业店)。
shop_logo_url
店铺 Logo 链接(product_detail)。
shop_url
店铺链接(product_detail)。
shop_item_count
店铺在售商品数(product_detail)。
shop_new_item_count
店铺新品数(product_detail)。
shop_opened_at
开店时间原文(product_detail)。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
positive_rate
商品好评率(product_detail,百分数,常缺省)。
seven_day_return
是否支持七天无理由退货(product_detail)。
sold_count_30d
近 30 天销量(店铺在售商品行)。
comment_count
评论数(店铺在售商品行)。
text
正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
sku
规格。
buy_count
购买人数。
useful_count
评价被标有用次数。
author_name
作者昵称(显示名)。
author_avatar_url
评价人头像链接(reviews)。
review_append
买家追评正文(有多条时按时间顺序换行拼接;没有追评时字段不出现)。
seller_reply
卖家对该评价的回复。
answer_count
「问大家」回答数。
answers
问大家的回答内容。

当前目录另列出 titleOriginal · has_cn_title,这些字段尚无逐项释义;请先核对 淘宝 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

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

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

taobao_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer 你的 API 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,
  "shop_id": null,
  "sold_text": null,
  "original_price": null,
  "coupon_price": null,
  "discount_type": null,
  "is_tmall": null,
  "brand": null,
  "category_id": null,
  "seller_credit_level": null,
  "seller_positive_rate": null,
  "shop_score_description": null,
  "shop_score_service": null,
  "shop_score_delivery": null,
  "subtitle": null,
  "search_rank": null,
  "free_shipping": null,
  "selling_points": null,
  "review_tags": 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,也不能把用户回答当作商家的正式承诺。

淘宝 教程与实战

先在本页核对当前 action、参数与字段,再按真实任务进入完整步骤或相邻方法;文章中的示例和边界不会替代本页机器目录。

Blog

价格抓取怎么商业化:做一款商家愿意续费的价格监控产品

商家为什么为价格监控付费,又为什么取消订阅?从商品匹配、经营例外清单和调价审批出发,拆解价格数据的交付方式、收费单位与试点验证。

阅读完整文章 →
指南

统一数据 API 入门:从能力目录到第一条可用结果

用 platform、action、params 接入多平台数据:读懂能力目录,完成最小请求,处理异步任务、部分结果与计费,并建立可追溯的数据记录。

阅读完整文章 →
指南

API 失败、返还与对账:如何核对一条请求的净扣款

把业务任务、调用尝试、交付状态与钱包事件分开,解释扣前拒绝、空结果和部分返还,避免把同一返还重复减项,并用整数离线示例核对单次请求。

阅读完整文章 →

淘宝 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 通 90 个平台。

淘宝 API 怎么收费?

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

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

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

淘宝 API 返回哪些字段?

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

「区分淘宝与天猫商品搜索」怎样接入 淘宝 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 次数据调用),注册后在控制台「余额与充值」兑换,进入赠送余额,24 小⁠时内有效。请先选择 淘宝 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 5 个能力。无需信用卡。

开始调用 淘宝 API

加微信领 $1 额度码,注册后在控制台兑换,24 小⁠时内有效,先选一个 淘宝 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始