{ "openapi": "3.1.0", "info": { "title": "亚马逊商品搜索 API (V1)", "version": "v0", "description": "通过关键词或ASIN，结合国家、排序、商品状况、Prime专享、优惠和分页控制搜索亚马逊市场商品。用于发现商品以进行目录研究、价格比较或竞争性品类分析。" }, "servers": [ { "url": "https://api.justoneapi.com", "description": "全球生产 API（默认）" } ], "tags": [ { "name": "亚马逊", "description": "亚马逊目录数据、评价、热销排名和分类列表，用于市场研究和数据丰富。", "x-platform-id": "amazon", "x-platform-aliases": [ "Amazon", "亚马逊" ], "x-platform-detection-aliases": [ "Amazon", "亚马逊" ] } ], "paths": { "/api/amazon/search-products/v1": { "get": { "tags": [ "亚马逊" ], "summary": "商品搜索", "description": "通过关键词或ASIN，结合国家、排序、商品状况、Prime专享、优惠和分页控制搜索亚马逊市场商品。用于发现商品以进行目录研究、价格比较或竞争性品类分析。", "operationId": "getApiAmazonSearchProductsV1", "parameters": [ { "name": "token", "in": "query", "description": "此API服务的鉴权令牌。", "required": true, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "description": "搜索关键词或ASIN以查找亚马逊商品。", "required": true, "schema": { "type": "string" } }, { "name": "country", "in": "query", "description": "亚马逊市场的国家代码。\n\n可用值：\n- `US`：美国\n- `AU`：澳大利亚\n- `BR`：巴西\n- `CA`：加拿大\n- `CN`：中国\n- `FR`：法国\n- `DE`：德国\n- `IN`：印度\n- `IT`：意大利\n- `MX`：墨西哥\n- `NL`：荷兰\n- `SG`：新加坡\n- `ES`：西班牙\n- `TR`：土耳其\n- `AE`：阿拉伯联合酋长国\n- `GB`：英国\n- `JP`：日本\n- `SA`：沙特阿拉伯\n- `PL`：波兰\n- `SE`：瑞典\n- `BE`：比利时\n- `EG`：埃及\n- `ZA`：南非\n- `IE`：爱尔兰", "required": false, "schema": { "type": "string", "default": "US", "description": "亚马逊产品的国家代码。", "enum": [ "US", "AU", "BR", "CA", "CN", "FR", "DE", "IN", "IT", "MX", "NL", "SG", "ES", "TR", "AE", "GB", "JP", "SA", "PL", "SE", "BE", "EG", "ZA", "IE" ] } }, { "name": "sortBy", "in": "query", "description": "亚马逊商品搜索结果的排序方式。\n\n可用值：\n- `RELEVANCE`：相关性\n- `LOWEST_PRICE`：最低价\n- `HIGHEST_PRICE`：最高价\n- `REVIEWS`：评论数\n- `NEWEST`：最新\n- `BEST_SELLERS`：热销商品", "required": false, "schema": { "type": "string", "default": "RELEVANCE", "description": "排序方式。", "enum": [ "RELEVANCE", "LOWEST_PRICE", "HIGHEST_PRICE", "REVIEWS", "NEWEST", "BEST_SELLERS" ] } }, { "name": "productCondition", "in": "query", "description": "亚马逊搜索结果的商品状况筛选。\n\n可用值：\n- `ALL`：所有商品状况\n- `NEW`：全新商品\n- `USED`：二手商品\n- `RENEWED`：翻新商品\n- `COLLECTIBLE`：收藏品", "required": false, "schema": { "type": "string", "default": "ALL", "description": "亚马逊搜索结果的商品状况筛选。", "enum": [ "ALL", "NEW", "USED", "RENEWED", "COLLECTIBLE" ] } }, { "name": "isPrime", "in": "query", "description": "是否仅返回Prime合格商品。", "required": false, "schema": { "type": "boolean", "default": false } }, { "name": "dealsAndDiscounts", "in": "query", "description": "亚马逊搜索结果的优惠和折扣筛选。\n\n可用值：\n- `NONE`：不按优惠或折扣筛选\n- `ALL_DISCOUNTS`：返回折扣商品\n- `TODAYS_DEALS`：返回今日特惠", "required": false, "schema": { "type": "string", "default": "NONE", "description": "亚马逊搜索结果的优惠和折扣筛选。", "enum": [ "NONE", "ALL_DISCOUNTS", "TODAYS_DEALS" ] } }, { "name": "page", "in": "query", "description": "用于分页的页码。", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } } ], "responses": { "200": { "description": "好的", "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": "请求参数或请求体无效", "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": "访问令牌无效或未激活", "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": "权限不足", "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": "请求速率或每日配额已超限", "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": "服务器内部错误", "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": "服务暂时不可用", "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": "29000900", "x-api-version": "v1", "x-search-aliases": [ "Amazon product search API", "Amazon keyword or ASIN search", "Amazon marketplace product finder", "亚马逊商品搜索", "亚马逊关键词找商品", "亚马逊 ASIN 商品查询" ], "x-highlights": [], "x-endpoint-family": "amazon_search_products" } } } }