暂不可用

我们正在恢复这项能力。在此之前调用通常会失败或没有结果;失败和空结果都不扣费。

POST

接口健康状态

24h 健康值
24%
24h 平均耗时
32.25 s
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
暂不可用

24 小时趋势

30 天趋势

店铺资料:返回列表,默认 20 条、单次最多 20 条(传更大的数按 20 条返回);主要字段 id、url、title、original_price、currency、category_id。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 taobao,action 填 shop。 单价 $5.56 / 千次(每次 $0.005556)。失败和多数空结果不收费,个别空结果照常计费,见本页常见问题和参数说明。 同步返回;慢任务可在请求体加 "mode": "async",先拿 job_id 再轮询。

淘宝店铺资料按卖家数字 ID 或店铺链接 shop 列出这家店正在出售的商品:不带 page 每次最多 20 条;带 page 按页往后翻,一页通常 60 条,最多到第 35 页。每行带商品标题、链接、划线价与币种、类目 ID、是否包邮和主图,并附店铺名、店铺 ID、卖家 ID、店铺三项评分和在售商品总数。它回答「这家店在卖什么」,适合抽样看竞品店铺的货盘,或者核对品牌经销商在卖哪些商品。

original_price 是列表展示的划线价,不是实际卖价,可能明显偏高;要卖价,把商品交给淘宝商品详情。每行没有销量和评论数。shop_item_count 是全店在售总数;商品很多的店,每种排序最多翻到前约 2,060 件。

AI 提示词

#
请帮我用 EveryInfra 的「淘宝店铺资料」接口(taobao/shop)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 taobao,action 填 shop,参数放在 params 里。
- 必填参数:
  - shop:shop 的卖家数字 userId(sellerId),或店铺链接(shop<shopId>.taobao.com);返回该店的在售商品。
- 可选参数:
  - page:店铺商品的页码,1–35。带 page 就按淘宝店铺的分页整页给:一页通常 60 条,末页更少,limit 不起作用;不带 page 是单次调用,最多 20 条,和以前一样。每页算一次调用,价格不变。
  - seller:卖家 userId 的兼容输入,不是卖家昵称;优先级低于 shop 和 user_id。
  - sort:带 page 翻页时店铺商品的排序:popular、best_selling、sales 按销量(默认),new、newly_listed 按上新,price_asc、lowest_price 按价格从低到高,price…(可选值:best_selling / highest_price / lowest_price / new / newly_listed / popular / price_asc / price_desc)
  - user_id:卖家数字 userId 的兼容输入,低于 shop 优先级,不是商品 ID。
  - limit:这次调用最多返回的条数,整数,1–20;不传按默认值,实际返回可能少于这个数。超过上限照收,按上限返回。(默认 20)
