# 淘宝 店铺资料 API (taobao.shop)

- Canonical page: https://everyinfra.com/taobao-api/shop
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "taobao", "action": "shop", "params": {...}}
- Price: $0.005556 per call ($5.56 per 1,000 requests); failed calls and most empty results are not charged; a few are charged (see this page's FAQ and parameter notes)
- Returns: list, default 20, max 20 per call (larger values are capped)
- Mode: sync; add "mode": "async" for slow tasks

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

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

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=taobao&action=shop

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| shop | not declared | yes | not declared | 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 | integer | no | not declared | 店铺商品的页码，1–35。带 page 就按淘宝店铺的分页整页给：一页通常 60 条，末页更少，limit 不起作用；不带 page 是单次调用，最多 20 条，和以前一样。每页算一次调用，价格不变；翻过末页返回空结果、不扣费，翻到空结果就是到底了。淘宝每种排序最多给到前约 2,060 件（第 35 页），商品更多的店拿不全，换一种 sort 能拿到另一部分。翻页时各页用同一个 sort。排序实时变化，相邻两页偶尔有几件重复，合并时按 id 去重。一页通常 10–45 秒，遇到换号重试最长约 60 秒。有时第 1 页最多只返回前 20 条，回包顶层带 `partial: true`，仍算一次调用；这时第 2 页起返回 503、不扣费，稍后重试可拿到整页。 |
| seller | not declared | no | not declared | 卖家 userId 的兼容输入，不是卖家昵称；优先级低于 shop 和 user_id。 |
| sort | enum: best_selling / highest_price / lowest_price / new / newly_listed / popular / price_asc / price_desc / sales | no | not declared | 带 page 翻页时店铺商品的排序：popular、best_selling、sales 按销量（默认），new、newly_listed 按上新，price_asc、lowest_price 按价格从低到高，price_desc、highest_price 按价格从高到低。价格排序按商品的卖价排，返回行里的 original_price 是划线价，看起来可能不完全按顺序。不带 page 时传了不报错，但不保证按它排。 |
| user_id | not declared | no | not declared | 卖家数字 userId 的兼容输入，低于 shop 优先级，不是商品 ID。 |
| limit | integer (1–20) | no | 20 | 这次调用最多返回的条数，整数，1–20；不传按默认值，实际返回可能少于这个数。超过上限照收，按上限返回。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| 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）。 |

## Example

```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"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "taobao",
        "action": "shop",
        "params": {
            "shop": "713464357",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "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": { … }
}
```

## FAQ

### `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 和淘宝、天猫商品链接。

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=taobao
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
