Taobao API: Search products (v1)

Get the top 20 Taobao and Tmall listings for a keyword, with CNY prices, shop and category, plus Taobao's result count, brands and filters.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

keyword*string

Product keyword, best in Chinese. Taobao publishes pages for common keywords only; a keyword without one returns an empty items with total_results: null.

Length1 <= length <= 100

curl -X GET "https://example.com/v1/taobao/search?keyword=%E8%93%9D%E7%89%99%E8%80%B3%E6%9C%BA" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "keyword": "string",    "page_keyword": "string",    "total_results": 61866,    "category_path": [      {        "category_id": "50005050",        "name": "蓝牙耳机"      }    ],    "brands": [      {        "brand_id": "string",        "name": "string",        "count": 0      }    ],    "filters": [      {        "property_id": "string",        "name": "string",        "values": [          {            "value_id": "string",            "name": "string"          }        ]      }    ],    "items": [      {        "item_id": "1079352038299",        "title": "string",        "url": "https://item.taobao.com/item.htm?id=1079352038299",        "image": "string",        "price": 118,        "original_price": 0,        "currency": "CNY",        "price_hkd": 140.56,        "price_twd": 583.81,        "price_label": "优惠价",        "selling_points": [          "string"        ],        "shop_id": "string",        "shop_name": "string",        "category_id": "string",        "root_category_id": "string",        "free_shipping": true,        "area_limit": true,        "description_match_score": 4.8,        "review_tags": [          {            "tag": "string",            "count": 0          }        ]      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}