EveryData platform API
Taobao API
Taobao offers the 5 declared views used here for Taobao products, product details, shops, buyer reviews, and product questions, and `search`, `product_detail`, `shop` must each be read according to its own contract.
Taobao keeps `search` (matching public results) apart from `product_detail` (one product record); `keyword`, and `url` apply only inside those contracts.
- Endpoint
- POST /api/v1/social
- Capabilities
- 5
- Per 1,000
- $1.389
Available capabilities
Compare the Taobao actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on Taobao. Accepts these parameters: | keyword | max_price, min_price, sort, tmall_only | Sync delivery | — | $1.39 per 1,000 requests | id · url · title · price · currency · sold_count · rating · rating_scale · location · shop_name · image_url · stock · platform |
product_detailProduct details Retrieve product details from Taobao. Accepts these parameters: | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · title · brand · price · original_price · currency · stock · sold_count · category_id · location · is_tmall · shop_name · shop_id · shipping_fee · skus · images · platform · name |
shopShop Retrieve public shop details from Taobao. Accepts these parameters: | shop | max_price, min_price, seller, sort, user_id | Sync delivery | — | $1.39 per 1,000 requests | id · url · title · price · currency · category · rating · rating_scale · good_rate · image_url · platform |
reviewsReviews Retrieve public reviews from Taobao. Accepts these parameters: | url | sort | Sync delivery | — | $1.39 per 1,000 requests | id · text · rating · rating_scale · posted_at · sku · buy_count · useful_count · author_name · images · platform |
questionsQuestions Retrieve public questions from Taobao. Accepts these parameters: | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · text · answer_count · posted_at · answers · platform · author_name |
What does each Taobao action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Taobao search parameters mean?
Search public results on Taobao. Accepts these parameters: sort, keyword, max_price, tmall_only, and min_price. Returns these fields: rating, sold_count, location, and stock.
keywordRequired- Specifies the Taobao or Tmall product search term for the search action. It does not perform an exact search by store name.
max_priceOptional- Sets the maximum item price filter for the search action in combination with min_price. It does not control SKU inventory limits.
min_priceOptional- Sets the minimum item price filter for the search action. It is not a review score filter or an API fee parameter, and whether it filters results across shared actions like shop, product_detail, reviews, or questions is unconfirmed.
sortOptional- Controls review sorting for the reviews action, accepting newest for chronological sorting and relevance for combined sorting. The shop action uses a separate internal sorting field not mapped by these values, so newest and relevance cannot be used to sort store items.Allowed values:
newestrelevance tmall_onlyOptional- Filters the search action to Tmall-only items when set to boolean true. Pass true or false; do not pass the string "false", as non-empty strings evaluate as truthy.
What do the Taobao product_detail parameters mean?
Retrieve product details from Taobao. Accepts these parameters: url. Returns these fields: currency, name, images, and stock.
urlRequired- Specifies the product URL or numeric item ID for the product_detail, reviews, and questions actions. URLs must contain a ?id= or &id= query parameter; TaoPassword tokens and shortened URLs are not automatically resolved.Taobao: Product ID and SKU TerminologyTaobao defines the product ID as the digits following id= in a product link, while an SKU describes specific attribute combinations such as color and size. Product IDs and SKUs must not be used interchangeably.Checked
What do the Taobao shop parameters mean?
Retrieve public shop details from Taobao. Accepts these parameters: sort, min_price, user_id, seller, shop, and max_price. Returns these fields: image_url, category, rating_scale, and rating.
shopRequired- Specifies the seller's numeric userId for the shop action to return items currently listed by that seller. It accepts only the numeric ID, not a store name or shop domain.
max_priceOptional- Sets the maximum item price filter for the search action in combination with min_price. It does not control SKU inventory limits.
min_priceOptional- Sets the minimum item price filter for the search action. It is not a review score filter or an API fee parameter, and whether it filters results across shared actions like shop, product_detail, reviews, or questions is unconfirmed.
sellerOptional- 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.
sortOptional- Controls review sorting for the reviews action, accepting newest for chronological sorting and relevance for combined sorting. The shop action uses a separate internal sorting field not mapped by these values, so newest and relevance cannot be used to sort store items.Allowed values:
newestrelevance user_idOptional- 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.
What do the Taobao reviews parameters mean?
Retrieve public reviews from Taobao. Accepts these parameters: sort and url. Returns these fields: author_name, posted_at, rating_scale, and buy_count.
urlRequired- Specifies the product URL or numeric item ID for the product_detail, reviews, and questions actions. URLs must contain a ?id= or &id= query parameter; TaoPassword tokens and shortened URLs are not automatically resolved.Taobao: Product ID and SKU TerminologyTaobao defines the product ID as the digits following id= in a product link, while an SKU describes specific attribute combinations such as color and size. Product IDs and SKUs must not be used interchangeably.Checked
sortOptional- Controls review sorting for the reviews action, accepting newest for chronological sorting and relevance for combined sorting. The shop action uses a separate internal sorting field not mapped by these values, so newest and relevance cannot be used to sort store items.
What do the Taobao questions parameters mean?
Retrieve public questions from Taobao. Accepts these parameters: url. Returns these fields: answers, answer_count, author_name, and posted_at.
urlRequired- Specifies the product URL or numeric item ID for the product_detail, reviews, and questions actions. URLs must contain a ?id= or &id= query parameter; TaoPassword tokens and shortened URLs are not automatically resolved.Taobao: Product ID and SKU TerminologyTaobao defines the product ID as the digits following id= in a product link, while an SKU describes specific attribute combinations such as color and size. Product IDs and SKUs must not be used interchangeably.Checked
How to use the Taobao API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"taobao","action":"search","params":{"keyword":"<keyword>"}}'
Taobao API questions
What can I retrieve with the Taobao API?
Set platform to taobao. The current catalog lists search, product details, shop, reviews, and questions. These action names identify different Taobao objects or views; they are not interchangeable search modes.
Which input starts a Taobao `search` request?
Specifies the Taobao or Tmall product search term for the search action. It does not perform an exact search by store name. Send it as keyword inside params.
Which fields can Taobao `search` return?
Its declared schema includes title, price, currency, and sold_count. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Taobao action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.