暂不可用
我们正在恢复这项能力。在此之前调用通常会失败或没有结果;失败和空结果都不扣费。
接口健康状态
- 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 等待后重试。
写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
platform | body | string | 是 | taobao | 平台标识,固定值。 |
action | body | string | 是 | shop | 能力标识,固定值。 |
shop | body.params | string | 是 | - | 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 小时内再查同一个店,结果相同,同样按一次调用计费。其他空结果不扣费。 |
page | body.params | integer | 否 | - | 店铺商品的页码,1–35。带 page 就按淘宝店铺的分页整页给:一页通常 60 条,末页更少,limit 不起作用;不带 page 是单次调用,最多 20 条,和以前一样。每页算一次调用,价格不变;翻过末页返回空结果、不扣费,翻到空结果就是到底了。淘宝每种排序最多给到前约 2,060 件(第 35 页),商品更多的店拿不全,换一种 sort 能拿到另一部分。翻页时各页用同一个 sort。排序实时变化,相邻两页偶尔有几件重复,合并时按 id 去重。一页通常 10–45 秒,遇到换号重试最长约 60 秒。有时第 1 页最多只返回前 20 条,回包顶层带 partial: true,仍算一次调用;这时第 2 页起返回 503、不扣费,稍后重试可拿到整页。 |
seller | body.params | string | 否 | - | 卖家 userId 的兼容输入,不是卖家昵称;优先级低于 shop 和 user_id。 |
sort | body.params | string (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_id | body.params | string | 否 | - | 卖家数字 userId 的兼容输入,低于 shop 优先级,不是商品 ID。 |
limit | body.params | integer (1–20) | 否 | 20 | 这次调用最多返回的条数,整数,1–20;不传按默认值,实际返回可能少于这个数。超过上限照收,按上限返回。 |
代码示例
#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。
响应示例
#{ "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 空结果
- 没有数据。多数不扣费,个别照常计费,见常见问题和参数说明。