- 返回一组记录,每条记录的主要字段:id、url、title、original_price(原价(划线价))、currency、category_id(类目 ID)、free_shipping(是否包邮)、shop_name(店铺名)、shop_id(店铺 ID(search 行与详情…)、seller_id(卖家 ID(shop 偶尔缺)、image_url、shop_url(店铺链接(product_deta…);一共 17 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=taobao。
- 示例请求体:
{
  "platform": "taobao",
  "action": "shop",
  "params": {
    "shop": "713464357"
  }
}
- 计费:$5.56 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是taobao平台标识,固定值。
actionbodystring是shop能力标识,固定值。
shopbody.paramsstring是-shop 的卖家数字 userId(sellerId),或店铺链接(shop<shopId>.taobao.com);返回该店的在售商品。不带 page 每次最多 20 条(limit 更大也只给 20 条,按次计费不变);带 page 按淘宝店铺的分页一页一页取,一页通常 60 条。不是店铺名称。同一个店、同样的 sort,再加上同样的 page(带 page 时)或同样的 limit(不带 page 时),12 小时内重复查询会返回和第一次相同的数据,照常计费。店铺不存在时返回空结果,empty_reason 为 shop_not_found,按一次调用计费;24 小时内再查同一个店,结果相同,同样按一次调用计费。其他空结果不扣费。
pagebody.paramsinteger否-店铺商品的页码,1–35。带 page 就按淘宝店铺的分页整页给:一页通常 60 条,末页更少,limit 不起作用;不带 page 是单次调用,最多 20 条,和以前一样。每页算一次调用,价格不变;翻过末页返回空结果、不扣费,翻到空结果就是到底了。淘宝每种排序最多给到前约 2,060 件(第 35 页),商品更多的店拿不全,换一种 sort 能拿到另一部分。翻页时各页用同一个 sort。排序实时变化,相邻两页偶尔有几件重复,合并时按 id 去重。一页通常 10–45 秒,遇到换号重试最长约 60 秒。有时第 1 页最多只返回前 20 条,回包顶层带 partial: true,仍算一次调用;这时第 2 页起返回 503、不扣费,稍后重试可拿到整页。
sellerbody.paramsstring否-卖家 userId 的兼容输入,不是卖家昵称;优先级低于 shop 和 user_id。
sortbody.paramsstring (enum)否-带 page 翻页时店铺商品的排序:popular、best_selling、sales 按销量(默认),new、newly_listed 按上新,price_asc、lowest_price 按价格从低到高,price_desc、highest_price 按价格从高到低。价格排序按商品的卖价排,返回行里的 original_price 是划线价,看起来可能不完全按顺序。不带 page 时传了不报错,但不保证按它排。允许值best_sellinghighest_pricelowest_pricenewnewly_listedpopularprice_ascprice_descsales
user_idbody.paramsstring否-卖家数字 userId 的兼容输入,低于 shop 优先级,不是商品 ID。
limitbody.paramsinteger (1–20)否20这次调用最多返回的条数,整数,1–20;不传按默认值,实际返回可能少于这个数。超过上限照收,按上限返回。

代码示例

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "taobao",
  "action": "shop",
  "params": {
    "shop": "713464357"
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。

响应示例

#
2026年10月25日 02:28(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息,列表只保留前 2 条;id、billing、quota 每次调用都不同,只给结构。
json
{  "id": "req_…",  "platform": "taobao",  "action": "shop",  "results": [    {      "id": "•••",      "url": "https://item.taobao.com/item.htm?id=521031921743",      "title": "绿联适用苹果iPhone14/13/12Proxsmax11plus8充电线mfi认证lightning数据线平板iPad手机18/17/16/15/usb车载",      "original_price": 24.88,      "currency": "CNY",      "category_id": "50050366",      "free_shipping": false,      "shop_name": "绿联数码旗舰店",      "shop_id": "67095450",      "seller_id": "713464357",      "image_url": "https://img.alicdn.com/imgextra/bao/upload/O1CN01pO8nJU1z74sArhuWH_!!6000000006666-2-yinhe.png",      "shop_url": "https://shop67095450.taobao.com",      "shop_logo_url": "https://img.alicdn.com/imgextra/i2/TB1rBsXkkL0gK0jSZFASuwA9pXa.jpg",      "shop_score_description": 4.8,      "shop_score_service": 4.8,      "shop_score_delivery": 4.9,      "shop_item_count": 1299,      "platform": "taobao"    },    {      "id": "•••",      "url": "https://item.taobao.com/item.htm?id=523147854719",      "title": "绿联拓展坞typec扩展USB集线器多接口HDMI网路线转换转接头适用华为苹果macbook雷电4笔记型电脑iPad平板手机18",      "original_price": 79,      "currency": "CNY",      "category_id": "110219",      "free_shipping": false,      "shop_name": "绿联数码旗舰店",      "shop_id": "67095450",      "seller_id": "713464357",      "image_url": "https://img.alicdn.com/imgextra/i2/713464357/O1CN013mRFCd1i3YRecOBA4_!!2-item_pic.png",      "shop_url": "https://shop67095450.taobao.com",      "shop_logo_url": "https://img.alicdn.com/imgextra/i2/TB1rBsXkkL0gK0jSZFASuwA9pXa.jpg",      "shop_score_description": 4.8,      "shop_score_service": 4.8,      "shop_score_delivery": 4.9,      "shop_item_count": 1299,      "platform": "taobao"    }  ],  "count": 20,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

#

业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。

字段含义
id该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url该记录在原平台上的可访问链接。
title标题。平台无标题概念时(如纯文本帖)为 null。
original_price原价(划线价);search 无折扣时与 price 相同。product_detail 多数调用为空。shop 只有这一个价:列表展示的划线价,不是实际卖价,可能明显偏高;要卖价用 product_detail。
currency价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
category_id类目 ID。
free_shipping是否包邮。
shop_name店铺名。
shop_id店铺 ID(search 行与详情、店铺商品行里是同一个 ID)。
seller_id卖家 ID(shop 偶尔缺;product_detail 的部分来源不给)。
image_url图片链接。多图能力可能返回 image_urls 数组。
shop_url店铺链接(product_detail、shop)。
shop_logo_url店铺 Logo 链接(product_detail、shop;shop 偶尔缺)。
shop_score_description店铺动态评分·描述相符(5 分制)。
shop_score_service店铺动态评分·服务态度(5 分制)。
shop_score_delivery店铺动态评分·物流服务(5 分制)。
shop_item_count店铺在售商品数(product_detail、search、shop)。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

常见问题

#

shop 应该填什么?

#

填卖家在淘宝的数字用户 ID,例如 713464357 这样的一串数字,或者店铺链接 shop<shopId>.taobao.com。店铺名称和商品 ID 都不能用来定位卖家。user_id 和 seller 是同一输入的兼容写法,几个同时传入时,先认 shop,其次是 user_id。店铺不存在时返回空结果,按一次调用计费。

一次能拿多少条,能排序、翻页吗?

#

不带 page 每次最多 20 条:limit 传更大也只回 20 条,按次计费不变;sort 传了不报错,但不保证生效。带 page(1–35)就按淘宝店铺的分页整页给,一页通常 60 条,每页算一次调用,sort 生效,各页用同一个 sort;翻到空结果就是到底了,空页不扣费。每种排序最多翻到前约 2,060 件,商品更多的店换一种 sort 能拿到另一部分,合并时按 id 去重。

想看某件商品的卖价、详情和评价怎么办?

#

把这一行的 id(商品数字 ID)或 url 交给淘宝商品详情,可以拿到价格、规格、券后价和详情图;交给淘宝评价可以读买家反馈,交给淘宝问题列表可以看「问大家」。这三个能力都接受商品数字 ID 和淘宝、天猫商品链接。

错误与计费

#
401
缺少 Key 或 Key 无效。
402
余额不足,先充值。
422
参数名或取值不对,按错误信息给的候选改;不扣费。
429
超过每分钟请求上限,按 Retry-After 等待后再试。
503
暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
200 空结果
没有数据。多数不扣费,个别照常计费,见常见问题和参数说明。

错误码

Google Analytics 同意才加载 隐私