{
  "openapi": "3.0.0",
  "info": {
    "title": "Amazon Product Search API (V1)",
    "version": "1.0.0",
    "description": "Search Amazon product listings by keyword or ASIN, including title, price, rating, Prime signals, product photos, delivery details, and pagination metadata for discovery, catalog enrichment, market research, price monitoring, and competitor analysis."
  },
  "servers": [
    {
      "url": "https://api.justoneapi.com",
      "description": "prod-global (default)"
    },
    {
      "url": "http://47.117.133.51:30015",
      "description": "prod-cn (optional for Mainland China)"
    }
  ],
  "paths": {
    "/api/amazon/search-products/v1": {
      "get": {
        "tags": [
          "Amazon"
        ],
        "summary": "Product Search",
        "description": "Search Amazon product listings by keyword or ASIN, including title, price, rating, Prime signals, product photos, delivery details, and pagination metadata for discovery, catalog enrichment, market research, price monitoring, and competitor analysis.",
        "operationId": "getApiAmazonSearchProductsV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "Authentication token for this API service.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "Search keyword or ASIN to find Amazon products.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Country code for the Amazon marketplace.\n\nAvailable Values:\n- `US`: United States\n- `AU`: Australia\n- `BR`: Brazil\n- `CA`: Canada\n- `CN`: China\n- `FR`: France\n- `DE`: Germany\n- `IN`: India\n- `IT`: Italy\n- `MX`: Mexico\n- `NL`: Netherlands\n- `SG`: Singapore\n- `ES`: Spain\n- `TR`: Turkey\n- `AE`: United Arab Emirates\n- `GB`: United Kingdom\n- `JP`: Japan\n- `SA`: Saudi Arabia\n- `PL`: Poland\n- `SE`: Sweden\n- `BE`: Belgium\n- `EG`: Egypt\n- `ZA`: South Africa\n- `IE`: Ireland",
            "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": "Sort order for Amazon product search results.\n\nAvailable Values:\n- `RELEVANCE`: Relevance\n- `LOWEST_PRICE`: Lowest Price\n- `HIGHEST_PRICE`: Highest Price\n- `REVIEWS`: Reviews\n- `NEWEST`: Newest\n- `BEST_SELLERS`: 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": "Product condition filter for Amazon search results.\n\nAvailable Values:\n- `ALL`: All product conditions\n- `NEW`: New products\n- `USED`: Used products\n- `RENEWED`: Renewed products\n- `COLLECTIBLE`: Collectible products",
            "required": false,
            "schema": {
              "type": "string",
              "default": "ALL",
              "description": "Amazon Product Condition",
              "enum": [
                "ALL",
                "NEW",
                "USED",
                "RENEWED",
                "COLLECTIBLE"
              ]
            }
          },
          {
            "name": "isPrime",
            "in": "query",
            "description": "Whether to return only Prime-eligible products.",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "dealsAndDiscounts",
            "in": "query",
            "description": "Deals and discounts filter for Amazon search results.\n\nAvailable Values:\n- `NONE`: Do not filter by deals or discounts\n- `ALL_DISCOUNTS`: Return discounted products\n- `TODAYS_DEALS`: Return today's deals",
            "required": false,
            "schema": {
              "type": "string",
              "default": "NONE",
              "description": "Amazon Deals And Discounts",
              "enum": [
                "NONE",
                "ALL_DISCOUNTS",
                "TODAYS_DEALS"
              ]
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number for pagination.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "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": {}
}