{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/easyparser-com/json-schema/easyparser-com-bulk-request-schema.json",
  "title": "BulkRequest",
  "description": "Array of operation groups. At most 5,000 individual input values across ALL groups (not 5,000 per group). Processing timeout is 5 minutes. Inline localization fields go in payload, address_id at root.",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/easyparser-com-openapi.json#/components/schemas/BulkRequest",
  "type": "array",
  "items": {
    "$ref": "#/$defs/BulkRequestItem"
  },
  "minItems": 1,
  "maxItems": 5000,
  "x-max-total-inputs": 5000,
  "x-input-array-keys": [
    "asins",
    "urls",
    "keywords",
    "seller_ids",
    "identifiers"
  ],
  "$defs": {
    "BestSellersRankBulkPayload": {
      "type": "object",
      "properties": {
        "language": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "parameters": {
          "type": "string"
        },
        "cookie": {
          "type": "string"
        },
        "zip_code": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "asins": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "maxItems": 5000
        }
      },
      "additionalProperties": false,
      "required": [
        "asins"
      ]
    },
    "BestSellersRankBulkRequest": {
      "type": "object",
      "properties": {
        "platform": {
          "$ref": "#/$defs/Platform"
        },
        "operation": {
          "type": "string",
          "enum": [
            "BEST_SELLERS_RANK"
          ]
        },
        "domain": {
          "$ref": "#/$defs/MarketplaceDomain"
        },
        "callback_url": {
          "type": "string",
          "format": "uri",
          "description": "Required readiness webhook URL; the webhook does NOT contain parsed data. Retrieve results through the Data Service."
        },
        "address_id": {
          "type": "integer",
          "description": "Root-level pre-registered address. Inline address fields belong in payload and override this ID."
        },
        "operation_version": {
          "type": "integer",
          "minimum": 1
        },
        "payload": {
          "$ref": "#/$defs/BestSellersRankBulkPayload"
        }
      },
      "additionalProperties": false,
      "required": [
        "platform",
        "operation",
        "domain",
        "callback_url",
        "payload"
      ]
    },
    "BulkRequestItem": {
      "oneOf": [
        {
          "$ref": "#/$defs/DetailBulkRequest"
        },
        {
          "$ref": "#/$defs/OfferBulkRequest"
        },
        {
          "$ref": "#/$defs/SearchBulkRequest"
        },
        {
          "$ref": "#/$defs/ProductLookupBulkRequest"
        },
        {
          "$ref": "#/$defs/SellerProfileBulkRequest"
        },
        {
          "$ref": "#/$defs/SellerProductsBulkRequest"
        },
        {
          "$ref": "#/$defs/SellerFeedbackBulkRequest"
        },
        {
          "$ref": "#/$defs/SalesAnalysisAndHistoryBulkRequest"
        },
        {
          "$ref": "#/$defs/BestSellersRankBulkRequest"
        },
        {
          "$ref": "#/$defs/PackageDimensionBulkRequest"
        }
      ]
    },
    "DetailBulkPayload": {
      "type": "object",
      "properties": {
        "language": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "parameters": {
          "type": "string"
        },
        "cookie": {
          "type": "string"
        },
        "zip_code": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "associate_id": {
          "type": "string"
        },
        "a_plus_content": {
          "type": "boolean"
        },
        "asins": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "maxItems": 5000
        },
        "urls": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uri"
          },
          "minItems": 1,
          "maxItems": 5000
        }
      },
      "additionalProperties": false,
      "oneOf": [
        {
          "required": [
            "asins"
          ],
          "not": {
            "required": [
              "urls"
            ]
          }
        },
        {
          "required": [
            "urls"
          ],
          "not": {
            "required": [
              "asins"
            ]
          }
        }
      ]
    },
    "DetailBulkRequest": {
      "type": "object",
      "properties": {
        "platform": {
          "$ref": "#/$defs/Platform"
        },
        "operation": {
          "type": "string",
          "enum": [
            "DETAIL"
          ]
        },
        "domain": {
          "$ref": "#/$defs/MarketplaceDomain"
        },
        "callback_url": {
          "type": "string",
          "format": "uri",
          "description": "Required readiness webhook URL; the webhook does NOT contain parsed data. Retrieve results through the Data Service."
        },
        "address_id": {
          "type": "integer",
          "description": "Root-level pre-registered address. Inline address fields belong in payload and override this ID."
        },
        "operation_version": {
          "type": "integer",
          "minimum": 1
        },
        "payload": {
          "$ref": "#/$defs/DetailBulkPayload"
        }
      },
      "additionalProperties": false,
      "required": [
        "platform",
        "operation",
        "domain",
        "callback_url",
        "payload"
      ]
    },
    "IdentifierType": {
      "type": "string",
      "enum": [
        "ASIN",
        "EAN",
        "GTIN",
        "ISBN",
        "JAN",
        "MINSAN",
        "UPC"
      ]
    },
    "MarketplaceDomain": {
      "type": "string",
      "description": "Amazon marketplace domain suffix, for example .com, .co.uk or .de. Domain and address must match."
    },
    "OfferBulkPayload": {
      "type": "object",
      "properties": {
        "language": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "parameters": {
          "type": "string"
        },
        "cookie": {
          "type": "string"
        },
        "zip_code": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "associate_id": {
          "type": "string"
        },
        "min_quantity": {
          "type": "integer",
          "minimum": 1
        },
        "prime": {
          "type": "boolean"
        },
        "free_shipping": {
          "type": "boolean"
        },
        "condition_new": {
          "type": "boolean"
        },
        "condition_used_like_new": {
          "type": "boolean"
        },
        "condition_used_very_good": {
          "type": "boolean"
        },
        "condition_used_good": {
          "type": "boolean"
        },
        "condition_used_acceptable": {
          "type": "boolean"
        },
        "asins": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "maxItems": 5000
        }
      },
      "additionalProperties": false,
      "required": [
        "asins"
      ]
    },
    "OfferBulkRequest": {
      "type": "object",
      "properties": {
        "platform": {
          "$ref": "#/$defs/Platform"
        },
        "operation": {
          "type": "string",
          "enum": [
            "OFFER"
          ]
        },
        "domain": {
          "$ref": "#/$defs/MarketplaceDomain"
        },
        "callback_url": {
          "type": "string",
          "format": "uri",
          "description": "Required readiness webhook URL; the webhook does NOT contain parsed data. Retrieve results through the Data Service."
        },
        "address_id": {
          "type": "integer",
          "description": "Root-level pre-registered address. Inline address fields belong in payload and override this ID."
        },
        "operation_version": {
          "type": "integer",
          "minimum": 1
        },
        "payload": {
          "$ref": "#/$defs/OfferBulkPayload"
        }
      },
      "additionalProperties": false,
      "required": [
        "platform",
        "operation",
        "domain",
        "callback_url",
        "payload"
      ]
    },
    "PackageDimensionBulkPayload": {
      "type": "object",
      "properties": {
        "language": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "parameters": {
          "type": "string"
        },
        "cookie": {
          "type": "string"
        },
        "zip_code": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "asins": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "maxItems": 5000
        }
      },
      "additionalProperties": false,
      "required": [
        "asins"
      ]
    },
    "PackageDimensionBulkRequest": {
      "type": "object",
      "properties": {
        "platform": {
          "$ref": "#/$defs/Platform"
        },
        "operation": {
          "type": "string",
          "enum": [
            "PACKAGE_DIMENSION"
          ]
        },
        "domain": {
          "$ref": "#/$defs/MarketplaceDomain"
        },
        "callback_url": {
          "type": "string",
          "format": "uri",
          "description": "Required readiness webhook URL; the webhook does NOT contain parsed data. Retrieve results through the Data Service."
        },
        "address_id": {
          "type": "integer",
          "description": "Root-level pre-registered address. Inline address fields belong in payload and override this ID."
        },
        "operation_version": {
          "type": "integer",
          "minimum": 1
        },
        "payload": {
          "$ref": "#/$defs/PackageDimensionBulkPayload"
        }
      },
      "additionalProperties": false,
      "required": [
        "platform",
        "operation",
        "domain",
        "callback_url",
        "payload"
      ]
    },
    "Platform": {
      "type": "string",
      "enum": [
        "AMZ"
      ]
    },
    "ProductLookupBulkPayload": {
      "type": "object",
      "properties": {
        "language": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "parameters": {
          "type": "string"
        },
        "cookie": {
          "type": "string"
        },
        "zip_code": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "identifiers": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "maxItems": 5000
        },
        "identifier_type": {
          "$ref": "#/$defs/IdentifierType"
        }
      },
      "additionalProperties": false,
      "required": [
        "identifiers",
        "identifier_type"
      ]
    },
    "ProductLookupBulkRequest": {
      "type": "object",
      "properties": {
        "platform": {
          "$ref": "#/$defs/Platform"
        },
        "operation": {
          "type": "string",
          "enum": [
            "PRODUCT_LOOKUP"
          ]
        },
        "domain": {
          "$ref": "#/$defs/MarketplaceDomain"
        },
        "callback_url": {
          "type": "string",
          "format": "uri",
          "description": "Required readiness webhook URL; the webhook does NOT contain parsed data. Retrieve results through the Data Service."
        },
        "address_id": {
          "type": "integer",
          "description": "Root-level pre-registered address. Inline address fields belong in payload and override this ID."
        },
        "operation_version": {
          "type": "integer",
          "minimum": 1
        },
        "payload": {
          "$ref": "#/$defs/ProductLookupBulkPayload"
        }
      },
      "additionalProperties": false,
      "required": [
        "platform",
        "operation",
        "domain",
        "callback_url",
        "payload"
      ]
    },
    "SalesAnalysisAndHistoryBulkPayload": {
      "type": "object",
      "properties": {
        "language": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "parameters": {
          "type": "string"
        },
        "cookie": {
          "type": "string"
        },
        "zip_code": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "history_range": {
          "type": "string",
          "enum": [
            "0",
            "3",
            "6",
            "9",
            "12"
          ]
        },
        "asins": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "maxItems": 5000
        }
      },
      "additionalProperties": false,
      "required": [
        "asins"
      ]
    },
    "SalesAnalysisAndHistoryBulkRequest": {
      "type": "object",
      "properties": {
        "platform": {
          "$ref": "#/$defs/Platform"
        },
        "operation": {
          "type": "string",
          "enum": [
            "SALES_ANALYSIS_HISTORY"
          ]
        },
        "domain": {
          "$ref": "#/$defs/MarketplaceDomain"
        },
        "callback_url": {
          "type": "string",
          "format": "uri",
          "description": "Required readiness webhook URL; the webhook does NOT contain parsed data. Retrieve results through the Data Service."
        },
        "address_id": {
          "type": "integer",
          "description": "Root-level pre-registered address. Inline address fields belong in payload and override this ID."
        },
        "operation_version": {
          "type": "integer",
          "minimum": 1
        },
        "payload": {
          "$ref": "#/$defs/SalesAnalysisAndHistoryBulkPayload"
        }
      },
      "additionalProperties": false,
      "required": [
        "platform",
        "operation",
        "domain",
        "callback_url",
        "payload"
      ]
    },
    "SearchBulkPayload": {
      "type": "object",
      "properties": {
        "language": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "parameters": {
          "type": "string"
        },
        "cookie": {
          "type": "string"
        },
        "zip_code": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "associate_id": {
          "type": "string"
        },
        "page": {
          "type": "integer",
          "minimum": 1,
          "default": 1
        },
        "sort_by": {
          "type": "string",
          "enum": [
            "featured",
            "price-asc-rank",
            "price-desc-rank",
            "review-rank",
            "date-desc-rank",
            "exact-aware-popularity-rank"
          ]
        },
        "exclude_sponsored": {
          "type": "boolean"
        },
        "exclude_refinements": {
          "type": "boolean"
        },
        "keywords": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "maxItems": 5000
        },
        "urls": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uri"
          },
          "minItems": 1,
          "maxItems": 5000
        }
      },
      "additionalProperties": false,
      "oneOf": [
        {
          "required": [
            "keywords"
          ],
          "not": {
            "required": [
              "urls"
            ]
          }
        },
        {
          "required": [
            "urls"
          ],
          "not": {
            "required": [
              "keywords"
            ]
          }
        }
      ]
    },
    "SearchBulkRequest": {
      "type": "object",
      "properties": {
        "platform": {
          "$ref": "#/$defs/Platform"
        },
        "operation": {
          "type": "string",
          "enum": [
            "SEARCH"
          ]
        },
        "domain": {
          "$ref": "#/$defs/MarketplaceDomain"
        },
        "callback_url": {
          "type": "string",
          "format": "uri",
          "description": "Required readiness webhook URL; the webhook does NOT contain parsed data. Retrieve results through the Data Service."
        },
        "address_id": {
          "type": "integer",
          "description": "Root-level pre-registered address. Inline address fields belong in payload and override this ID."
        },
        "operation_version": {
          "type": "integer",
          "minimum": 1
        },
        "payload": {
          "$ref": "#/$defs/SearchBulkPayload"
        }
      },
      "additionalProperties": false,
      "required": [
        "platform",
        "operation",
        "domain",
        "callback_url",
        "payload"
      ]
    },
    "SellerFeedbackBulkPayload": {
      "type": "object",
      "properties": {
        "language": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "parameters": {
          "type": "string"
        },
        "cookie": {
          "type": "string"
        },
        "zip_code": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "page": {
          "type": "integer",
          "minimum": 1,
          "default": 1
        },
        "history_range": {
          "type": "string",
          "enum": [
            "1",
            "3",
            "12",
            "all"
          ]
        },
        "min_rating": {
          "type": "integer",
          "minimum": 1,
          "maximum": 5
        },
        "max_rating": {
          "type": "integer",
          "minimum": 1,
          "maximum": 5
        },
        "seller_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "maxItems": 5000
        },
        "urls": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uri"
          },
          "minItems": 1,
          "maxItems": 5000
        }
      },
      "additionalProperties": false,
      "oneOf": [
        {
          "required": [
            "seller_ids"
          ],
          "not": {
            "required": [
              "urls"
            ]
          }
        },
        {
          "required": [
            "urls"
          ],
          "not": {
            "required": [
              "seller_ids"
            ]
          }
        }
      ]
    },
    "SellerFeedbackBulkRequest": {
      "type": "object",
      "properties": {
        "platform": {
          "$ref": "#/$defs/Platform"
        },
        "operation": {
          "type": "string",
          "enum": [
            "SELLER_FEEDBACK"
          ]
        },
        "domain": {
          "$ref": "#/$defs/MarketplaceDomain"
        },
        "callback_url": {
          "type": "string",
          "format": "uri",
          "description": "Required readiness webhook URL; the webhook does NOT contain parsed data. Retrieve results through the Data Service."
        },
        "address_id": {
          "type": "integer",
          "description": "Root-level pre-registered address. Inline address fields belong in payload and override this ID."
        },
        "operation_version": {
          "type": "integer",
          "minimum": 1
        },
        "payload": {
          "$ref": "#/$defs/SellerFeedbackBulkPayload"
        }
      },
      "additionalProperties": false,
      "required": [
        "platform",
        "operation",
        "domain",
        "callback_url",
        "payload"
      ]
    },
    "SellerProductsBulkPayload": {
      "type": "object",
      "properties": {
        "language": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "parameters": {
          "type": "string"
        },
        "cookie": {
          "type": "string"
        },
        "zip_code": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "associate_id": {
          "type": "string"
        },
        "page": {
          "type": "integer",
          "minimum": 1,
          "default": 1
        },
        "sort_by": {
          "type": "string",
          "enum": [
            "featured-rank",
            "exact-aware-popularity-rank"
          ]
        },
        "exclude_refinements": {
          "type": "boolean"
        },
        "seller_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "maxItems": 5000
        },
        "urls": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uri"
          },
          "minItems": 1,
          "maxItems": 5000
        }
      },
      "additionalProperties": false,
      "oneOf": [
        {
          "required": [
            "seller_ids"
          ],
          "not": {
            "required": [
              "urls"
            ]
          }
        },
        {
          "required": [
            "urls"
          ],
          "not": {
            "required": [
              "seller_ids"
            ]
          }
        }
      ]
    },
    "SellerProductsBulkRequest": {
      "type": "object",
      "properties": {
        "platform": {
          "$ref": "#/$defs/Platform"
        },
        "operation": {
          "type": "string",
          "enum": [
            "SELLER_PRODUCTS"
          ]
        },
        "domain": {
          "$ref": "#/$defs/MarketplaceDomain"
        },
        "callback_url": {
          "type": "string",
          "format": "uri",
          "description": "Required readiness webhook URL; the webhook does NOT contain parsed data. Retrieve results through the Data Service."
        },
        "address_id": {
          "type": "integer",
          "description": "Root-level pre-registered address. Inline address fields belong in payload and override this ID."
        },
        "operation_version": {
          "type": "integer",
          "minimum": 1
        },
        "payload": {
          "$ref": "#/$defs/SellerProductsBulkPayload"
        }
      },
      "additionalProperties": false,
      "required": [
        "platform",
        "operation",
        "domain",
        "callback_url",
        "payload"
      ]
    },
    "SellerProfileBulkPayload": {
      "type": "object",
      "properties": {
        "language": {
          "type": "string"
        },
        "currency": {
          "type": "string"
        },
        "parameters": {
          "type": "string"
        },
        "cookie": {
          "type": "string"
        },
        "zip_code": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "country_code": {
          "type": "string"
        },
        "associate_id": {
          "type": "string"
        },
        "seller_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "maxItems": 5000
        },
        "urls": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uri"
          },
          "minItems": 1,
          "maxItems": 5000
        }
      },
      "additionalProperties": false,
      "oneOf": [
        {
          "required": [
            "seller_ids"
          ],
          "not": {
            "required": [
              "urls"
            ]
          }
        },
        {
          "required": [
            "urls"
          ],
          "not": {
            "required": [
              "seller_ids"
            ]
          }
        }
      ]
    },
    "SellerProfileBulkRequest": {
      "type": "object",
      "properties": {
        "platform": {
          "$ref": "#/$defs/Platform"
        },
        "operation": {
          "type": "string",
          "enum": [
            "SELLER_PROFILE"
          ]
        },
        "domain": {
          "$ref": "#/$defs/MarketplaceDomain"
        },
        "callback_url": {
          "type": "string",
          "format": "uri",
          "description": "Required readiness webhook URL; the webhook does NOT contain parsed data. Retrieve results through the Data Service."
        },
        "address_id": {
          "type": "integer",
          "description": "Root-level pre-registered address. Inline address fields belong in payload and override this ID."
        },
        "operation_version": {
          "type": "integer",
          "minimum": 1
        },
        "payload": {
          "$ref": "#/$defs/SellerProfileBulkPayload"
        }
      },
      "additionalProperties": false,
      "required": [
        "platform",
        "operation",
        "domain",
        "callback_url",
        "payload"
      ]
    }
  }
}