{"openapi":"3.2.0","info":{"title":"Taobao and TMall API","description":"Search Taobao and Tmall products and retrieve detailed product information, prices, images, seller data, specifications, and SKU variants for e-commerce integrations.","version":"1.0.0"},"servers":[{"url":"https://setalabs.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"x-agent-commerce":{"catalog_url":"https://setalabs.jojapi.net/_jojapi/agent/plans","discovery_url":"https://setalabs.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/api-taobao-tmall","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/catalog":{"get":{"operationId":"get_catalog","summary":"Get Taobao Category Tree","description":"Returns the complete hierarchy of Taobao product categories, including parent categories and subcategories.","responses":{"200":{"description":"Successful response"}},"parameters":[{"name":"language","in":"query","description":"The language in which the API response data will be returned.","required":false,"schema":{"type":"string","example":"en"}}]}},"/langs":{"get":{"operationId":"get_langs","summary":"Get Supported Languages","description":"Returns the list of languages supported by the Taobao API. Use a language code from this list as the language parameter to specify the response language.","responses":{"200":{"description":"Successful response"}}}},"/product/{id}":{"get":{"operationId":"get_product_id","summary":"Get Taobao Product Details","description":"Returns detailed information about a Taobao product by its ID, including seller information, SKU variants and attributes, and the product description.","responses":{"200":{"description":"Successful response"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"language","in":"query","description":"The language in which the API response data will be returned.","required":false,"schema":{"type":"string","example":"en"}}]}},"/reviews/{id}":{"get":{"operationId":"get_reviews_id","summary":"Get Product Reviews","description":"Returns customer reviews for a Taobao or Tmall product by its ID.","responses":{"200":{"description":"Successful response"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"language","in":"query","description":"The language in which the API response data will be returned.","required":false,"schema":{"type":"string","example":"en"}}]}},"/search":{"get":{"operationId":"get_search","summary":"Search Taobao Products","description":"Searches for products on Taobao and returns matching results based on the specified search parameters.","responses":{"200":{"description":"Successful response"}},"parameters":[{"name":"category_id","in":"query","description":"Filters products by category ID.","required":false,"schema":{"type":"string"}},{"name":"text","in":"query","description":"Search query used to find matching products.","required":false,"schema":{"type":"string"}},{"name":"vendor_name","in":"query","description":"Filters products by seller name.","required":false,"schema":{"type":"string"}},{"name":"price_min","in":"query","description":"Minimum product price.","required":false,"schema":{"type":"number"}},{"name":"price_max","in":"query","description":"Maximum product price.","required":false,"schema":{"type":"number"}},{"name":"volume_min","in":"query","description":"Minimum product sales volume.","required":false,"schema":{"type":"integer"}},{"name":"volume_max","in":"query","description":"Maximum product sales volume.","required":false,"schema":{"type":"integer"}},{"name":"sort","in":"query","description":"Sort order for the search results. Available values: default, price, -price, total_price, -total_price, volume, -volume, vendor_rating, -vendor_rating, updated_time, -updated_time. Prefix a value with - to sort in descending order.","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Page number of the search results to retrieve.","required":true,"schema":{"type":"integer","example":1}},{"name":"limit","in":"query","description":"Number of products to return per page.","required":true,"schema":{"type":"integer","example":24}},{"name":"language","in":"query","description":"The language in which the API response data will be returned.","required":false,"schema":{"type":"string","example":"en"}}]}},"/search_img":{"get":{"operationId":"get_search_img","summary":"Search Products by Image","description":"Searches for visually similar products on Taobao and Tmall using the provided image.","responses":{"200":{"description":"Successful response"}},"parameters":[{"name":"language","in":"query","description":"The language in which the API response data will be returned.","required":false,"schema":{"type":"string","example":"en"}},{"name":"image_url","in":"query","description":"URL of the image used to find visually similar products.","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Page number of the search results to retrieve.","required":true,"schema":{"type":"integer","example":1}},{"name":"limit","in":"query","description":"integer (query) Number of requested elements from the entire list.","required":true,"schema":{"type":"integer","example":24}}]}},"/seller/{id}":{"get":{"operationId":"get_seller_id","summary":"Get Taobao Seller Details","description":"Returns detailed information about a Taobao seller by their ID.","responses":{"200":{"description":"Successful response"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"language","in":"query","description":"The language in which the API response data will be returned.","required":false,"schema":{"type":"string","example":"en"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}