Temporarily unavailable

We are restoring this capability. Until then calls usually fail or return no results; failed calls and empty results are not charged.

POST

API health

24h health
24%
24h average time
32.25 s
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Temporarily unavailable

Last 24 hours

Last 30 days

List the items a Taobao seller has on sale now: up to 20 per call, or page through the shop 60 at a time. Get the struck-through price, category, a postage-included flag, main image and shop ratings; rows have no sales or review counts. shop takes the seller's numeric user ID or a shop link, not a store name.

Send POST https://api.everyinfra.com/api/v1/social with platform set to taobao and action set to shop. Price $5.56 per 1,000 requests ($0.005556 per call). Failed calls and most empty results are not charged. A few are charged; see this page's FAQ and parameter notes. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.

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.

AI prompt

#
Please help me write a data collection script with the EveryInfra Taobao Shop endpoint (taobao/shop).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to taobao and action to shop, and put the parameters inside params.
- Required parameters:
  - shop: 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.
- Optional parameters:
  - page: 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.
  - seller: 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: 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. (allowed: best_selling / highest_price / lowest_price / new / newly_listed / popular / price_asc / price_desc)
  - user_id: 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: 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. (default: 20)
- Returns a list of records. Main fields of each record: id, url, title, original_price (Original (struck-through) price), 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), image_url, shop_url (Shop link (product_detail, shop)); 17 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=taobao.
- Example request body:
{
  "platform": "taobao",
  "action": "shop",
  "params": {
    "shop": "713464357"
  }
}
- Price: $5.56 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYestaobaoPlatform identifier, fixed value.
actionbodystringYesshopCapability identifier, fixed value.
shopbody.paramsstringYes-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.
pagebody.paramsintegerNo-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.
sellerbody.paramsstringNo-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.
sortbody.paramsstring (enum)No-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.Allowed valuesbest_sellinghighest_pricelowest_pricenewnewly_listedpopularprice_ascprice_descsales
user_idbody.paramsstringNo-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.
limitbody.paramsinteger (1–20)No20The 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.

Code samples

#
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 definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

#
Captured October 24, 2026 at 18:28 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
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": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
urlLink to the record on the platform.
titleTitle. null when the platform has no titles (for example text-only posts).
original_priceOriginal (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.
currencyCurrency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency.
category_idCategory ID.
free_shippingWhether shipping is free.
shop_nameShop name.
shop_idShop ID.
seller_idSeller ID (can be missing in shop; in product_detail, some sources do not return it).
image_urlImage link. Capabilities with several images may return an image_urls array.
shop_urlShop link (product_detail, shop).
shop_logo_urlShop logo link (product_detail, shop; can be missing in shop).
shop_score_descriptionShop rating for item-as-described, on a 5-point scale.
shop_score_serviceShop rating for service, on a 5-point scale.
shop_score_deliveryShop rating for delivery, on a 5-point scale.
shop_item_countNumber of items on sale in the shop (product_detail, search, shop).
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

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.

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. Usually not charged; see the FAQ and parameter notes.

Errors

Google Analytics needs consent. Privacy