Product Search API v1 model

{
  "swagger": "2.0",
  "info": {
    "description": "An API for getting data about products available to Amazon Business customers. This includes information such as the product title, the merchant selling the product, and the current price.",
    "license": {
      "name": "Amazon Software License",
      "url": "https://aws.amazon.com/asl/"
    },
    "title": "Amazon Business API for Products",
    "version": "2020-08-26"
  },
  "externalDocs": {
    "description": "Learn more about the Amazon Business API",
    "url": "http://business-api.amazon.com"
  },
  "host": "api.business.amazon.com",
  "schemes": [
    "https"
  ],
  "paths": {
    "/products/2020-08-26/products": {
      "get": {
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "description": "A list of keywords to use to find products based on indexed text data.",
            "in": "query",
            "name": "keywords",
            "required": false,
            "type": "string"
          },
          {
            "description": "The region where you wish to purchase the product.",
            "enum": [
              "DE",
              "FR",
              "UK",
              "US",
              "JP"
            ],
            "in": "query",
            "name": "productRegion",
            "required": true,
            "type": "string"
          },
          {
            "description": "This field determines the region where to ship the product based on the value in the shippingPostalCode.",
            "in": "query",
            "name": "shippingRegion",
            "required": false,
            "type": "string"
          },
          {
            "description": "The locale of the request, in the form of an IETF language tag. Each ProductRegion supports one or more locales. This value should comply with java.util.Locale.",
            "pattern": "^[-_]+$",
            "in": "query",
            "name": "locale",
            "required": true,
            "type": "string"
          },
          {
            "description": "The shipping postal/zip code for customer's request. This parameter doesn't hold geocode.",
            "in": "query",
            "name": "shippingPostalCode",
            "required": false,
            "type": "string"
          },
          {
            "collectionFormat": "csv",
            "description": "A list of data facets to include in the response. If you include more than one facet in your request separate each facet value with a comma.",
            "in": "query",
            "enum": [
              "OFFERS",
              "IMAGES"
            ],
            "name": "facets",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-example": "/path?facets=FOO,BAR"
          },
          {
            "description": "The zero-based number of the page being requested. If not specified, a default value of 0 will be used. When passed, the value must be equal or greater than zero, and strictly less than the number of pages returned in the response.",
            "in": "query",
            "name": "pageNumber",
            "required": false,
            "type": "integer"
          },
          {
            "description": "The number of items desired in SearchProductsResult response. If not specified, a default value of 24 will be used. Maximum items that can be fetched in single request is 24.",
            "in": "query",
            "name": "pageSize",
            "required": false,
            "type": "integer"
          },
          {
            "description": "Group identifier to determine on behalf of which group a customer is performing this operation. This can be found in your Amazon Business account information. Only necessary if the customer account belongs to more than one group.",
            "in": "query",
            "name": "groupTag",
            "required": false,
            "type": "string"
          },
          {
            "description": "The category is used to refine the keyword search results, a keyword search can give results across multiple categories, if category is provided in request, search results will be limited to given category. It is an optional parameter if not provided in request then search results will be across all possible categories the requested keyword belongs.",
            "in": "query",
            "name": "category",
            "required": false,
            "type": "string"
          },
          {
            "description": "The search subcategory is used to refine the keyword search results, a keyword search within a particular category can give results across multiple subcategories, if subcategory is provided in request, search results will be limited to given subcategory. It is a optional parameter if not provided in request then search results will be across a particular category if category is provided otherwise results will be across all categories the requested keyword belongs.",
            "in": "query",
            "name": "subCategory",
            "required": false,
            "type": "string"
          },
          {
            "description": "The availability is used to refine the keyword search results. It is optional and by default, the search should return the results with the option in stock only. So in the returned result refinement part, there should be two availability Ids. One represents the in stock only, and one represents the include out of stock. If user set availability as include out of stock Id, the result will return products including both in stock and out of stock, which also should be shown in products offers. Same logic applies when user set availability equal to in stock only Id. If a random availability id number is provided, the search should return zero matching products.",
            "in": "query",
            "name": "availability",
            "required": false,
            "type": "string"
          },
          {
            "description": "The deliveryDay feature is used to refine the keyword search results. It is optional and by default, the search should return the results with all the available delivery dates. In the returned result refinement part, there should be one Get It Today ID, and one Get It Tomorrow ID. If the user set the deliveryDay with Get It Today ID, then it should return the products that could arrive today, or nothing if no product could arrive today. Same logic goes with Get It Tomorrow ID.",
            "in": "query",
            "name": "deliveryDay",
            "required": false,
            "type": "string"
          },
          {
            "description": "The eligibleForFreeShipping is used to refine the keyword search results. It is optional and by default, the search should return the results with both free shipping by Amazon as well as not free Shipping by Amazon. So in the returned result refinement part, there should be one eligibleForFreeShipping Id. It represents Free Shipping by Amazon. If the user set the eligibleForFreeShipping as this ID, then the result will only return the products who will have free shipping by Amazon.",
            "in": "query",
            "name": "eligibleForFreeShipping",
            "required": false,
            "type": "string"
          },
          {
            "description": "The prime eligible refinement can be used to filter prime-eligible products. By default, all products (including non-prime eligible) will be returned.",
            "in": "query",
            "name": "primeEligible",
            "required": false,
            "type": "string"
          },
          {
            "description": "UPC (Universal Product Code) is a type of code printed on retail product packaging to aid in identifying a particular item",
            "in": "query",
            "name": "upc",
            "required": false,
            "type": "string"
          },
          {
            "description": "International Standard Book Number of the product",
            "in": "query",
            "name": "isbn",
            "required": false,
            "type": "string"
          },
          {
            "description": "A SKU short for Stock Keeping Unit is a merchant specific identifier for a purchasable good",
            "in": "query",
            "name": "sku",
            "required": false,
            "type": "string"
          },
          {
            "description": "EAN (European Article Number) is a 13-digit product identifier, often represented on products as a barcode",
            "in": "query",
            "name": "ean",
            "required": false,
            "type": "string"
          },
          {
            "description": "value of the Part Number field on the product. It is a unique number that is issued by manufacturers to identify individual products.",
            "in": "query",
            "name": "partNumber",
            "required": false,
            "type": "string"
          },
          {
            "description": "The OEM Part Number is the original part number assigned to this part by the vehicle manufacturer.",
            "in": "query",
            "name": "oemPartNumber",
            "required": false,
            "type": "string"
          },
          {
            "collectionFormat": "csv",
            "description": "A list of search refinements to refine keyword search for relevant results. If you include more than one search refinement in your request separate each refinement value with a comma.",
            "in": "query",
            "name": "searchRefinements",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-example": "brandtextbin#GE,brandtextbin#Sony,review-rating#2661618011"
          },
          {
            "description": "Email address of the user requesting this resource",
            "in": "header",
            "name": "x-amz-user-email",
            "required": true,
            "type": "string"
          },
          {
            "collectionFormat": "csv",
            "description": "A list specifying the product fields you want to be included in your response object. If you do not include this query parameter then all inclusions will be returned.",
            "enum": [
              "ALL",
              "bookInformation",
              "byLine",
              "customerReviewsSummary",
              "editorialReviews",
              "features",
              "format",
              "mediaInformation",
              "productDescription",
              "productDetails",
              "productOverview",
              "productVariations",
              "taxonomies",
              "title"
            ],
            "in": "query",
            "name": "inclusionsForProducts",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-example": "/path?inclusionsForProducts=FOO,BAR"
          },
          {
            "collectionFormat": "csv",
            "description": "A list specifying the offer fields you want to be included in your response object. If you do not include this query parameter then all inclusions will be returned.",
            "enum": [
              "ALL",
              "availability",
              "buyingGuidance",
              "buyingRestrictions",
              "condition",
              "fulfillmentType",
              "merchant",
              "price",
              "productCondition",
              "productConditionNote",
              "quantityLimits",
              "quantityPrice",
              "taxExclusivePrice",
              "deliveryInformation",
              "listPrice",
              "shippingOptions"
            ],
            "in": "query",
            "name": "inclusionsForOffers",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-example": "/path?inclusionsForOffers=FOO,BAR"
          }
        ],
        "responses": {
          "200": {
            "description": "Search success",
            "schema": {
              "$ref": "#/definitions/SearchProductsResult"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            },
            "x-amazon-spds-sandbox-behaviors": [
              {
                "request": {
                  "parameters": {
                    "productRegion": {
                      "value": "US"
                    },
                    "locale": {
                      "value": "es_US"
                    },
                    "facets": {
                      "value": [
                        "OFFERS"
                      ]
                    },
                    "keywords": {
                      "value": "[keyword]"
                    }
                  }
                },
                "response": {
                  "matchingProductCount": 1,
                  "numberOfPages" : 1,
                  "refinements": {
                    "categories": [
                      {
                        "id": "[categoryId]",
                        "displayName": "[categoryDisplayName]"
                      }
                    ],
                    "subCategories": [],
                    "availabilityOptions": [
                      {
                        "id": "[availabilityOptionId]",
                        "displayName": "[availabilityOptionDisplayName]"
                      }
                    ],
                    "deliveryDayOptions": [
                      {
                        "id": "[deliveryDayOptionId]",
                        "displayName": "[deliveryDayOptionDisplayName]"
                      }
                    ],
                    "eligibleForFreeShippingOptions": [
                      {
                        "id": "[eligibleForFreeShippingOptionId]",
                        "displayName": "[availabilityOptionDisplayName]"
                      }
                    ],
                    "primeEligible": [
                      {
                        "id": "[primeEligibleId]",
                        "displayName": "[primeEligibleDisplayName]"
                      }
                    ]
                  },
                  "products": [
                    {
                      "asin": "[asin]",
                      "asinType": "STANDARD",
                      "signedProductId": "[signedProductId]",
                      "title": "[asinTitle]",
                      "features": [ "[feature1]" ],
                      "editorialReviews": [
                        {
                          "content": "[editorialReviewContent]",
                          "source": "[editorialReviewSource]"
                        }
                      ],
                      "taxonomies": [
                        {
                          "title": "[taxonomyTitle]",
                          "taxonomyCode": "[taxonomyCode]",
                          "type": "UNSPSC"
                        }
                      ],
                      "format": "[format]",
                      "bookInformation": [
                        {
                          "isbn": [
                            {
                              "isbn10": "[isbn10]",
                              "isbn13": "[isbn13]"
                            }
                          ],
                          "publishedDate": "[publishedDate]",
                          "publicationLanguage": "[publicationLanguage]"
                        }
                      ],
                      "byLine": [
                        {
                          "name": "[name]",
                          "roles": [
                            "[role1]"
                          ]
                        }
                      ],
                      "mediaInformation": [
                        {
                          "editions": ["edition1"],
                          "mediaFormats": ["mediaFormat1"]
                        }
                      ],
                      "productOverview": {
                        "[attributeKey1]": "[attributeValue1]"
                      },
                      "productDetails": {
                        "[attributeKey1]": {
                          "[attributeKey1]": "[attributeValue1]"
                        }
                      },
                      "productVariations": {
                        "dimensions": [
                          {
                            "index": 0,
                            "displayString": "[dimensionKeys]",
                            "dimensionValues": [
                              {
                                "index": 0,
                                "displayString": "[value]"
                              }
                            ]
                          }
                        ],
                        "variations": [
                          {
                            "asin": "[asin]",
                            "variationValues": [
                              {
                                "index": 0,
                                "value": "[value]"
                              }
                            ]
                          }
                        ]
                      },
                      "customerReviewsSummary": {
                        "numberOfReviews": 1,
                        "starRating": 5.0
                      },
                      "productDescription": "[productDescription]",
                      "url": "[url]",
                      "includedDataTypes": {
                        "OFFERS": [
                          {
                            "offerId": "[offerId]",
                            "merchant": {
                              "merchantId": "[merchantId]",
                              "name": "[merchantName]",
                              "meanFeedbackRating": 5.0,
                              "totalFeedbackCount": 1
                            },
                            "price": {
                              "value": {
                                "amount": 1.00,
                                "currencyCode": "USD"
                              },
                              "formattedPrice": "[formattedPrice]",
                              "priceType": "NEW"
                            },
                            "listPrice": {
                              "value": {
                                "amount": 2.00,
                                "currencyCode": "USD"
                              },
                              "formattedPrice": "[formattedPrice]",
                              "priceType": "NEW"
                            },
                            "taxExclusivePrice": {
                              "taxExclusiveAmount": {
                                "amount": 1.00,
                                "currencyCode": "USD"
                              },
                              "formattedPrice": "[formattedPrice]",
                              "displayString": "[taxExclusivePriceDisplayString]",
                              "label": "Sin IVA"
                            },
                            "quantityLimits": {
                              "minQuantity": 1,
                              "maxQuantity": 30
                            },
                            "productCondition": "NEW",
                            "productConditionNote": "[productConditionNote]",
                            "condition": {
                              "conditionValue": "NEW",
                              "conditionNote" : "[productConditionNote]",
                              "subCondition" : "ACCEPTABLE"
                            },
                            "availability": "[availability]",
                            "fulfillmentType": "AMAZON",
                            "buyingGuidance": "NONE",
                            "buyingRestrictions": [],
                            "shippingOptions": [
                              {
                                "shippingCost": {
                                  "value": {
                                    "amount": 9.00,
                                    "currencyCode": "USD"
                                  }
                                },
                                "deliveryRange":
                                {
                                  "max": "2022-01-01T00:00:01.000Z",
                                  "min": "2022-01-01T00:00:01.000Z"
                                }
                              }
                            ]
                          }
                        ]
                      }
                    }
                  ]
                }
              }
            ]
          },
          "400": {
            "description": "The service was unable to process the request. Reasons for the error are described in an error response object.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            },
            "x-amazon-spds-sandbox-behaviors": [
              {
                "request": {
                  "parameters": {
                    "productRegion": {
                      "value": "US"
                    },
                    "keywords": {
                      "value": "pen"
                    },
                    "facets": {
                      "values": [
                        "OFFERS",
                        "IMAGES"
                      ]
                    }
                  }
                },
                "response": {
                  "errors": [
                    {
                      "code": "INVALID_REQUEST_PARAMETER",
                      "message": "Missing required request parameters: [locale]"
                    }
                  ]
                }
              }
            ]
          },
          "401": {
            "description": "The request's Authorization header is not formatted correctly or does not contain a valid authorization input.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "403": {
            "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "404": {
            "description": "The resource specified does not exist.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "429": {
            "description": "The frequency of requests was greater than allowed.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "500": {
            "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "503": {
            "description": "Temporary overloading or maintenance of the server.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          }
        },
        "tags": [
          "search"
        ],
        "description": "Search for a list of products by querying on their attributes and indexed fields.",
        "operationId": "searchProductsRequest",
        "summary": "Search for a list products by keyword, and by other additional filter criteria."
      }
    },
    "/products/2020-08-26/products/{productId}": {
      "get": {
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "description": "The Amazon Standard Item Identifier (ASIN) for the product.",
            "in": "path",
            "name": "productId",
            "required": true,
            "type": "string"
          },
          {
            "description": "The region where you wish to purchase the product.",
            "enum": [
              "DE",
              "FR",
              "UK",
              "IT",
              "ES",
              "US",
              "CA",
              "JP"
            ],
            "in": "query",
            "name": "productRegion",
            "required": true,
            "type": "string"
          },
          {
            "description": "This field determines the region where to ship the product based on the value in the shippingPostalCode.",
            "in": "query",
            "name": "shippingRegion",
            "required": false,
            "type": "string"
          },
          {
            "description": "The locale of the request, in the form of an IETF language tag. Each ProductRegion supports one or more locales. This value should comply with java.util.Locale.",
            "pattern": "^[-_]+$",
            "in": "query",
            "name": "locale",
            "required": true,
            "type": "string"
          },
          {
            "description": "The shipping postal/zip code for customer's request. This parameter does not support geocode.",
            "in": "query",
            "name": "shippingPostalCode",
            "required": false,
            "type": "string"
          },
          {
            "description": "The number of units the customer intends to purchase. This helps  Amazon to determine quantity-based discounts if an eligible offer is present. Defaults to 1.",
            "in": "query",
            "name": "quantity",
            "required": false,
            "type": "integer",
            "default": 1
          },
          {
            "collectionFormat": "csv",
            "description": "A list of data facets to include in the response. If you include more than one facet in your requst separate each facet value with a comma.",
            "in": "query",
            "enum": [
              "OFFERS",
              "IMAGES"
            ],
            "name": "facets",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-example": "/path?facets=FOO,BAR"
          },
          {
            "description": "Email address of the user requesting this resource",
            "in": "header",
            "name": "x-amz-user-email",
            "required": true,
            "type": "string"
          },
          {
            "collectionFormat": "csv",
            "description": "A list specifying the product fields you want to be included in your response object. If you do not include this query parameter then all inclusions will be returned.",
            "enum": [
              "ALL",
              "bookInformation",
              "byLine",
              "customerReviewsSummary",
              "editorialReviews",
              "features",
              "format",
              "mediaInformation",
              "productDescription",
              "productDetails",
              "productOverview",
              "productVariations",
              "taxonomies",
              "title"
            ],
            "in": "query",
            "name": "inclusionsForProducts",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-example": "/path?inclusionsForProducts=FOO,BAR"
          },
          {
            "collectionFormat": "csv",
            "description": "A list specifying the offer fields you want to be included in your response object. If you do not include this query parameter then all inclusions will be returned.",
            "enum": [
              "ALL",
              "availability",
              "buyingGuidance",
              "buyingRestrictions",
              "condition",
              "fulfillmentType",
              "merchant",
              "price",
              "productCondition",
              "productConditionNote",
              "quantityLimits",
              "quantityPrice",
              "taxExclusivePrice",
              "deliveryInformation",
              "listPrice",
              "shippingOptions"
            ],
            "in": "query",
            "name": "inclusionsForOffers",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-example": "/path?inclusionsForOffers=FOO,BAR"
          },
          {
            "description": "Group identifier to determine on behalf of which group a customer is performing this operation. This can be found in your Amazon Business account information. Only necessary if the customer account belongs to more than one group.",
            "in": "query",
            "name": "groupTag",
            "required": false,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "Product successfully retrieved",
            "schema": {
              "$ref": "#/definitions/ProductsResult"
            },
            "x-amzn-RateLimit-Limit": {
              "description": "Your rate limit (requests per second) for this operation.",
              "type": "string"
            },
            "x-amzn-requestid": {
              "description": "Unique request reference identifier.",
              "type": "string"
            },
            "x-amazon-spds-sandbox-behaviors": [
              {
                "request": {
                  "parameters": {
                    "productId": {
                      "value": "[productId]"
                    },
                    "productRegion": {
                      "value": "US"
                    },
                    "locale": {
                      "value": "es_US"
                    },
                    "facets": {
                      "value": [
                        "OFFERS"
                      ]
                    },
                    "shippingPostalCode": {
                      "value": "99999"
                    }
                  }
                },
                "response": {
                  "asin": "[asin]",
                  "asinType": "STANDARD",
                  "signedProductId": "[signedProductId]",
                  "title": "[asinTitle]",
                  "features": [ "[feature1]" ],
                  "editorialReviews": [
                    {
                      "content": "[editorialReviewContent]",
                      "source": "[editorialReviewSource]"
                    }
                  ],
                  "taxonomies": [
                    {
                      "title": "[taxonomyTitle]",
                      "taxonomyCode": "[taxonomyCode]",
                      "type": "UNSPSC"
                    }
                  ],
                  "format": "[format]",
                  "bookInformation": [
                    {
                      "isbn": [
                        {
                          "isbn10": "[isbn10]",
                          "isbn13": "[isbn13]"
                        }
                      ],
                      "publishedDate": "[publishedDate]",
                      "publicationLanguage": "[publicationLanguage]"
                    }
                  ],
                  "byLine": [
                    {
                      "name": "[name]",
                      "roles": [
                        "[role1]"
                      ]
                    }
                  ],
                  "mediaInformation": [
                    {
                      "editions": ["edition1"],
                      "mediaFormats": ["mediaFormat1"]
                    }
                  ],
                  "productOverview": {
                    "[attributeKey1]": "[attributeValue1]"
                  },
                  "productDetails": {
                    "[attributeKey1]": {
                      "[attributeKey1]": "[attributeValue1]"
                    }
                  },
                  "productVariations": {
                    "dimensions": [
                      {
                        "index": 0,
                        "displayString": "[dimensionKeys]",
                        "dimensionValues": [
                          {
                            "index": 0,
                            "displayString": "[value]"
                          }
                        ]
                      }
                    ],
                    "variations": [
                      {
                        "asin": "[asin]",
                        "variationValues": [
                          {
                            "index": 0,
                            "value": "[value]"
                          }
                        ]
                      }
                    ]
                  },
                  "customerReviewsSummary": {
                    "numberOfReviews": 1,
                    "starRating": 5.0
                  },
                  "productDescription": "[productDescription]",
                  "url": "[url]",
                  "includedDataTypes": {
                    "OFFERS": [
                      {
                        "offerId": "[offerId]",
                        "merchant": {
                          "merchantId": "[merchantId]",
                          "name": "[merchantName]",
                          "meanFeedbackRating": 5.0,
                          "totalFeedbackCount": 1
                        },
                        "price": {
                          "value": {
                            "amount": 1.00,
                            "currencyCode": "USD"
                          },
                          "formattedPrice": "[formattedPrice]",
                          "priceType": "NEW"
                        },
                        "listPrice": {
                          "value": {
                            "amount": 2.00,
                            "currencyCode": "USD"
                          },
                          "formattedPrice": "[formattedPrice]",
                          "priceType": "NEW"
                        },
                        "taxExclusivePrice": {
                          "taxExclusiveAmount": {
                            "amount": 1.00,
                            "currencyCode": "USD"
                          },
                          "formattedPrice": "[formattedPrice]",
                          "displayString": "[taxExclusivePriceDisplayString]",
                          "label": "Sin IVA"
                        },
                        "quantityLimits": {
                          "minQuantity": 1,
                          "maxQuantity": 30
                        },
                        "productCondition": "NEW",
                        "productConditionNote": "[productConditionNote]",
                        "condition": {
                          "conditionValue": "NEW",
                          "conditionNote" : "[productConditionNote]",
                          "subCondition" : "ACCEPTABLE"
                        },
                        "availability": "[availability]",
                        "fulfillmentType": "AMAZON",
                        "buyingGuidance": "NONE",
                        "buyingRestrictions": [],
                        "shippingOptions": [
                          {
                            "shippingCost": {
                              "value": {
                                "amount": 9.00,
                                "currencyCode": "USD"
                              }
                            },
                            "deliveryRange":
                            {
                              "max": "2022-01-01T00:00:01.000Z",
                              "min": "2022-01-01T00:00:01.000Z"
                            }
                          }
                        ]
                      }
                    ]
                  }
                }
              }
            ]
          },
          "400": {
            "description": "The service was unable to process your request. Reasons for the error are described in an error response object.",
            "schema": {
              "$ref": "#/definitions/ErrorList"
            },
            "x-amazon-spds-sandbox-behaviors": [
              {
                "request": {
                  "parameters": {
                    "productId": {
                      "value": "B07VDJ5RVF"
                    },
                    "locale": {
                      "value": "es_US"
                    },
                    "facets": {
                      "value": [
                        "OFFERS"
                      ]
                    },
                    "shippingPostalCode": {
                      "value": "99999"
                    }
                  }
                },
                "response": {
                  "errors": [
                    {
                      "code": "INVALID_REQUEST_PARAMETER",
                      "message": "Missing required request parameters: [productRegion]"
                    }
                  ]
                }
              }
            ]
          },
          "401": {
            "description": "The request's Authorization header is not formatted correctly or does not contain a valid authorization input.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "403": {
            "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "404": {
            "description": "The resource specified does not exist.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "429": {
            "description": "The frequency of requests was greater than allowed.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "500": {
            "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "503": {
            "description": "Temporary overloading or maintenance of the server.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          }
        },
        "tags": [
          "products"
        ],
        "description": "Retrieve a product with its ASIN identifier",
        "operationId": "productsRequest",
        "summary": "Retrieve product data based on an ASIN identifier."
      }
    },
    "/products/2020-08-26/products/{productId}/offers": {
      "get": {
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "description": "The Amazon Standard Item Identifier (ASIN) for the product for which to get offers.",
            "in": "path",
            "name": "productId",
            "required": true,
            "type": "string"
          },
          {
            "description": "The region where you wish to purchase the product.",
            "enum": [
              "DE",
              "FR",
              "UK",
              "IT",
              "ES",
              "US",
              "CA",
              "JP"
            ],
            "in": "query",
            "name": "productRegion",
            "required": true,
            "type": "string"
          },
          {
            "description": "This field determines the region where to ship the product based on the value in the shippingPostalCode.",
            "in": "query",
            "name": "shippingRegion",
            "required": false,
            "type": "string"
          },
          {
            "description": "The locale of the request, in the form of an IETF language tag. Each ProductRegion supports one or more locales. This value should comply with java.util.Locale.",
            "pattern": "^[-_]+$",
            "in": "query",
            "name": "locale",
            "required": true,
            "type": "string"
          },
          {
            "description": "The shipping postal/zip code for customer's request. This parameter doesn't hold geocode.",
            "in": "query",
            "name": "shippingPostalCode",
            "required": false,
            "type": "string"
          },
          {
            "description": "The zero-based number of the page being requested. If not specified, a default value of 0 will be used. When passed, the value must be equal or greater than zero, and strictly less than the number of pages returned in the response.",
            "in": "query",
            "name": "pageNumber",
            "required": false,
            "type": "integer"
          },
          {
            "description": "The number of items desired per page in response. If not specified, a default value of 24 will be used. Maximum items that can be fetched in single request is 24.",
            "in": "query",
            "name": "pageSize",
            "required": false,
            "type": "integer"
          },
          {
            "description": "Group identifier to determine on behalf of which group a customer is performing this operation. This can be found in your Amazon Business account information. Only necessary if the customer account belongs to more than one group.",
            "in": "query",
            "name": "groupTag",
            "required": false,
            "type": "string"
          },
          {
            "collectionFormat": "csv",
            "description": "A list of filter ids to apply to query results.",
            "in": "query",
            "name": "filterIds",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "description": "The number of units the customer intends to purchase. This helps  Amazon to determine quantity-based discounts if an eligible offer is present. Defaults to 1.",
            "in": "query",
            "name": "quantity",
            "required": false,
            "type": "integer",
            "default": 1
          },
          {
            "description": "Email address of the user requesting this resource",
            "in": "header",
            "name": "x-amz-user-email",
            "required": true,
            "type": "string"
          },
          {
            "collectionFormat": "csv",
            "description": "A list specifying the offer fields you want to be included in your response object. If you do not include this query parameter then all inclusions will be returned.",
            "enum": [
              "ALL",
              "availability",
              "buyingGuidance",
              "buyingRestrictions",
              "condition",
              "fulfillmentType",
              "merchant",
              "price",
              "productCondition",
              "productConditionNote",
              "quantityLimits",
              "quantityPrice",
              "taxExclusivePrice",
              "deliveryInformation",
              "listPrice",
              "shippingOptions"
            ],
            "in": "query",
            "name": "inclusionsForOffers",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-example": "/path?inclusionsForOffers=FOO,BAR"
          }
        ],
        "responses": {
          "200": {
            "description": "Search success",
            "schema": {
              "$ref": "#/definitions/OffersResult"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            },
            "x-amazon-spds-sandbox-behaviors": [
              {
                "request": {
                  "parameters": {
                    "productRegion": {
                      "value": "DE"
                    },
                    "locale": {
                      "value": "es_US"
                    },
                    "productId": {
                      "value": "B07VDJ5RVF"
                    },
                    "pageNumber": {
                      "value": "1"
                    },
                    "pageSize": {
                      "value": "12"
                    },
                    "filterIds": {
                      "value": [
                        "NEW",
                        "PRIME"
                      ]
                    }
                  }
                },
                "response": {
                  "offerCount": 2,
                  "numberOfPages": 1,
                  "featuredOffer": {
                    "availability": "[availability]",
                    "buyingGuidance": "NONE",
                    "deliveryInformation": "[deliveryInformation]",
                    "fulfillmentType": "AMAZON_FULFILLMENT",
                    "offerId": "[offerId]",
                    "merchant": {
                      "name": "[merchantName]",
                      "merchantId": "[merchantId]",
                      "meanFeedbackRating": 5.0,
                      "totalFeedbackCount": 1
                    },
                    "price": {
                      "value": {
                        "amount": 1.00,
                        "currencyCode": "USD"
                      },
                      "formattedPrice": "[formattedPrice]",
                      "priceType": "NEW"
                    },
                    "listPrice": {
                      "value": {
                        "amount": 2.00,
                        "currencyCode": "USD"
                      },
                      "formattedPrice": "[formattedPrice]",
                      "priceType": "NEW"
                    },
                    "taxExclusivePrice": {
                      "taxExclusiveAmount": {
                        "amount": 1.0,
                        "currencyCode": "USD"
                      },
                      "formattedPrice": "[formattedPrice]",
                      "displayString": "[taxExclusivePriceDisplayString]",
                      "label": "[taxExclusivePriceLabel]"
                    },
                    "quantityLimits": {
                      "minQuantity": 1,
                      "maxQuantity": 6
                    },
                    "quantityPrice": {
                      "quantityPriceTiers": [
                        {
                          "quantityDisplay": "string",
                          "unitPrice": {
                            "amount": 0,
                            "currencyCode": "USD"
                          },
                          "minQuantity": 0,
                          "price": {
                            "value": {
                              "amount": 0,
                              "currencyCode": "USD"
                            },
                            "formattedPrice": "[formattedPrice]",
                            "priceType": "NEW"
                          },
                          "savingMessage": "string",
                          "taxExclusivePrice": {
                            "taxExclusiveAmount": {
                              "amount": 0,
                              "currencyCode": "USD"
                            },
                            "displayString": "[taxExclusivePriceDisplayString]",
                            "formattedPrice": "[formattedPrice]",
                            "label": "[taxExclusivePriceLabel]"
                          }
                        }
                      ]
                    },
                    "productCondition": "NEW",
                    "productConditionNote": "[productConditionNote]",
                    "condition": {
                      "conditionValue": "NEW",
                      "conditionNote": "string",
                      "subCondition": "ACCEPTABLE"
                    },
                    "buyingRestrictions": [],
                    "shippingOptions": [
                      {
                        "shippingCost": {
                          "value": {
                            "amount": 9.00,
                            "currencyCode": "USD"
                          }
                        },
                        "deliveryRange":
                        {
                          "max": "2022-01-01T00:00:01.000Z",
                          "min": "2022-01-01T00:00:01.000Z"
                        }
                      }
                    ]
                  },
                  "offers": [
                    {
                      "offerId": "[offerId]",
                      "merchant": {
                        "name": "[merchantName]",
                        "merchantId": "[merchantId]",
                        "meanFeedbackRating": 5.0,
                        "totalFeedbackCount": 1
                      },
                      "deliveryInformation": "[deliveryInformation]",
                      "price": {
                        "value": {
                          "amount": 1.00,
                          "currencyCode": "USD"
                        },
                        "formattedPrice": "[formattedPrice]",
                        "priceType": "NEW"
                      },
                      "listPrice": {
                        "value": {
                          "amount": 2.00,
                          "currencyCode": "USD"
                        },
                        "formattedPrice": "[formattedPrice]",
                        "priceType": "NEW"
                      },
                      "taxExclusivePrice": {
                        "taxExclusiveAmount": {
                          "amount": 1.0,
                          "currencyCode": "USD"
                        },
                        "formattedPrice": "[formattedPrice]",
                        "displayString": "[taxExclusivePriceDisplayString]",
                        "label": "[taxExclusivePriceLabel]"
                      },
                      "quantityLimits": {
                        "minQuantity": 1,
                        "maxQuantity": 6
                      },
                      "quantityPrice": {
                        "quantityPriceTiers": [
                          {
                            "quantityDisplay": "string",
                            "unitPrice": {
                              "amount": 0,
                              "currencyCode": "USD"
                            },
                            "minQuantity": 0,
                            "price": {
                              "value": {
                                "amount": 0,
                                "currencyCode": "USD"
                              },
                              "formattedPrice": "[formattedPrice]",
                              "priceType": "NEW"
                            },
                            "savingMessage": "string",
                            "taxExclusivePrice": {
                              "taxExclusiveAmount": {
                                "amount": 0,
                                "currencyCode": "USD"
                              },
                              "displayString": "[taxExclusivePriceDisplayString]",
                              "formattedPrice": "[formattedPrice]",
                              "label": "[taxExclusivePriceLabel]"
                            }
                          }
                        ]
                      },
                      "productCondition": "NEW",
                      "productConditionNote": "[productConditionNote]",
                      "condition": {
                        "conditionValue": "NEW",
                        "conditionNote": "string",
                        "subCondition": "ACCEPTABLE"
                      },
                      "availability": "[availability]",
                      "fulfillmentType": "THIRD_PARTY",
                      "buyingGuidance": "NONE",
                      "buyingRestrictions": [],
                      "shippingOptions": [
                        {
                          "shippingCost": {
                            "value": {
                              "amount": 9.00,
                              "currencyCode": "USD"
                            }
                          },
                          "deliveryRange":
                          {
                            "max": "2022-01-01T00:00:01.000Z",
                            "min": "2022-01-01T00:00:01.000Z"
                          }
                        }
                      ]
                    }
                  ],
                  "filterGroups": [
                    {
                      "displayName": "[displayName]",
                      "items": [
                        {
                          "displayName": "[itemDisplayName]",
                          "id": "[itemId]"
                        }
                      ]
                    }
                  ]
                }
              }
            ]
          },
          "400": {
            "description": "The service was unable to process the request. Reasons for the error are described in an error response object.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            },
            "x-amazon-spds-sandbox-behaviors": [
              {
                "request": {
                  "parameters": {
                    "productRegion": {
                      "value": "US"
                    },
                    "productId": {
                      "value": "B07VDJ5RVF"
                    }
                  }
                },
                "response": {
                  "errors": [
                    {
                      "code": "INVALID_REQUEST_PARAMETER",
                      "message": "Missing required request parameters: [locale]"
                    }
                  ]
                }
              }
            ]
          },
          "401": {
            "description": "The request's Authorization header is not formatted correctly or does not contain a valid authorization input.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "403": {
            "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "404": {
            "description": "The resource specified does not exist.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "429": {
            "description": "The frequency of requests was greater than allowed.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "500": {
            "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "503": {
            "description": "Temporary overloading or maintenance of the server.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          }
        },
        "tags": [
          "search"
        ],
        "description": "Search for offers of a specific product.",
        "operationId": "searchOffersRequest",
        "summary": "Paginated and filtered search for offers of a specific product."
      }
    },
    "/products/2020-08-26/products/getProductsByAsins": {
      "post": {
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "productsByAsins",
            "schema": {
              "$ref": "#/definitions/ProductsByAsinsRequest"
            }
          },
          {
            "description": "Email address of the user requesting this resource",
            "in": "header",
            "name": "x-amz-user-email",
            "required": true,
            "type": "string"
          },
          {
            "collectionFormat": "csv",
            "description": "A list specifying the product fields you want to be included in your response object. If you do not include this query parameter then all inclusions will be returned.",
            "enum": [
              "ALL",
              "bookInformation",
              "byLine",
              "customerReviewsSummary",
              "editorialReviews",
              "features",
              "format",
              "mediaInformation",
              "productDescription",
              "productDetails",
              "productOverview",
              "productVariations",
              "taxonomies",
              "title"
            ],
            "in": "query",
            "name": "inclusionsForProducts",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-example": "/path?inclusionsForProducts=FOO,BAR"
          },
          {
            "collectionFormat": "csv",
            "description": "A list specifying the offer fields you want to be included in your response object. If you do not include this query parameter then all inclusions will be returned.",
            "enum": [
              "ALL",
              "availability",
              "buyingGuidance",
              "buyingRestrictions",
              "condition",
              "fulfillmentType",
              "merchant",
              "price",
              "productCondition",
              "productConditionNote",
              "quantityLimits",
              "quantityPrice",
              "taxExclusivePrice",
              "deliveryInformation",
              "listPrice",
              "shippingOptions"
            ],
            "in": "query",
            "name": "inclusionsForOffers",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "x-example": "/path?inclusionsForOffers=FOO,BAR"
          },
          {
            "description": "Group identifier to determine on behalf of which group a customer is performing this operation. This can be found in your Amazon Business account information. Only necessary if the customer account belongs to more than one group.",
            "in": "query",
            "name": "groupTag",
            "required": false,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "Products successfully retrieved",
            "schema": {
              "$ref": "#/definitions/ProductsByAsinsResponse"
            },
            "x-amzn-RateLimit-Limit": {
              "description": "Your rate limit (requests per second) for this operation.",
              "type": "string"
            },
            "x-amzn-requestid": {
              "description": "Unique request reference identifier.",
              "type": "string"
            },
            "x-amazon-spds-sandbox-behaviors": [
              {
                "request": {
                  "parameters": {
                    "body": {
                      "value": {
                        "locale": "en_US",
                        "productRegion": "US",
                        "productIds": ["asin1", "asin2", "asin3"]
                      }
                    }
                  }
                },
                "response": {
                  "matchingProductCount": 1,
                  "products": [
                    {
                      "asin": "[productId]",
                      "asinType": "STANDARD",
                      "signedProductId": "[signedProductId]",
                      "title": "[productTitle]",
                      "features": [
                        ["feature1"],
                        ["feature2"],
                        ["feature3"]
                      ],
                      "editorialReviews": [
                        {
                          "content": "[editorialReviewContent]",
                          "source": "[editorialReviewSource]"
                        }
                      ],
                      "format": "[format]",
                      "bookInformation": [
                        {
                          "isbn": [
                            {
                              "isbn10": "[isbn10]",
                              "isbn13": "[isbn13]"
                            }
                          ],
                          "publishedDate": "[publishedDate]",
                          "publicationLanguage": "[publicationLanguage]"
                        }
                      ],
                      "byLine": [
                        {
                          "name": "[name]",
                          "roles": [
                            "[role1]"
                          ]
                        }
                      ],
                      "mediaInformation": [
                        {
                          "editions": ["edition1"],
                          "mediaFormats": ["mediaFormat1"]
                        }
                      ],
                      "productOverview": {
                        "[attributeKey1]": "[attributeValue1]"
                      },
                      "productDetails": {
                        "[attributeKey1]": {
                          "[attributeKey1]": "[attributeValue1]"
                        }
                      },
                      "productVariations": {
                        "dimensions": [
                          {
                            "index": 0,
                            "displayString": "[dimensionKeys]",
                            "dimensionValues": [
                              {
                                "index": 0,
                                "displayString": "[value]"
                              }
                            ]
                          }
                        ],
                        "variations": [
                          {
                            "asin": "[asin]",
                            "variationValues": [
                              {
                                "index": 0,
                                "value": "[value]"
                              }
                            ]
                          }
                        ]
                      },
                      "taxonomies": [
                        {
                          "title": "[taxonomyTitle]",
                          "taxonomyCode": "[taxonomyCode]",
                          "type": "UNSPSC"
                        }
                      ],
                      "customerReviewsSummary": {
                        "numberOfReviews": 99,
                        "starRating": 4.9
                      },
                      "productDescription": "[productDescription]",
                      "url": "[productUrl]",
                      "includedDataTypes": {
                        "OFFERS": [
                          {
                            "offerId": "[offerId]",
                            "merchant": {
                              "merchantId": "[merchantId]",
                              "name": "[merchantName]",
                              "meanFeedbackRating": 4.5,
                              "totalFeedbackCount": 2
                            },
                            "price": {
                              "value": {
                                "amount": 39.89,
                                "currencyCode": "EUR"
                              },
                              "formattedPrice": "EUR 39.89",
                              "priceType": "BUSINESS"
                            },
                            "listPrice": {
                              "value": {
                                "amount": 49.89,
                                "currencyCode": "EUR"
                              },
                              "formattedPrice": "EUR 49.89",
                              "priceType": "BUSINESS"
                            },
                            "taxExclusivePrice": {
                              "taxExclusiveAmount": {
                                "amount": 34.39,
                                "currencyCode": "EUR"
                              },
                              "formattedPrice": "34.39 EUR",
                              "displayString": "[taxExclusivePriceDisplayString]",
                              "label": "[taxExclusivePriceLabel]"
                            },
                            "quantityLimits": {
                              "minQuantity": 1,
                              "maxQuantity": 30
                            },
                            "productCondition": "NEW",
                            "productConditionNote": "[productConditionNote]",
                            "condition": {
                              "conditionValue": "NEW",
                              "conditionNote" : "[productConditionNote]",
                              "subCondition" : "ACCEPTABLE"
                            },
                            "availability": "[availability]",
                            "fulfillmentType": "AMAZON",
                            "buyingGuidance": "NONE",
                            "buyingRestrictions": [],
                            "shippingOptions": [
                              {
                                "shippingCost": {
                                  "value": {
                                    "amount": 9.00,
                                    "currencyCode": "USD"
                                  }
                                },
                                "deliveryRange":
                                {
                                  "max": "2022-01-01T00:00:01.000Z",
                                  "min": "2022-01-01T00:00:01.000Z"
                                }
                              }
                            ]
                          }
                        ]
                      }
                    }
                  ]
                }
              }
            ]
          },
          "400": {
            "description": "The service was unable to process your request. Reasons for the error are described in an error response object.",
            "schema": {
              "$ref": "#/definitions/ErrorList"
            }
          },
          "401": {
            "description": "The request's Authorization header is not formatted correctly or does not contain a valid authorization input.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "403": {
            "description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "404": {
            "description": "The resource specified does not exist.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "429": {
            "description": "The frequency of requests was greater than allowed.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "500": {
            "description": "Encountered an unexpected condition which prevented the server from fulfilling the request.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          },
          "503": {
            "description": "Temporary overloading or maintenance of the server.",
            "schema": {
              "$ref": "#/definitions/ErrorResponse"
            },
            "headers": {
              "x-amzn-RateLimit-Limit": {
                "description": "Your rate limit (requests per second) for this operation.",
                "type": "string"
              },
              "x-amzn-requestid": {
                "description": "Unique request reference identifier.",
                "type": "string"
              }
            }
          }
        },
        "tags": [
          "products"
        ],
        "description": "Retrieve products for the ASIN identifier present in the list of ASINs.",
        "operationId": "getProductsByAsins",
        "summary": "Result for list of ASIN search."
      }
    }
  },
  "definitions": {
    "AsinType": {
      "description": "The type of the asin returned in the request. STANDARD asins can be purchased directly. VARIATION_PARENT asins cannot be purchased, but are linked to one or more VARIATION_CHILD asins which can. VARIATION_CHILD asins have specific settings for certain attributes, such as the size and color of a shirt. The VARIATION_CHILD asins can have different prices, and  can be offered by different merchants.\nPossible values:\n  * STANDARD\n  * VARIATION_PARENT\n  * VARIATION_CHILD",
      "type": "string",
      "enum": [
        "STANDARD",
        "VARIATION_PARENT",
        "VARIATION_CHILD"
      ]
    },
    "Category": {
      "description": "The search category is used to give information about relevant categories a product belongs to, it can be used to limit the results to a particular category in subsequent requests.",
      "required": [
        "displayName",
        "id"
      ],
      "properties": {
        "displayName": {
          "description": "Display name is used to share more human friendly readable description of category.",
          "type": "string"
        },
        "id": {
          "description": "Search category id identifies a search category uniquely within a product region.",
          "type": "string"
        }
      },
      "title": "Category",
      "type": "object"
    },
    "ErrorResponse": {
      "description": "Response returned when request is unsuccessful.",
      "properties": {
        "errors": {
          "description": "List of errors encountered while processing the request.",
          "$ref": "#/definitions/ErrorList"
        }
      },
      "type": "object"
    },
    "ErrorList": {
      "description": "A list of errors",
      "type": "array",
      "items": {
        "$ref": "#/definitions/Error"
      }
    },
    "Error": {
      "description": "Error detail returned as part of error response.",
      "properties": {
        "code": {
          "description": "The list of possible error codes which can be returned as part of an error response:\nPossible values:\n  * PRODUCT_NOT_FOUND\n * PAGE_NOT_FOUND\n * INVALID_REQUEST_PARAMETER\n * SERVICE_ERROR\n * EMAIL_ID_NOT_FOUND\n * UNAUTHORIZED",
          "type": "string",
          "enum": [
            "PRODUCT_NOT_FOUND",
            "PAGE_NOT_FOUND",
            "INVALID_REQUEST_PARAMETER",
            "SERVICE_ERROR",
            "EMAIL_ID_NOT_FOUND",
            "UNAUTHORIZED"
          ]
        },
        "message": {
          "description": "A message that describes the error condition.",
          "type": "string"
        },
        "details": {
          "description": "Additional details that can help the caller understand or fix the issue.",
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "type": "object"
    },
    "BuyingRestriction": {
      "description": "If present, this object shows any restriction that would prevent someone from buying this product.",
      "required": [
        "title",
        "type"
      ],
      "properties": {
        "title": {
          "description": "A displayable string which explains the restriction",
          "type": "string"
        },
        "type": {
          "description": "The type of buying restrictions that exists for a product.\nPossible values:\n * PROFESSIONAL_USE",
          "type": "string"
        }
      },
      "type": "object"
    },
    "ImageData": {
      "description": "A structure which holds the data for a given image.",
      "required": [
        "height",
        "url",
        "width"
      ],
      "properties": {
        "height": {
          "description": "The height of the image in pixels.",
          "type": "integer"
        },
        "url": {
          "description": "The URL to use to retrieve the image.",
          "type": "string"
        },
        "width": {
          "description": "The width of the image in pixels.",
          "type": "integer"
        }
      },
      "type": "object"
    },
    "ImageItem": {
      "description": "A structure which holds the data for a given image.",
      "required": [
        "altText"
      ],
      "properties": {
        "altText": {
          "description": "The text to use for the image's alt property.",
          "type": "string"
        },
        "large": {
          "$ref": "#/definitions/ImageData",
          "description": "The data for a large rendering of the image. Primary image dimensions are roughly 500 px, but can vary."
        },
        "medium": {
          "$ref": "#/definitions/ImageData",
          "description": "The data for a medium rendering of the image. Primary image dimensions are roughly 250 px, but can vary."
        },
        "small": {
          "$ref": "#/definitions/ImageData",
          "description": "The data for a small rendering of the image. Primary image dimensions are roughly 160 px, but can vary."
        },
        "thumbnail": {
          "$ref": "#/definitions/ImageData",
          "description": "The data for a very small rendering of the image. Primary image dimensions are roughly 40 px, but can vary."
        }
      },
      "type": "object"
    },
    "ImagesFacet": {
      "description": "A list of image data for the product. The first item in the list is the product's  primary image as shown on the Amazon website. Additional images show different views of the product, or other visual information useful to the customer.",
      "items": {
        "$ref": "#/definitions/ImageItem"
      },
      "type": "array"
    },
    "Merchant": {
      "description": "Information about the merchant selling the product",
      "required": [
        "merchantId",
        "name",
        "meanFeedbackRating",
        "totalFeedbackCount"
      ],
      "properties": {
        "merchantId": {
          "description": "The unique id of the merchant selling this product.",
          "type": "string"
        },
        "name": {
          "description": "The displayable name of the merchant selling this product",
          "type": "string"
        },
        "meanFeedbackRating": {
          "description": "Mean of the total ratings given to the merchant selling this product",
          "type": "number",
          "format": "double"
        },
        "totalFeedbackCount": {
          "description": "Total number of reviews for the merchant selling this product",
          "type": "number",
          "format": "integer"
        }
      },
      "type": "object"
    },
    "Condition": {
      "description": "Information about the condition of the product.",
      "required": [
        "conditionValue",
        "conditionNote",
        "subCondition"
      ],
      "properties": {
        "conditionValue": {
          "description": "The possible condition of the product being sold by the merchant.\nPossible values:\n *  NEW\n * USED\n * COLLECTIBLE\n * REFURBISHED\n * OTHER\n * UNKNOWN",
          "$ref": "#/definitions/ConditionValue"
        },
        "conditionNote": {
          "description": "Additional details on the product's condition.",
          "type": "string"
        },
        "subCondition": {
          "description": "The possible sub condition of the product being sold by the merchant.\nPossible values:\n *  ACCEPTABLE\n * CLUB\n * GOOD\n * LIKE_NEW\n * NEW\n * OEM\n * OPEN_BOX\n * REFURBISHED\n * UNKNOWN\n * VERY_GOOD",
          "$ref": "#/definitions/SubCondition"
        }
      },
      "type": "object"
    },
    "ConditionValue": {
      "description": "The possible condition of the product being sold by the merchant.\nPossible values:\n *  NEW\n * USED\n * COLLECTIBLE\n * REFURBISHED\n * OTHER\n * UNKNOWN",
      "type": "string",
      "enum": [
        "NEW",
        "USED",
        "COLLECTIBLE",
        "REFURBISHED",
        "OTHER",
        "UNKNOWN"
      ]
    },
    "SubCondition": {
      "description": "The possible sub condition of the product being sold by the merchant.\nPossible values:\n *  ACCEPTABLE\n * CLUB\n * GOOD\n * LIKE_NEW\n * NEW\n * OEM\n * OPEN_BOX\n * REFURBISHED\n * UNKNOWN\n * VERY_GOOD",
      "type": "string",
      "enum": [
        "ACCEPTABLE",
        "CLUB",
        "GOOD",
        "LIKE_NEW",
        "NEW",
        "OEM",
        "OPEN_BOX",
        "REFURBISHED",
        "UNKNOWN",
        "VERY_GOOD"
      ]
    },
    "Offer": {
      "description": "An offer for a product being sold by a merchant. This object contains many of the details a buyer would need to decide on whether to purchase a product.",
      "required": [
        "availability",
        "buyingGuidance",
        "buyingRestrictions",
        "fulfillmentType",
        "merchant",
        "offerId",
        "price",
        "productCondition",
        "productConditionNote",
        "condition",
        "quantityLimits",
        "taxExclusivePrice",
        "deliveryInformation",
        "listPrice",
        "shippingOptions"
      ],
      "properties": {
        "availability": {
          "description": "How soon the product would be available to be shipped once purchased",
          "type": "string"
        },
        "buyingGuidance": {
          "description": "If the company for which this API is being called provides Amazon Business with Guided Buying policies, this property provides information about whether their organization supports the purchase of this product. If this is not configured for the account, we return the value \"NONE\".\nPossible values:\n  * PREFERRED\n  * RESTRICTED\n  * BLOCKED\n  * NONE\n  * UNKNOWN",
          "type": "string",
          "enum": [
            "PREFERRED",
            "RESTRICTED",
            "BLOCKED",
            "NONE",
            "UNKNOWN"
          ]
        },
        "buyingRestrictions": {
          "description": "When present, entries in this property describe the reasons a buyer is restricted from buying a product.",
          "items": {
            "$ref": "#/definitions/BuyingRestriction"
          },
          "type": "array"
        },
        "fulfillmentType": {
          "description": "The fulfillment system to use for a product purchase.\n Possible values:\n  * AMAZON\n  * THIRD_PARTY\n  * OTHER",
          "type": "string",
          "enum": [
            "AMAZON_FULFILLMENT",
            "MERCHANT_FULFILLMENT",
            "OTHER"
          ]
        },
        "merchant": {
          "$ref": "#/definitions/Merchant"
        },
        "offerId": {
          "description": "The Amazon offer identifier to use when purchasing this product",
          "type": "string"
        },
        "price": {
          "$ref": "#/definitions/Price"
        },
        "shippingOptions": {
          "description": "The options for shipping a product offer.",
          "items": {
            "$ref": "#/definitions/ShippingOption"
          },
          "type": "array"
        },
        "listPrice": {
          "$ref": "#/definitions/Price"
        },
        "productCondition": {
          "description": "The possible condition of the product being sold by the merchant.\nPossible values:\n *  NEW\n * USED\n * COLLECTIBLE\n * REFURBISHED\n * OTHER\n * UNKNOWN",
          "type": "string",
          "enum": [
            "NEW",
            "USED",
            "COLLECTIBLE",
            "REFURBISHED",
            "OTHER",
            "UNKNOWN"
          ]
        },
        "productConditionNote": {
          "description": "Additional details on the product's condition",
          "type": "string"
        },
        "condition": {
          "description": "Information about the condition of the product.",
          "$ref": "#/definitions/Condition"
        },
        "quantityLimits": {
          "$ref": "#/definitions/OfferQuantityLimits"
        },
        "quantityPrice": {
          "$ref": "#/definitions/QuantityPrice"
        },
        "taxExclusivePrice": {
          "$ref": "#/definitions/TaxExclusivePrice"
        },
        "deliveryInformation": {
          "description": "Information regarding the estimated delivery time and delivery price.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "ShippingOption": {
      "description": "The available options for shipping a product offer.",
      "required": [
        "shippingCost",
        "deliveryRange"
      ],
      "properties": {
        "shippingCost": {
          "description": "The cost related to shipping an item.",
          "$ref": "#/definitions/ShippingDetails"
        },
        "deliveryRange": {
          "description": "The delivery window for shipping a product offer.",
          "$ref": "#/definitions/DeliveryDateRange"
        }
      },
      "type": "object"
    },
    "ShippingDetails": {
      "description": "The charges related to shipping a product offer.",
      "required" : [
        "value"
      ],
      "properties" : {
        "value": {
          "description": "An object that contains numerical amount value and the currency code.",
          "$ref": "#/definitions/Money"
        }
      },
      "type": "object"
    },
    "DeliveryDateRange": {
      "description": "Indicates the minimum and maximum delivery date and time to ship a product offer.",
      "required": [
        "max",
        "min"
      ],
      "properties": {
        "max": {
          "description": "The maximum local delivery date and time to ship a product offer.",
          "type": "string",
          "format": "date-time"
        },
        "min": {
          "description": "The minimum local delivery date and time to ship a product offer.",
          "type": "string",
          "format": "date-time"
        }
      },
      "type": "object"
    },
    "OfferQuantityLimits": {
      "description": "The various quantities of the product that can be purchased in a single order. Some products have both a min and max quantity.",
      "required": [
        "maxQuantity",
        "minQuantity"
      ],
      "properties": {
        "maxQuantity": {
          "description": "The largest number of products you can buy in an order.",
          "format": "int64",
          "type": "integer"
        },
        "minQuantity": {
          "description": "The smallest number of products you can buy in an order.",
          "format": "int64",
          "type": "integer"
        }
      },
      "type": "object"
    },
    "ProductOffersFacet": {
      "description": "A list of product offers, showing who is selling the product and at what price. This data is returned in the facets property, referenced by the key \"OFFERS\". We return at most 10 offers.",
      "items": {
        "$ref": "#/definitions/Offer"
      },
      "type": "array"
    },
    "SearchOffersFacet": {
      "description": "For searches, we return a single offer for each matching product in the result.",
      "items": {
        "$ref": "#/definitions/Offer"
      },
      "type": "array"
    },
    "Money": {
      "description": "An object that holds the numerical value and the currency code associated with the money.",
      "required": [
        "amount",
        "currencyCode"
      ],
      "properties": {
        "amount": {
          "description": "The numerical value of the money",
          "format": "double",
          "type": "number"
        },
        "currencyCode": {
          "description": "The currency code for that price amount, which can depend on the requested locale",
          "type": "string"
        }
      },
      "type": "object"
    },
    "Price": {
      "description": "A full description of the price of the product.",
      "required": [
        "value",
        "formattedPrice",
        "priceType"
      ],
      "properties": {
        "value": {
          "description": "An object that contains numerical amount value and the currency code.",
          "$ref": "#/definitions/Money"
        },
        "formattedPrice": {
          "description": "A displayable version of the price and currency code",
          "type": "string"
        },
        "priceType": {
          "description": "A description of the type of price. Some prices are indicative of special business pricing for a customer.\nPossible values:\n *  BUSINESS\n *  BUSINESS_QUANTITY_DISCOUNT\n *  BUSINESS_VOLUME_DISCOUNT\n * BUSINESS_EXCLUSIVE\n *  NEW\n * SALE\n *  USED\n * LIST_PRICE\n * OTHER",
          "type": "string"
        }
      },
      "type": "object"
    },
    "TaxExclusivePrice": {
      "description": "The price of the product without tax.",
      "required": [
        "displayString",
        "formattedPrice",
        "label",
        "taxExclusiveAmount"
      ],
      "properties": {
        "taxExclusiveAmount": {
          "description": "An object that contains numerical amount value and the currency code.",
          "$ref": "#/definitions/Money"
        },
        "displayString": {
          "description": "A displayable message about the tax exclusion.",
          "type": "string"
        },
        "formattedPrice": {
          "description": "A displayable version of the price and currency code",
          "type": "string"
        },
        "label": {
          "description": "A displayable description of the type of tax exclusion.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "EditorialReview": {
      "description": "A editorial review data entry for this product.",
      "required": [
        "content",
        "source"
      ],
      "properties": {
        "content": {
          "description": "The editorial review content",
          "type": "string"
        },
        "source": {
          "description": "The editorial review content source",
          "type": "string"
        }
      },
      "type": "object"
    },
    "Taxonomy": {
      "description": "A taxonomy data entry for this product.",
      "required": [
        "taxonomyCode",
        "title",
        "type"
      ],
      "properties": {
        "taxonomyCode": {
          "description": "The taxonomy code",
          "type": "string"
        },
        "title": {
          "description": "A displayable string with the name of product category",
          "type": "string"
        },
        "type": {
          "description": "The type of taxonomy standard represented by the code. The taxonomy types supported by Amazon.\nPossible values:\n * UNSPSC\n *  ECLASS",
          "type": "string",
          "enum": [
            "UNSPSC",
            "ECLASS"
          ]
        }
      },
      "type": "object"
    },
    "ISBN": {
      "description": "International Standard Book Number associated with the product",
      "properties": {
        "isbn10": {
          "description": "Unique 10-digit ISBN associated with the product",
          "type": "string"
        },
        "isbn13": {
          "description": "Unique 13-digit long ISBN associated with the product",
          "type": "string"
        }
      },
      "type": "object"
    },
    "BookInformation": {
      "description": "If applicable, book-specific details for this product.",
      "properties": {
        "isbn": {
          "$ref": "#/definitions/ISBN",
          "description": "International Standard Book Number associated with the product"
        },
        "publicationDate": {
          "description": "Date when the book was published",
          "type": "string",
          "format": "date-time"
        },
        "publishedLanguage": {
          "description": "Language of the book",
          "type": "string"
        }
      },
      "type": "object"
    },
    "Contributor": {
      "description": "A product's contributor entry, depending on the type of product it can be a brand, author, etc.",
      "properties": {
        "name": {
          "description": "Name of the contributor",
          "type": "string"
        },
        "roles": {
          "description": "Roles of the contributor in the context of the product",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "type": "object"
    },
    "MediaInformation": {
      "description": "If applicable, media type information of the product",
      "properties": {
        "editions": {
          "description": "Available editions of the product",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "mediaFormats": {
          "description": "Available formats of the media product (i.e. illustrated, first print, paperback)",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "type": "object"
    },
    "CustomerReviewsSummary": {
      "description": "Information on the product's rating count and star rating.",
      "required": [
        "numberOfReviews",
        "starRating"
      ],
      "type": "object",
      "properties": {
        "numberOfReviews": {
          "description": "The number of customer reviews of a product.",
          "type": "integer"
        },
        "starRating": {
          "description": "The star rating of a product.",
          "type": "number",
          "format": "double"
        }
      }
    },
    "DimensionValue": {
      "description": "Value of a dimension and its index \n exp. {index:0, displayString:red}",
      "properties": {
        "index": {
          "description": "index of the value",
          "type": "integer"
        },
        "displayString": {
          "description": "String of the dimension value in its readable form \n exp. red, sm, 12-packs",
          "type": "string"
        }
      },
      "type": "object"
    },
    "Dimension": {
      "description": "Dimension with its index, categorical name in its readable form, and a list of values for this dimension \n exp. [{index:0, displayString:color, dimensionValues: [{index:0, displayString:red}, ...]}, ...]",
      "type": "object",
      "properties": {
        "index": {
          "description": "Index of the dimension",
          "type": "integer"
        },
        "displayString": {
          "description": "Categorical name of the dimension in its readable form \n exp. color, size",
          "type": "string"
        },
        "dimensionValues": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/DimensionValue"
          }
        }
      }
    },
    "VariationValue": {
      "description": "Contains index that maps to a dimension and value maps to a dimensionValue to represent the variation properties for a child product \n exp. {index:0, value: 0}",
      "type": "object",
      "properties": {
        "index": {
          "description": "Index of the dimension",
          "type": "integer"
        },
        "value": {
          "description": "Integer value which maps to dimensionValue to indicate the variation property of a child product",
          "type": "integer"
        }
      }
    },
    "Variation": {
      "description": "A child product (variation) that contains its ASIN and a list of variationValues showing its variation properties \n exp. [ASIN: B07J3G6312: [{index:0, value: 0}, ...]]",
      "type": "object",
      "properties": {
        "asin": {
          "description": "ASIN of the child product \n exp. B07J3G6312",
          "type": "string"
        },
        "variationValues": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/VariationValue"
          }
        }
      }
    },
    "ProductVariations": {
      "description": "Variations(Child products) for this products including all of the categorical dimensions and their values. exp. \n Dimensions: [{index:0, displayString:color, dimensionValues: [{index:0, displayString:red}, ...]}, ...], Variations: [ASIN: B07J3G6312: [{index:0, value: 0}, ...]] \n should be interpret as B07J3G6312: [color: red]",
      "type": "object",
      "required": [
        "dimensions",
        "variations"
      ],
      "properties": {
        "dimensions": {
          "description": "A list of dimensions with their index, categorical names in their readable form, and lists of values for these dimensions \n exp. [{index:0, displayString:color, dimensionValues: [{index:0, displayString:red}, ...]}, ...]",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Dimension"
          }
        },
        "variations": {
          "description": "A list of child products (variations) which contain their ASINs and lists of variationValues showing their variation properties \n exp. [ASIN: B07J3G6312: [{index:0, value: 0}, ...], ...]",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Variation"
          }
        }
      }
    },
    "ProductsResult": {
      "description": "The result of a request for product data",
      "required": [
        "asin",
        "asinType",
        "signedProductId",
        "includedDataTypes",
        "features",
        "taxonomies",
        "title",
        "url",
        "format",
        "bookInformation",
        "byLine",
        "mediaInformation",
        "productDescription",
        "productOverview",
        "productDetails",
        "customerReviewsSummary",
        "productVariations"
      ],
      "properties": {
        "asin": {
          "description": "The Amazon ASIN product identifier",
          "type": "string"
        },
        "asinType": {
          "description": "The type of the asin returned in the request. STANDARD asins can be purchased directly. VARIATION_PARENT asins cannot be purchased, but are linked to one or more VARIATION_CHILD asins which can. VARIATION_CHILD asins have specific settings for certain attributes, such as the size and color of a shirt. The VARIATION_CHILD asins can have different prices, and  can be offered by different merchants.\nPossible values:\n  * STANDARD\n  * VARIATION_PARENT\n  * VARIATION_CHILD",
          "$ref": "#/definitions/AsinType"
        },
        "signedProductId": {
          "description": "Product id signed with information about the request for which it was returned.",
          "type": "string"
        },
        "includedDataTypes": {
          "additionalProperties": {
            "type" : "array",
            "items" : {
              "type" : "object"
            }
          },
          "description": "A list of additional data groups, as specified in the request. Each facet contains a logic grouping of data about the product.",
          "type": "object"
        },
        "features": {
          "description": "A list descriptive features of the product, typically shown as a bulleted list.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "editorialReviews": {
          "description": "A list of editorial reviews for the product. We support a list of standardized editorial review types, and this list contains as many as we have for a product.",
          "items": {
            "$ref": "#/definitions/EditorialReview"
          },
          "type": "array"
        },
        "taxonomies": {
          "description": "A list taxonomy classifications for the product. We support a list of standardized taxonomy types, and this list contains as many as we have for a product.",
          "items": {
            "$ref": "#/definitions/Taxonomy"
          },
          "type": "array"
        },
        "title": {
          "description": "The title of the product, typically shown at the top of an Amazon product page.",
          "type": "string"
        },
        "url": {
          "description": "A URL to the product on the Amazon website",
          "type": "string"
        },
        "format": {
          "description": "Type of the product on the Amazon website. For books, this is the binding.",
          "type": "string"
        },
        "bookInformation": {
          "description": "If applicable, book-specific details for this product.",
          "$ref": "#/definitions/BookInformation"
        },
        "byLine": {
          "description": "A product's by-line contributor information, depending on the type of product it will contain details for brand, author(s), editors, etc.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Contributor"
          }
        },
        "mediaInformation": {
          "description": "If applicable, media type information of the product",
          "$ref": "#/definitions/MediaInformation"
        },
        "productOverview": {
          "description": "General descriptive fields of the product",
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        "productDetails": {
          "description": "Nested key/value pairs indicating additional information for product parts",
          "additionalProperties": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object"
          },
          "type": "object"
        },
        "productVariations": {
          "description": "Variations(Child products) for this products and dimensions for all variations exp. \n {dimensions: {color: {0:red, 1:blue, ...}, size: {0:xs, 1:sm, ...}, ...}, \n variations: {B07J3G6312: [1,0], B07J348978: [0,0], ...}}",
          "$ref": "#/definitions/ProductVariations"
        },
        "customerReviewsSummary": {
          "description": "Information on the product's rating count and star rating.",
          "$ref": "#/definitions/CustomerReviewsSummary"
        },
        "productDescription": {
          "description": "Description for the given product.",
          "type": "string"
        }
      },
      "title": "Products Result",
      "type": "object"
    },
    "QuantityPrice": {
      "description": "Provides information about the different prices customer can get for higher quantities.",
      "type": "object",
      "properties": {
        "quantityPriceTiers": {
          "description": "Collection of quantity price tier.",
          "items": {
            "$ref": "#/definitions/QuantityPriceTier"
          },
          "type": "array"
        }
      }
    },
    "QuantityPriceTier": {
      "description": "Quantity Price tier defines the price for items if the quantity being purchased falls within the quantities specified in quantityDisplay field.",
      "required": [
        "quantityDisplay",
        "unitPrice"
      ],
      "properties": {
        "quantityDisplay": {
          "description": "A localized string indicating the quantity range for which the price in the tier applies.",
          "type": "string"
        },
        "unitPrice": {
          "description": "The in price per unit for the item in this quantity tier.",
          "$ref": "#/definitions/Money"
        },
        "minQuantity": {
          "description": "[DEPRECATED: please use unitPrice and quantityDisplay instead] The minimum quantity of items that the customer needs to buy to reach this price tier.",
          "format": "int64",
          "type": "integer"
        },
        "price": {
          "description": "[DEPRECATED: please use unitPrice and quantityDisplay instead]",
          "$ref": "#/definitions/Price"
        },
        "savingMessage": {
          "description": "[DEPRECATED: please use unitPrice and quantityDisplay instead] The savings message of the tier. Exists only when the tier's price is lower than the basis price of the current buying option.",
          "type": "string"
        },
        "taxExclusivePrice": {
          "description": "[DEPRECATED: please use unitPrice and quantityDisplay instead]",
          "$ref": "#/definitions/TaxExclusivePrice"
        }
      },
      "type": "object"
    },
    "RefinementResult": {
      "description": "The data that describes the refinements used to narrow down results. These values remains same for all pages in the result set.",
      "required": [
        "categories",
        "subCategories",
        "availabilityOptions",
        "deliveryDayOptions",
        "eligibleForFreeShippingOptions",
        "primeEligible"
      ],
      "properties": {
        "categories": {
          "description": "A list of categories which have matches for the stated search keyword. A category id can sent back in the subsequent request to get a shorter list of more relevant search results.",
          "items": {
            "$ref": "#/definitions/Category"
          },
          "type": "array"
        },
        "subCategories": {
          "description": "A list of sub categories which have matches for given category. A search subcategory Id should be sent back in the next request to get a shorter list of more relevant products.",
          "items": {
            "$ref": "#/definitions/SubCategory"
          },
          "type": "array"
        },
        "availabilityOptions": {
          "description": "Two availability ids standing for in stock only and include out of stock would appear in the search refinement. Availability Id should be sent as an parameter in the next request to get a more filtered list of products and the availability filtering should return the products whose offers are aligned with the availability ID request passed.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Availability"
          }
        },
        "deliveryDayOptions": {
          "description": "Two delivery day ids standing for Get It Today and Get It by Tomorrow would appear in the search refinement.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/DeliveryDay"
          }
        },
        "eligibleForFreeShippingOptions": {
          "description": "One eligibleForFreeShippingOption Id would appear in the search refinement. EligibleForFreeShippingOption ID should be sent as an parameter in the next request to get a more filtered list of products and this filtering should return the products that are Free shipping by Amazon.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/EligibleForFreeShipping"
          }
        },
        "primeEligible": {
          "description": "This can be used as a query param which can be used to fetch only prime eligible items.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/PrimeEligible"
          }
        }
      },
      "title": "Refinement Result",
      "type": "object"
    },
    "SearchFacetType": {
      "description": "A list of supported data facets for product search.",
      "enum": [
        "OFFERS",
        "IMAGES"
      ],
      "type": "string"
    },
    "ProductsByAsinsResponse": {
      "description": "The data that describes the results for your list of asin search.",
      "required": [
        "matchingProductCount",
        "products",
        "notFoundAsins"
      ],
      "properties": {
        "matchingProductCount": {
          "description": "The number of products which matched your search query. This number can be much larger than the number of matching products you can view. The value same for all the pages in the result set.",
          "type": "integer"
        },
        "products": {
          "description": "A list of products that match your search criteria ",
          "items": {
            "$ref": "#/definitions/ProductsResult"
          },
          "type": "array"
        },
        "notFoundAsins": {
          "description": "A list of asin for which their is no product found.",
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "title": "GetProductsByAsins Api Search results.",
      "type": "object"
    },
    "ProductsByAsinsRequest": {
      "description": "Request object to be used to search a list of asins.",
      "type": "object",
      "required": [
        "locale",
        "productIds",
        "productRegion"
      ],
      "properties": {
        "productIds": {
          "description": "The list of Amazon Standard Item Identifier (ASIN) for the product. The maximum number of asins allowed in each call is 30.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "productRegion": {
          "description": "The region where you wish to purchase the product.",
          "type": "string",
          "enum": [
            "DE",
            "FR",
            "UK",
            "IT",
            "ES",
            "US",
            "CA",
            "JP"
          ]
        },
        "shippingRegion": {
          "description": "This field determines the region where to ship the product based on the value in the shippingPostalCode.",
          "type": "string"
        },
        "locale": {
          "description": "The locale of the request, in the form of an IETF language tag. Each ProductRegion supports one or more locales. This value should comply with java.util.Locale.",
          "type": "string",
          "pattern": "^[-_]+$"
        },
        "shippingPostalCode": {
          "description": "The shipping postal/zip code for customer's request. This parameter does not support geocode.",
          "type": "string"
        },
        "quantity": {
          "description": "The number of units the customer intends to purchase. This helps Amazon to determine quantity-based discounts if an eligible offer is present. Defaults to 1.",
          "type": "integer"
        },
        "facets": {
          "description": "A list of data facets to include in the response. If you include more than one facet in your requst separate each facet value with a comma.",
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "OFFERS",
              "IMAGES"
            ]
          }
        }
      }
    },
    "SearchProductsResult": {
      "description": "The data that describes the results of your search query.",
      "required": [
        "matchingProductCount",
        "numberOfPages",
        "products",
        "refinements",
        "searchRefinements"
      ],
      "properties": {
        "matchingProductCount": {
          "description": "The number of products which matched your search query. This number can be much larger than the number of matching products you can view. The value same for all the pages in the result set.",
          "type": "integer"
        },
        "searchRefinements": {
          "description": "Search refinements is used to share the refinements available for search result which can be used in subsequent request to narrow down the results , for example search category is a type of search refinement, if search category refinement is used in request , search results will be limited to given search category.",
          "items": {
            "$ref": "#/definitions/SearchRefinementResult"
          },
          "type": "array"
        },
        "refinements": {
          "$ref": "#/definitions/RefinementResult",
          "description": "Search refinements is used to share the refinements available for search result which can be used in subsequent request to narrow down the results , for example search category is a type of search refinement, if search category refinement is used in request , search results will be limited to given search category."
        },
        "numberOfPages": {
          "description": "Number of pages of results.",
          "type": "integer"
        },
        "products": {
          "description": "A list of products that match your search criteria ",
          "items": {
            "$ref": "#/definitions/ProductsResult"
          },
          "type": "array"
        }
      },
      "title": "Search products Result",
      "type": "object"
    },
    "SearchRefinementResult": {
      "description": "Search refinements is used to share the refinements available for search result which can be used in subsequent request to narrow down the results , for example search category is a type of search refinement, if search category refinement is used in request , search results will be limited to given search category.",
      "type": "object",
      "required": [
        "displayValue",
        "refinementValues",
        "selectionType"
      ],
      "properties": {
        "selectionType": {
          "description": "SelectionType is used to identify selection allowed for a given refinement, for example MultiSelect allows to search with multiple values of a refinement and InsteadSelect allows to search with only single refinement value",
          "type": "string"
        },
        "displayValue": {
          "description": "Human friendly name of a given refinement type",
          "type": "string"
        },
        "refinementValues": {
          "description": "RefinementValues holds items for a given refinement, for example if Brand is a refinement then refinementValues will have different brands available for a given product",
          "type": "array",
          "items": {
            "$ref": "#/definitions/RefinementValue"
          }
        }
      }
    },
    "RefinementValue": {
      "description": "RefinementValue holds items for a given refinement, for example if Brand is a refinement then refinementValues will have different brands available for a given product",
      "type": "object",
      "required": ["displayName", "searchRefinementValue"],
      "properties": {
        "displayName": {
          "description": "Name of the Item in a refinement",
          "type": "string"
        },
        "searchRefinementValue": {
          "description": "searchRefinementValue is used to share value that will be used to make search request for a given refinement",
          "type": "string"
        }
      },
      "title": "RefinementValue"
    },
    "SubCategory": {
      "description": "The search subcategory is used to give information about relevant search subcategories a product belongs to within a category. It can be used to limit the results to a particular search subcategory in subsequent requests.",
      "type": "object",
      "required": [
        "displayName",
        "id"
      ],
      "properties": {
        "displayName": {
          "description": "Display name is used to share more human friendly readable description of sub category.",
          "type": "string"
        },
        "id": {
          "description": "The search subcategory id identify a search sub category uniquely across a product region.",
          "type": "string"
        }
      },
      "title": "SubCategory"
    },
    "Availability": {
      "description": "Availability is used to limit the product offers to be in stock only or include out of stock. It can be used to limit the subsequent search requests.",
      "type": "object",
      "required": ["displayName", "id"],
      "properties": {
        "displayName": {
          "description": "Availability display name would be more user friendly to illustrate the meaning of its id.",
          "type": "string"
        },
        "id": {
          "description": "Availability id  uniquely identify a availability option, client can sent back the id to filter asins belonging to given availability option.",
          "type": "string"
        }
      },
      "title": "Availability"
    },
    "DeliveryDay": {
      "description": "The deliveryDay is used to limit the product offers to be Get It Today or Get It by Tomorrow.",
      "type": "object",
      "required": ["displayName", "id"],
      "properties": {
        "displayName": {
          "description": "DeliveryDay display name is used to share more human friendly readable description.",
          "type": "string"
        },
        "id": {
          "description": "DeliveryDay id would identify the search regrading to it is Get It Today or Get It by Tomorrow.",
          "type": "string"
        }
      },
      "title": "DeliveryDay"
    },
    "EligibleForFreeShipping": {
      "description": "The EligibleForFreeShipping is used to limit the product to be Free Shipping by Amazon only. It can be used to limit the subsequent search requests.",
      "type": "object",
      "required": ["displayName", "id"],
      "properties": {
        "displayName": {
          "description": "EligibleForFreeShipping display name is used to share more human friendly readable description.",
          "type": "string"
        },
        "id": {
          "description": "EligibleForFreeShipping id would identify the search to be Free Shipping by Amazon only.",
          "type": "string"
        }
      },
      "title": "EligibleForFreeShipping"
    },
    "PrimeEligible": {
      "description": "The prime eligible refinement is used to give information about relevant prime eligible products.",
      "type": "object",
      "required": ["displayName", "id"],
      "properties": {
        "displayName": {
          "description": "The prime eligible refinement is used to give information about relevant prime eligible products.",
          "type": "string"
        },
        "id": {
          "description": "Prime eligible id identifies a prime eligible option uniquely.",
          "type": "string"
        }
      },
      "title": "PrimeEligible"
    },
    "Region" :  {
      "description": "A region where a product can be purchased.",
      "enum": [
        "DE",
        "FR",
        "UK",
        "IT",
        "ES",
        "US",
        "CA",
        "JP"
      ],
      "type": "string"
    },
    "OffersResult": {
      "description": "The data that describes the results of your offer query",
      "type": "object",
      "properties": {
        "offerCount": {
          "description": "The number of offers for the ASIN, after filters are applied.",
          "type": "integer"
        },
        "numberOfPages": {
          "description": "Number of pages of results.",
          "type": "integer"
        },
        "featuredOffer": {
          "description": "A featured offer that is selected based on eligibility requirements and criteria.",
          "$ref": "#/definitions/Offer",
          "type": "object"
        },
        "offers": {
          "description": "List of offers in page.",
          "items": {
            "$ref": "#/definitions/Offer"
          },
          "type": "array"
        },
        "filterGroups": {
          "description": "List of filter groups",
          "items": {
            "$ref": "#/definitions/OfferFilterGroup"
          },
          "type": "array"
        }
      }
    },
    "OfferFilterGroup": {
      "description": "A grouping of related filters.",
      "type": "object",
      "properties": {
        "displayName": {
          "description": "Displayable and localized filter group description.",
          "type": "string"
        },
        "filters": {
          "description": "List of filters in this group.",
          "items": {
            "$ref": "#/definitions/OfferFilter"
          },
          "type": "array"
        }
      }
    },
    "OfferFilter": {
      "description": "A filter to apply when getting offers for a product.",
      "type": "object",
      "properties": {
        "id" : {
          "description": "Filter identifier. Pass on filterIds request parameter to apply this filter on your search",
          "type": "string"
        },
        "displayName" : {
          "description": "Displayable and localized filter description.",
          "type": "string"
        }
      }
    }
  },
  "tags": [
    {
      "description": "Get data about a particular product",
      "name": "products"
    }
  ],
  "x-components": {}
}