{
  "openapi": "3.0.0",
  "info": {
    "title": "亚马逊商品搜索 API (V1)",
    "version": "1.0.0",
    "description": "通过关键词或ASIN搜索亚马逊商品列表，包括标题、价格、评分、Prime标志、商品图片、配送详情和分页元数据，用于发现、目录丰富、市场研究、价格监控和竞争对手分析。"
  },
  "servers": [
    {
      "url": "https://api.justoneapi.com",
      "description": "prod-global（默认）"
    },
    {
      "url": "http://47.117.133.51:30015",
      "description": "prod-cn（中国大陆地区可选）"
    }
  ],
  "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": "Amazon Country",
              "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": "Amazon Sort By",
              "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": "Amazon Product Condition",
              "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": "Amazon Deals And Discounts",
              "enum": [
                "NONE",
                "ALL_DISCOUNTS",
                "TODAYS_DEALS"
              ]
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "用于分页的页码。",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "好的",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "0",
                        "100",
                        "101",
                        "202",
                        "300",
                        "301",
                        "302",
                        "303",
                        "400",
                        "500",
                        "600",
                        "601"
                      ]
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object"
                    },
                    "recordTime": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          }
        },
        "x-order": "29000900",
        "x-api-version": "v1",
        "x-highlights": []
      }
    }
  },
  "components": {}
}