# Taobao Shop API (taobao.shop)

- Canonical page: https://everyinfra.com/en/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

Taobao Shop lists products one seller has on sale, given the seller's numeric user ID or a shop link in `shop`. Without `page`, each request returns at most 20 products; with `page`, you can page through the shop, usually 60 products per page, up to page 35. Each row carries the product title, link, struck-through price and currency, category ID, a free-shipping flag and main image, along with the shop name, shop ID, seller ID, the shop's three ratings and its total item count. Use it to sample what a competitor sells or to check which products a brand's reseller lists.

`original_price` is the struck-through price the listing shows, not the selling price, and it can be well above it; for the selling price, pass the product to Taobao Product details. Rows have no sales or review counts. `shop_item_count` is usually far above the 20 rows of a single request; page with `page` to get more. For large shops, each sort order reaches at most about the first 2,060 products.

## 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 | Specifies the seller's numeric userId (sellerId) or a shop link (shop<shopId>.taobao.com) for the shop action. Returns items that seller has on sale. Without page, each request returns at most 20: a larger limit still returns 20, at the same price per call. With page, it goes through the shop one Taobao page at a time, usually 60 items per page. It is not a store name. Repeat requests for the same shop with the same sort and the same page (or the same limit when you send no page) within 12 hours return the same data as the first one, and are charged as usual. When the shop does not exist, the result is empty with empty_reason shop_not_found and the request is charged as one call; a repeat within 24 hours returns the same result and is charged the same way. Other empty results are not charged. |
| page | integer | no | not declared | Page number of the shop's item list, from 1 to 35. With `page`, you get whole Taobao shop pages: usually 60 items per page and fewer on the last, and `limit` has no effect. Without `page`, the call is a single fetch of up to 20 items, as before. Each page is billed as one call at the same price; a page past the last one returns an empty result and is not charged, so an empty page means you have reached the end. Taobao lists at most about the first 2,060 items per sort order (page 35), so shops with more items cannot be read in full; another `sort` returns a different part of the catalog. Keep the same `sort` on every page. Rankings update in real time, so neighbouring pages can occasionally repeat a few items; dedupe by `id` when merging pages. A page usually takes 10 to 45 seconds, and up to about 60 seconds when it has to be retried. Sometimes page 1 returns at most the first 20 items; the response then has `partial: true` at the top level and still counts as one billed call. While that happens, page 2 and later return 503 and are not charged; try again later to get the full page. |
| seller | not declared | no | not declared | Provides a compatibility fallback for the seller's numeric userId in the shop action. It accepts only numeric user IDs, not seller nicknames, and takes lower precedence than shop and user_id. |
| sort | enum: best_selling / highest_price / lowest_price / new / newly_listed / popular / price_asc / price_desc / sales | no | not declared | Item order when paging with `page`: `popular`, `best_selling` or `sales` by sales (default); `new` or `newly_listed` by newest listing; `price_asc` or `lowest_price` by price, low to high; `price_desc` or `highest_price` by price, high to low. Price orders follow the selling price, while rows carry `original_price` (the struck-through price), so they may not look perfectly ordered. Without `page`, sort is accepted but not guaranteed to take effect. |
| user_id | not declared | no | not declared | Provides a compatibility fallback for the seller's numeric userId in the shop action. It takes lower precedence than shop and cannot be used as a product ID. |
| limit | integer (1–20) | no | 20 | The most rows to return in this call, an integer from 1 to 20. The default applies when you leave it out, and a call can return fewer rows. Larger values are accepted and capped at the maximum. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| original_price | Original (struck-through) price. In product_detail it is empty on most calls. In shop it is the only price: the struck-through figure the listing shows, not the selling price, and it can be well above it; use product_detail for the selling price. |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| category_id | Category ID. |
| free_shipping | Whether shipping is free. |
| shop_name | Shop name. |
| shop_id | Shop ID. |
| seller_id | Seller ID (can be missing in shop; in product_detail, some sources do not return it). |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| shop_url | Shop link (product_detail, shop). |
| shop_logo_url | Shop logo link (product_detail, shop; can be missing in shop). |
| shop_score_description | Shop rating for item-as-described, on a 5-point scale. |
| shop_score_service | Shop rating for service, on a 5-point scale. |
| shop_score_delivery | Shop rating for delivery, on a 5-point scale. |
| shop_item_count | Number of items on sale in the shop (product_detail, search, shop). |
| platform | Source platform identifier, the same as platform in the request (for example 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

### What value goes in `shop`?

The seller's numeric user ID on Taobao, a string of digits like the one in the example on this page, or a shop link in the form `shop<shopId>.taobao.com`. The shop's name and product IDs do not identify a seller here. `user_id` and `seller` are older spellings of the same input; when several are sent, `shop` takes priority, then `user_id`. When the shop does not exist, the result is empty and the request is charged as one call.

### How many products can I get, and can I sort or page?

Without `page`, at most 20 per request: a larger `limit` is accepted and still returns 20, at the same price per call, and `sort` is accepted but not guaranteed to take effect. With `page` (1 to 35), you get whole Taobao shop pages, usually 60 products each, billed as one call per page, and `sort` applies; keep the same `sort` on every page. An empty page means you have reached the end and is not charged. Each sort order reaches at most about the first 2,060 products, so for larger shops another `sort` returns a different part of the catalog; dedupe by `id` when merging.

### How do I get the selling price or full details for a listed product?

Pass the row's `id`, the numeric product ID, or its `url` to the Taobao Product details capability for prices, variants, coupon prices and description images, or to Taobao Reviews for buyer feedback. Both take either form, the numeric ID or a product page link on Taobao or Tmall.

## 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
