easyparser-com · Schema
BulkRequest
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.
CompanyAPIAmazonScrapingReal-timeData-Extraction
JSON Schema
{
"$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"
]
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/easyparser-com-bulk-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.