{"openapi":"3.2.0","info":{"title":"Alibaba API","description":"Search for products on Alibaba.com and retrieve detailed product information, prices, images, descriptions, specifications, supplier data, and available variants. Integrate Alibaba product data into online stores, catalog import tools, and B2B sourcing applications.","version":"1.0.0"},"servers":[{"url":"https://setalabs-alibaba.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"x-agent-commerce":{"catalog_url":"https://setalabs-alibaba.jojapi.net/_jojapi/agent/plans","discovery_url":"https://setalabs-alibaba.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/alibaba-api","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/catalog":{"get":{"operationId":"get_catalog","summary":"Get EBay Alibaba Tree","description":"Returns the complete hierarchy of Alibaba 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 Alibaba  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 Alibaba Product Details","description":"Returns detailed information about a Alibaba 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 Alibaba 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 Alibaba Products","description":"Searches for products on Alibaba 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 Alibaba 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":"Number of products to return per page.","required":true,"schema":{"type":"integer","example":24}}]}},"/seller/{id}":{"get":{"operationId":"get_seller_id","summary":"Get Alibaba Seller Details","description":"Returns detailed information about a Alibaba 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."}}}}