{ "openapi": "3.1.0", "info": { "title": "AliExpress Product Search API (V1)", "version": "v0", "description": "Searches AliExpress products with optional query, page, sort, category, brand, location, attribute, price, locale, region, and currency controls. Use it for product discovery, catalog research, and marketplace assortment analysis." }, "servers": [ { "url": "https://api.justoneapi.com", "description": "Global production API (default)" } ], "tags": [ { "name": "AliExpress", "description": "AliExpress marketplace product search and product detail data for commerce research and catalog analysis.", "x-platform-id": "aliexpress", "x-platform-aliases": [ "AliExpress", "AliExpress marketplace", "全球速卖通", "速卖通" ], "x-platform-detection-aliases": [ "AliExpress", "AliExpress marketplace", "全球速卖通", "速卖通" ] } ], "paths": { "/api/aliexpress/search-products/v1": { "get": { "tags": [ "AliExpress" ], "summary": "Product Search", "description": "Searches AliExpress products with optional query, page, sort, category, brand, location, attribute, price, locale, region, and currency controls. Use it for product discovery, catalog research, and marketplace assortment analysis.", "operationId": "getApiAliexpressSearchProductsV1", "parameters": [ { "name": "token", "in": "query", "description": "Authentication token for this API service.", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "description": "Product search query.", "required": false, "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "One-based page number for pagination.", "required": false, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "description": "Sort order for product search results.\n\nAvailable Values:\n- `DEFAULT`: Default result order\n- `SALES_DESC`: Sales volume, highest first\n- `PRICE_ASC`: Price, lowest first\n- `PRICE_DESC`: Price, highest first", "required": false, "schema": { "type": "string", "default": "default", "description": "AliExpress product search sort order", "enum": [ "default", "salesDesc", "priceAsc", "priceDesc", "default", "salesDesc", "priceAsc", "priceDesc" ] } }, { "name": "catId", "in": "query", "description": "Category ID used to filter product search results.", "required": false, "schema": { "type": "string" } }, { "name": "brandId", "in": "query", "description": "Brand ID used to filter product search results.", "required": false, "schema": { "type": "string" } }, { "name": "loc", "in": "query", "description": "Location filter for product search results.", "required": false, "schema": { "type": "string" } }, { "name": "switches", "in": "query", "description": "Search switches used to select optional result features.", "required": false, "schema": { "type": "string" } }, { "name": "attr", "in": "query", "description": "Product attribute filter for search results.", "required": false, "schema": { "type": "string" } }, { "name": "startPrice", "in": "query", "description": "Minimum product price filter, inclusive.", "required": false, "schema": { "type": "number", "format": "double" } }, { "name": "endPrice", "in": "query", "description": "Maximum product price filter, inclusive.", "required": false, "schema": { "type": "number", "format": "double" } }, { "name": "locale", "in": "query", "description": "Locale used for the AliExpress response.", "required": false, "schema": { "type": "string" } }, { "name": "region", "in": "query", "description": "AliExpress marketplace region.", "required": false, "schema": { "type": "string" } }, { "name": "currency", "in": "query", "description": "Currency code used for product prices.", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "400": { "description": "Invalid request parameters or body", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "401": { "description": "Invalid or inactive access token", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "429": { "description": "Request rate or daily quota limit exceeded", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "503": { "description": "Service temporarily unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "x-order": "19501000", "x-api-version": "v1", "x-search-aliases": [ "AliExpress product search API", "AliExpress keyword product finder", "AliExpress catalog search", "速卖通商品搜索", "AliExpress 关键词找商品", "速卖通商品筛选" ], "x-highlights": [], "x-endpoint-family": "aliexpress_search_products" } } } }