{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://artifacts.apis.io/easyparser-com/json-schema/easyparser-com-query-response-schema.json", "title": "QueryResponse", "x-generated": "2026-10-30", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/easyparser-com-openapi.json#/components/schemas/QueryResponse", "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "$ref": "#/$defs/QueryRecord" }, "message": { "type": "string" } }, "additionalProperties": true, "required": [ "success" ], "$defs": { "Address": { "type": "object", "properties": { "zipCode": { "type": "array", "items": { "type": "string" } }, "city": { "type": [ "string", "null" ] }, "district": { "type": [ "string", "null" ] }, "country_code": { "type": [ "string", "null" ] } }, "additionalProperties": true, "description": "Applied delivery destination. Two-part postal codes are returned as separate zipCode array entries." }, "BestSellersRankResult": { "anyOf": [ { "type": "object", "properties": { "country_code": { "type": "string" }, "product": { "type": "object", "properties": { "asin": { "type": "string" }, "title": { "type": "string" }, "brand_name": { "type": "string" }, "price": { "type": "number" }, "currency": { "type": "string" }, "link": { "type": "string" }, "bestseller": { "type": "object", "properties": { "context_name": { "type": "string" }, "rank": { "type": "integer" }, "sub_category_id": { "type": "string" } }, "additionalProperties": true }, "media": { "type": "object", "properties": { "image_url": { "type": "string" }, "thumb_url": { "type": "string" } }, "additionalProperties": true }, "reviews": { "type": "object", "properties": { "full_star_count": { "type": "integer" }, "rating_text": { "type": "string" }, "rating_value": { "type": "number" }, "total_count": { "type": "integer" } }, "additionalProperties": true } }, "additionalProperties": true } }, "additionalProperties": true, "required": [ "product" ] }, { "type": "object", "properties": { "country_code": { "type": "string" }, "product": { "type": "object", "properties": { "asin": { "type": "string" }, "title": { "type": "string" }, "brand_name": { "type": "string" }, "manufacturer": { "type": "string" }, "link": { "type": "string" }, "bestseller": { "type": "object", "properties": { "category_link": { "type": "string" }, "category_rank": { "type": "integer" }, "category_title": { "type": "string" }, "sub_category_link": { "type": "string" }, "sub_category_rank": { "type": "integer" }, "sub_category_title": { "type": "string" } }, "additionalProperties": true }, "image": { "type": "object", "properties": { "id": { "type": "string" }, "link": { "type": "string" }, "variant": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true } }, "additionalProperties": true, "required": [ "product" ] } ], "description": "Live v1 and Beta v2 shapes. Beta v2 becomes Live on 2026-11-01; older versions are then no longer returned." }, "BulkDetailResult": { "anyOf": [ { "$ref": "#/$defs/DetailResult" }, { "$ref": "#/$defs/DetailProduct" } ], "description": "Bulk documentation shows a direct product object; result.detail is also documented for realtime. Both documented representations are accepted." }, "BulkOperationResult": { "anyOf": [ { "$ref": "#/$defs/BulkDetailResult" }, { "$ref": "#/$defs/OfferResult" }, { "$ref": "#/$defs/SearchResult" }, { "$ref": "#/$defs/ProductLookupResult" }, { "$ref": "#/$defs/SellerProfileResult" }, { "$ref": "#/$defs/SellerProductsResult" }, { "$ref": "#/$defs/SellerFeedbackResult" }, { "$ref": "#/$defs/SalesAnalysisAndHistoryResult" }, { "$ref": "#/$defs/BestSellersRankResult" }, { "$ref": "#/$defs/PackageDimensionResult" } ] }, "BulkParsedEnvelope": { "type": "object", "properties": { "request_info": { "$ref": "#/$defs/RequestInfo" }, "result": { "anyOf": [ { "$ref": "#/$defs/BulkOperationResult" }, { "$ref": "#/$defs/EmptyResult" } ] } }, "additionalProperties": true, "required": [ "request_info", "result" ] }, "DataLink": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "self", "result" ] }, "href": { "type": "string", "format": "uri" }, "method": { "type": "string", "enum": [ "GET" ] }, "format": { "type": "string" }, "raw": { "type": "boolean" } }, "additionalProperties": true }, "DetailProduct": { "type": "object", "additionalProperties": true, "properties": { "title": { "type": "string" }, "title_excluding_variant_name": { "type": "string" }, "keywords": { "type": "string" }, "asin": { "type": "string" }, "gtin": { "type": "string" }, "link": { "type": "string" }, "brand": { "type": "string" }, "variant_asins_flat": { "type": "string" }, "categories_flat": { "type": "string" }, "description": { "type": "string" }, "marketplace_id": { "type": "string" }, "rating": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "ratings_total": { "type": "integer" }, "has_size_guide": { "type": "boolean" }, "is_bundle": { "type": "boolean" }, "specifications_flat": { "type": "string" }, "bestsellers_rank_flat": { "type": "string" }, "color": { "type": "string" }, "manufacturer": { "type": "string" }, "weight": { "type": "string" }, "dimensions": { "type": "string" }, "shipping_weight": { "type": "string" }, "model_number": { "type": "string" }, "feature_bullets_count": { "type": "integer" }, "feature_bullets_flat": { "type": "string" }, "delivered_to": { "type": "string" }, "ms": { "type": "string" }, "keywords_list": { "type": "array", "items": { "type": "string" } }, "variants": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "asin": { "type": "string" }, "title": { "type": "string" }, "is_current_product": { "type": "boolean" }, "link": { "type": "string" }, "dimensions": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } } } } }, "categories": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "link": { "type": "string" }, "category_id": { "type": "string" } } } }, "images": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "link": { "type": "string" }, "variant": { "type": "string" } } } }, "videos_additional": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "id": { "type": "string" }, "product_asin": { "type": "string" }, "parent_asin": { "type": "string" }, "related_products": { "type": "string" }, "title": { "type": "string" }, "profile_name": { "type": "string" }, "profile_image_url": { "type": "string" }, "profile_link": { "type": "string" }, "creator_type": { "type": "string" }, "vendor_code": { "type": "string" }, "vendor_name": { "type": "string" }, "vendor_tracking_id": { "type": "string" }, "video_image_id": { "type": "string" }, "video_image_url": { "type": "string" }, "video_image_width": { "type": "integer" }, "video_image_height": { "type": "integer" }, "video_image_extension": { "type": "string" }, "video_url": { "type": "string" }, "video_mime_type": { "type": "string" }, "duration": { "type": "string" }, "type": { "type": "string" } } } }, "attributes": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "top_reviews": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "body": { "type": "string" }, "body_html": { "type": "string" }, "link": { "type": "string" }, "rating": { "type": "integer" }, "date": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" }, "utc": { "type": "string" } } }, "profile": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "link": { "type": "string" }, "id": { "type": "string" } } }, "verified_purchase": { "type": "boolean" }, "review_country": { "type": "string" }, "is_global_review": { "type": "boolean" }, "helpful_votes": { "type": "integer" }, "vine_program": { "type": "boolean" } } } }, "specifications": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "bestsellers_rank": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "category": { "type": "string" }, "rank": { "type": "integer" }, "link": { "type": "string" } } } }, "feature_bullets": { "type": "array", "items": { "type": "string" } }, "not_match": { "type": "array", "items": { "type": "string" } }, "bought_activity": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" }, "value": { "type": "number" }, "period": { "type": "string" } } }, "search_alias": { "type": "object", "additionalProperties": true, "properties": { "title": { "type": "string" }, "value": { "type": "string" } } }, "sub_title": { "type": "object", "additionalProperties": true, "properties": { "text": { "type": "string" }, "link": { "type": "string" } } }, "rating_breakdown": { "type": "object", "additionalProperties": true, "properties": { "five_star": { "type": "object", "additionalProperties": true, "properties": { "percentage": { "type": "number" }, "count": { "type": "number" } } }, "four_star": { "type": "object", "additionalProperties": true, "properties": { "percentage": { "type": "number" }, "count": { "type": "number" } } }, "three_star": { "type": "object", "additionalProperties": true, "properties": { "percentage": { "type": "number" }, "count": { "type": "number" } } }, "two_star": { "type": "object", "additionalProperties": true, "properties": { "percentage": { "type": "number" }, "count": { "type": "number" } } }, "one_star": { "type": "object", "additionalProperties": true, "properties": { "percentage": { "type": "number" }, "count": { "type": "number" } } } } }, "main_image": { "type": "object", "additionalProperties": true, "properties": { "link": { "type": "string" } } }, "first_available": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" } } }, "brand_store": { "type": "object", "additionalProperties": true, "properties": { "id": { "type": "string" }, "link": { "type": "string" } } }, "similar_to_consider": { "type": "object", "additionalProperties": true, "properties": { "asin": { "type": "string" }, "title": { "type": "string" }, "link": { "type": "string" }, "rating": { "type": "string" }, "ratings_total": { "type": "integer" }, "is_prime": { "type": "boolean" }, "price": { "type": "object", "additionalProperties": true, "properties": { "symbol": { "type": "string" }, "value": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "currency": { "type": "string" }, "raw": { "type": "string" } } } } }, "bestseller_badge": { "type": "object", "additionalProperties": true, "properties": { "link": { "type": "string" }, "category": { "type": "string" }, "badge_text": { "type": "string" } } }, "buybox_winner": { "type": "object", "additionalProperties": true, "properties": { "offer_id": { "type": "string" }, "is_prime": { "type": "boolean" }, "is_amazon_fresh": { "type": "boolean" }, "condition": { "type": "object", "additionalProperties": true, "properties": { "is_new": { "type": "boolean" } } }, "price": { "type": "object", "additionalProperties": true, "properties": { "symbol": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "raw": { "type": "string" } } }, "shipping": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" } } }, "rrp": { "type": "object", "additionalProperties": true, "properties": { "symbol": { "type": "string" }, "value": { "type": "string" }, "currency": { "type": "string" }, "raw": { "type": "string" } } }, "fulfillment": { "type": "object", "additionalProperties": true, "properties": { "standard_delivery": { "type": "object", "additionalProperties": true, "properties": { "date": { "type": "string" }, "name": { "type": "string" } } }, "fastest_delivery": { "type": "object", "additionalProperties": true, "properties": { "date": { "type": "string" }, "name": { "type": "string" } } } } }, "maximum_order_quantity": { "type": "object", "additionalProperties": true, "properties": { "value": { "type": "number" }, "hard_maximum": { "type": "boolean" } } }, "availability": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" }, "min_quantity": { "type": "number" }, "real_count": { "type": "boolean" } } }, "secondary_buybox": { "type": "object", "additionalProperties": true, "properties": { "offer_id": { "type": "string" }, "caption": { "type": "string" } } } } }, "a_plus_content": { "type": "object", "additionalProperties": true, "properties": {} }, "videos": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": {} } }, "customer_say": { "type": "object", "additionalProperties": true, "properties": {} } }, "required": [ "asin" ] }, "DetailResult": { "type": "object", "additionalProperties": true, "properties": { "detail": { "type": "object", "additionalProperties": true, "properties": { "title": { "type": "string" }, "title_excluding_variant_name": { "type": "string" }, "keywords": { "type": "string" }, "asin": { "type": "string" }, "gtin": { "type": "string" }, "link": { "type": "string" }, "brand": { "type": "string" }, "variant_asins_flat": { "type": "string" }, "categories_flat": { "type": "string" }, "description": { "type": "string" }, "marketplace_id": { "type": "string" }, "rating": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "ratings_total": { "type": "integer" }, "has_size_guide": { "type": "boolean" }, "is_bundle": { "type": "boolean" }, "specifications_flat": { "type": "string" }, "bestsellers_rank_flat": { "type": "string" }, "color": { "type": "string" }, "manufacturer": { "type": "string" }, "weight": { "type": "string" }, "dimensions": { "type": "string" }, "shipping_weight": { "type": "string" }, "model_number": { "type": "string" }, "feature_bullets_count": { "type": "integer" }, "feature_bullets_flat": { "type": "string" }, "delivered_to": { "type": "string" }, "ms": { "type": "string" }, "keywords_list": { "type": "array", "items": { "type": "string" } }, "variants": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "asin": { "type": "string" }, "title": { "type": "string" }, "is_current_product": { "type": "boolean" }, "link": { "type": "string" }, "dimensions": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } } } } }, "categories": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "link": { "type": "string" }, "category_id": { "type": "string" } } } }, "images": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "link": { "type": "string" }, "variant": { "type": "string" } } } }, "videos_additional": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "id": { "type": "string" }, "product_asin": { "type": "string" }, "parent_asin": { "type": "string" }, "related_products": { "type": "string" }, "title": { "type": "string" }, "profile_name": { "type": "string" }, "profile_image_url": { "type": "string" }, "profile_link": { "type": "string" }, "creator_type": { "type": "string" }, "vendor_code": { "type": "string" }, "vendor_name": { "type": "string" }, "vendor_tracking_id": { "type": "string" }, "video_image_id": { "type": "string" }, "video_image_url": { "type": "string" }, "video_image_width": { "type": "integer" }, "video_image_height": { "type": "integer" }, "video_image_extension": { "type": "string" }, "video_url": { "type": "string" }, "video_mime_type": { "type": "string" }, "duration": { "type": "string" }, "type": { "type": "string" } } } }, "attributes": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "top_reviews": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "body": { "type": "string" }, "body_html": { "type": "string" }, "link": { "type": "string" }, "rating": { "type": "integer" }, "date": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" }, "utc": { "type": "string" } } }, "profile": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "link": { "type": "string" }, "id": { "type": "string" } } }, "verified_purchase": { "type": "boolean" }, "review_country": { "type": "string" }, "is_global_review": { "type": "boolean" }, "helpful_votes": { "type": "integer" }, "vine_program": { "type": "boolean" } } } }, "specifications": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "bestsellers_rank": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "category": { "type": "string" }, "rank": { "type": "integer" }, "link": { "type": "string" } } } }, "feature_bullets": { "type": "array", "items": { "type": "string" } }, "not_match": { "type": "array", "items": { "type": "string" } }, "bought_activity": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" }, "value": { "type": "number" }, "period": { "type": "string" } } }, "search_alias": { "type": "object", "additionalProperties": true, "properties": { "title": { "type": "string" }, "value": { "type": "string" } } }, "sub_title": { "type": "object", "additionalProperties": true, "properties": { "text": { "type": "string" }, "link": { "type": "string" } } }, "rating_breakdown": { "type": "object", "additionalProperties": true, "properties": { "five_star": { "type": "object", "additionalProperties": true, "properties": { "percentage": { "type": "number" }, "count": { "type": "number" } } }, "four_star": { "type": "object", "additionalProperties": true, "properties": { "percentage": { "type": "number" }, "count": { "type": "number" } } }, "three_star": { "type": "object", "additionalProperties": true, "properties": { "percentage": { "type": "number" }, "count": { "type": "number" } } }, "two_star": { "type": "object", "additionalProperties": true, "properties": { "percentage": { "type": "number" }, "count": { "type": "number" } } }, "one_star": { "type": "object", "additionalProperties": true, "properties": { "percentage": { "type": "number" }, "count": { "type": "number" } } } } }, "main_image": { "type": "object", "additionalProperties": true, "properties": { "link": { "type": "string" } } }, "first_available": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" } } }, "brand_store": { "type": "object", "additionalProperties": true, "properties": { "id": { "type": "string" }, "link": { "type": "string" } } }, "similar_to_consider": { "type": "object", "additionalProperties": true, "properties": { "asin": { "type": "string" }, "title": { "type": "string" }, "link": { "type": "string" }, "rating": { "type": "string" }, "ratings_total": { "type": "integer" }, "is_prime": { "type": "boolean" }, "price": { "type": "object", "additionalProperties": true, "properties": { "symbol": { "type": "string" }, "value": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "currency": { "type": "string" }, "raw": { "type": "string" } } } } }, "bestseller_badge": { "type": "object", "additionalProperties": true, "properties": { "link": { "type": "string" }, "category": { "type": "string" }, "badge_text": { "type": "string" } } }, "buybox_winner": { "type": "object", "additionalProperties": true, "properties": { "offer_id": { "type": "string" }, "is_prime": { "type": "boolean" }, "is_amazon_fresh": { "type": "boolean" }, "condition": { "type": "object", "additionalProperties": true, "properties": { "is_new": { "type": "boolean" } } }, "price": { "type": "object", "additionalProperties": true, "properties": { "symbol": { "type": "string" }, "value": { "type": "number" }, "currency": { "type": "string" }, "raw": { "type": "string" } } }, "shipping": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" } } }, "rrp": { "type": "object", "additionalProperties": true, "properties": { "symbol": { "type": "string" }, "value": { "type": "string" }, "currency": { "type": "string" }, "raw": { "type": "string" } } }, "fulfillment": { "type": "object", "additionalProperties": true, "properties": { "standard_delivery": { "type": "object", "additionalProperties": true, "properties": { "date": { "type": "string" }, "name": { "type": "string" } } }, "fastest_delivery": { "type": "object", "additionalProperties": true, "properties": { "date": { "type": "string" }, "name": { "type": "string" } } } } }, "maximum_order_quantity": { "type": "object", "additionalProperties": true, "properties": { "value": { "type": "number" }, "hard_maximum": { "type": "boolean" } } }, "availability": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" }, "min_quantity": { "type": "number" }, "real_count": { "type": "boolean" } } }, "secondary_buybox": { "type": "object", "additionalProperties": true, "properties": { "offer_id": { "type": "string" }, "caption": { "type": "string" } } } } }, "a_plus_content": { "type": "object", "additionalProperties": true, "properties": {} }, "videos": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": {} } }, "customer_say": { "type": "object", "additionalProperties": true, "properties": {} } } } }, "description": "Realtime DETAIL response: product fields are nested inside result.detail.", "required": [ "detail" ] }, "EmptyResult": { "type": "object", "maxProperties": 0, "description": "No parsed data, for example a failed query." }, "FeedbackPagination": { "type": "object", "properties": { "current_page": { "type": "integer" }, "has_next_page": { "type": "boolean" }, "next_page": { "type": [ "integer", "null" ] } }, "additionalProperties": true }, "Image": { "type": "object", "properties": { "id": { "type": "string" }, "link": { "type": "string" }, "variant": { "type": "string" } }, "additionalProperties": true }, "MarketplaceDomain": { "type": "string", "description": "Amazon marketplace domain suffix, for example .com, .co.uk or .de. Domain and address must match." }, "OfferPagination": { "type": "object", "properties": { "current_page": { "type": "integer" }, "total_pages": { "type": "integer" }, "total_results": { "type": "integer" }, "current_offer_count": { "type": "integer" } }, "additionalProperties": true }, "OfferResult": { "type": "object", "additionalProperties": true, "properties": { "product": { "type": "object", "additionalProperties": true, "properties": { "title": { "type": "string" }, "rating": { "type": [ "number", "string" ] }, "ratings_total": { "type": "integer" }, "image": { "type": "string" }, "asin": { "type": "string" }, "link": { "type": "string" }, "offer_count": { "type": "integer" } } }, "offer": { "type": "object", "additionalProperties": true, "properties": { "offer_results": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "offer_id": { "type": "string" }, "is_prime": { "type": "boolean" }, "offer_asin": { "type": "string" }, "position": { "type": "integer" }, "buybox_winner": { "type": "boolean" }, "promotion": { "type": "object", "additionalProperties": true, "properties": { "has_coupon": { "type": "boolean" } } }, "price": { "$ref": "#/$defs/Price" }, "minimum_order_quantity": { "type": "object", "additionalProperties": true, "properties": { "value": { "type": "integer" } } }, "maximum_order_quantity": { "type": "object", "additionalProperties": true, "properties": { "value": { "type": "integer" } } }, "condition": { "type": "object", "additionalProperties": true, "properties": { "is_new": { "type": "boolean" }, "title": { "type": "string" }, "comments": { "type": "string" } } }, "delivery": { "type": "object", "additionalProperties": true, "properties": { "fulfilled_by_amazon": { "type": "boolean" }, "shipped_from_outside_country": { "type": "boolean" }, "countdown": { "type": "string" }, "price": { "type": "object", "additionalProperties": true, "properties": { "symbol": { "type": "string" }, "value": { "type": "string" }, "currency": { "type": "string" }, "raw": { "type": "string" }, "is_free": { "type": "boolean" } } } } }, "seller": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string" }, "link": { "type": "string" } } }, "seller_type": { "type": "object", "properties": { "fba": { "type": "boolean" }, "fbm": { "type": "boolean" }, "is_prime": { "type": "boolean" } }, "additionalProperties": true } } } }, "available_filters": { "type": "object", "additionalProperties": true, "properties": { "offers_prime": { "type": "boolean" }, "offers_free_shipping": { "type": "boolean" }, "offers_condition_new": { "type": "boolean" }, "offers_condition_used": { "type": "boolean" }, "offers_condition_used_like_new": { "type": "boolean" }, "offers_condition_used_very_good": { "type": "boolean" }, "offers_condition_used_good": { "type": "boolean" }, "offers_condition_used_acceptable": { "type": "boolean" } } } } }, "pagination": { "$ref": "#/$defs/OfferPagination" } }, "required": [ "offer" ] }, "Operation": { "type": "string", "enum": [ "DETAIL", "OFFER", "SIMILAR_PRODUCTS", "SEARCH", "PRODUCT_LOOKUP", "SELLER_PROFILE", "SELLER_PRODUCTS", "SELLER_FEEDBACK", "SALES_ANALYSIS_HISTORY", "BEST_SELLERS_RANK", "PACKAGE_DIMENSION" ], "description": "Exact, case-sensitive operation identifier." }, "PackageDimensionResult": { "type": "object", "additionalProperties": true, "properties": { "country_code": { "type": "string" }, "package": { "type": "object", "additionalProperties": true, "properties": { "dimensions": { "type": "object", "additionalProperties": true, "properties": { "height": { "type": "number" }, "length": { "type": "number" }, "unit": { "type": "string" }, "width": { "type": "number" } } }, "weight": { "type": "object", "additionalProperties": true, "properties": { "unit": { "type": "string" }, "value": { "type": "number" } } } } }, "product": { "type": "object", "additionalProperties": true, "properties": { "asin": { "type": "string" }, "brand": { "type": "string" }, "dimensions": { "type": "object", "additionalProperties": true, "properties": { "height": { "type": "number" }, "length": { "type": "number" }, "unit": { "type": "string" }, "width": { "type": "number" } } }, "fee_category": { "type": "string" }, "gl": { "type": "string" }, "link": { "type": "string" }, "main_image": { "type": "object", "additionalProperties": true, "properties": { "id": { "type": "string" }, "link": { "type": "string" } } }, "media": { "type": "object", "additionalProperties": true, "properties": { "image": { "type": "string" }, "thumbnail": { "type": "string" } } }, "thumb_image": { "type": "object", "additionalProperties": true, "properties": { "id": { "type": "string" }, "link": { "type": "string" } } }, "title": { "type": "string" }, "weight": { "type": "object", "additionalProperties": true, "properties": { "unit": { "type": "string" }, "value": { "type": "number" } } } } } }, "required": [ "package" ] }, "Platform": { "type": "string", "enum": [ "AMZ" ] }, "Price": { "type": "object", "properties": { "symbol": { "type": "string" }, "currency": { "type": "string" }, "raw": { "type": "string" }, "value": { "type": [ "string", "number" ], "description": "Parsed monetary amount; documented responses include strings and numbers." }, "is_rrp": { "type": "boolean" }, "is_free": { "type": "boolean" } }, "additionalProperties": true }, "ProcessingError": { "type": "object", "properties": { "error_code": { "type": "integer" }, "message": { "type": "string" } }, "additionalProperties": true }, "ProductLookupResult": { "type": "object", "properties": { "search_result": { "type": "object", "properties": { "products": { "type": "array", "items": { "type": "object", "properties": { "asin": { "type": "string" }, "brand": { "type": "string" }, "identifiers": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": true } }, "image_url": { "type": "string" }, "link": { "type": "string" }, "main_image": { "type": "object", "properties": { "id": { "type": "string" }, "link": { "type": "string" } }, "additionalProperties": true }, "manufacturer": { "type": "string" }, "model_number": { "type": "string" }, "thumb_image": { "type": "object", "properties": { "id": { "type": "string" }, "link": { "type": "string" } }, "additionalProperties": true }, "thumb_string_url": { "type": "string" }, "title": { "type": "string" } }, "additionalProperties": true } }, "total_product_count": { "type": "integer" } }, "additionalProperties": true }, "country_code": { "type": "string" } }, "additionalProperties": true, "required": [ "search_result" ] }, "QueryRecord": { "type": "object", "properties": { "id": { "type": "string" }, "bulk_request_id": { "type": "string" }, "group_id": { "type": "string" }, "account_id": { "type": "number" }, "status": { "type": "string", "enum": [ "pending", "success", "failure" ] }, "platform": { "$ref": "#/$defs/Platform" }, "operation": { "$ref": "#/$defs/Operation" }, "domain": { "$ref": "#/$defs/MarketplaceDomain" }, "payload": { "type": "object", "properties": {}, "additionalProperties": true }, "callback_url": { "type": "string", "format": "uri" }, "create_date": { "type": "string", "format": "date-time" }, "json_result": { "$ref": "#/$defs/BulkParsedEnvelope" }, "links": { "type": "array", "items": { "$ref": "#/$defs/DataLink" } } }, "additionalProperties": true, "required": [ "id", "status" ], "description": "pending has no json_result; success/failure are terminal. Results are available for at most 24 hours, sometimes less; retrieve and store promptly." }, "RequestInfo": { "type": "object", "properties": { "id": { "type": "string" }, "success": { "type": "boolean" }, "status_code": { "type": "integer", "description": "Upstream status; may be 0 when fetching or parsing failed." }, "error_details": { "type": "array", "items": { "$ref": "#/$defs/ProcessingError" } }, "address": { "$ref": "#/$defs/Address" }, "credits_used": { "type": "integer" }, "credit_used_this_request": { "type": "integer" }, "credits_used_this_request": { "type": "integer" }, "credits_remaining": { "type": "integer" }, "credits_reset_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "ResultInformation": { "type": "object", "properties": { "begin": { "type": "integer" }, "end": { "type": "integer" }, "raw": { "type": "string" }, "search_term": { "type": "string" }, "total_product_count": { "type": "integer" } }, "additionalProperties": true }, "SalesAnalysisAndHistoryResult": { "type": "object", "additionalProperties": true, "properties": { "product": { "type": "object", "additionalProperties": true, "properties": { "asin": { "type": "string" }, "main_asin": { "type": "string" }, "marketplace": { "type": "string" }, "name": { "type": "string" }, "brand": { "type": "string" }, "category": { "type": "string" }, "currency": { "type": "string" }, "age": { "type": "number" }, "image_url": { "type": "string" }, "launch_date": { "type": "string" }, "is_exact_match": { "type": "boolean" }, "product_type": { "type": "string" }, "product_type_id": { "type": "number" }, "gl_product_group": { "type": "number" }, "gl_product_group_desc": { "type": "string" }, "physical": { "type": "object", "additionalProperties": true, "properties": { "weight": { "type": "string" }, "weight_unit": { "type": "string" }, "height": { "type": "string" }, "length": { "type": "string" }, "dimension_unit": { "type": "string" } } }, "performance": { "type": "object", "additionalProperties": true, "properties": { "traffic": { "type": "object", "additionalProperties": true, "properties": { "total_views": { "type": "number" }, "views_last_30_days": { "type": "number" }, "views_previous_30_days": { "type": "number" }, "views_last_90_days": { "type": "number" }, "views_last_360_days": { "type": "number" }, "month_over_month_change": { "type": "number" }, "quarter_over_quarter_change": { "type": "number" } } }, "sales": { "type": "object", "additionalProperties": true, "properties": { "purchases_last_30_days": { "type": "number" }, "purchases_last_90_days": { "type": "number" }, "purchases_last_360_days": { "type": "number" } } } } }, "pricing": { "type": "object", "additionalProperties": true, "properties": { "average_price_last_90_days": { "type": "number" }, "average_price_last_360_days": { "type": "number" }, "offers": { "type": "object", "additionalProperties": true, "properties": { "total_offers_last_90_days": { "type": "number" }, "new_offer_average_depth": { "type": "number" }, "new_offer_min_price": { "type": "number" }, "new_offer_max_price": { "type": "number" } } }, "fees": { "type": "object", "additionalProperties": true, "properties": { "fba_fee_last_360_days": { "type": "number" }, "referral_fee_last_360_days": { "type": "number" } } } } }, "reviews_and_ranking": { "type": "object", "additionalProperties": true, "properties": { "reviews": { "type": "object", "additionalProperties": true, "properties": { "total_count": { "type": "number" }, "average_rating": { "type": "number" } } }, "ranking": { "type": "object", "additionalProperties": true, "properties": { "current_rank": { "type": "number" }, "average_rank": { "type": "number" }, "category": { "type": "string" } } } } } } }, "history": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "date": { "type": "string" }, "views": { "type": "number" }, "purchases": { "type": "number" }, "average_price": { "type": "number" }, "total_offers": { "type": "number" }, "best_seller_rank": { "type": "number" }, "review_count": { "type": "number" }, "review_rating": { "type": "number" } } } } }, "required": [ "product" ] }, "SearchPagination": { "type": "object", "properties": { "current_page": { "type": "integer" }, "current_page_link": { "type": "string" }, "last_visible_page": { "type": "integer" }, "next_page_link": { "type": "string" }, "result_count": { "type": "integer" }, "not_match": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true }, "SearchRefinementItems": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "heading_id": { "type": "string" }, "name": { "type": "string" }, "value": { "type": "string" }, "link": { "type": "string" }, "refinement_display_name": { "type": "string" } } } }, "SearchResult": { "type": "object", "additionalProperties": true, "properties": { "search_results": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "position": { "type": "integer" }, "title": { "type": "string" }, "asin": { "type": "string" }, "brand": { "type": "string" }, "link": { "type": "string" }, "image": { "type": "string" }, "is_sponsored": { "type": "boolean" }, "is_prime": { "type": "boolean" }, "rating_text": { "type": "string" }, "rating": { "type": "string" }, "ratings_total": { "type": "integer" }, "bought_activity": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" }, "value": { "type": "integer" }, "period": { "type": "string" }, "symbol": { "type": "string" } } }, "color_options": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" }, "additional_count": { "type": "integer" }, "total_count": { "type": "integer" } } }, "price": { "$ref": "#/$defs/Price" }, "prices": { "type": "array", "items": { "$ref": "#/$defs/Price" } }, "more_buying_choices": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" }, "min_offers_count": { "type": "integer" }, "link": { "type": "string" }, "price": { "$ref": "#/$defs/Price" } } }, "shipping_details": { "type": "string" }, "main_image": { "$ref": "#/$defs/Image" } } } }, "refinements": { "type": "object", "additionalProperties": true, "properties": { "customer_reviews": { "$ref": "#/$defs/SearchRefinementItems" }, "eligible_for_free_shipping": { "$ref": "#/$defs/SearchRefinementItems" }, "delivery_day": { "$ref": "#/$defs/SearchRefinementItems" }, "brands": { "$ref": "#/$defs/SearchRefinementItems" }, "price": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "heading_id": { "type": "string" }, "name": { "type": "string" }, "range": { "type": "string" }, "min_value": { "type": "string" }, "max_value": { "type": "string" }, "refinement_display_name": { "type": "string" } } } }, "deals_discounts": { "$ref": "#/$defs/SearchRefinementItems" }, "condition": { "$ref": "#/$defs/SearchRefinementItems" }, "seller": { "$ref": "#/$defs/SearchRefinementItems" }, "department": { "$ref": "#/$defs/SearchRefinementItems" }, "color": { "$ref": "#/$defs/SearchRefinementItems" }, "grade": { "$ref": "#/$defs/SearchRefinementItems" }, "premium_brands": { "$ref": "#/$defs/SearchRefinementItems" }, "moresustainable_products": { "$ref": "#/$defs/SearchRefinementItems" }, "subscription_options": { "$ref": "#/$defs/SearchRefinementItems" } } }, "related_searches": { "type": "array", "items": { "type": "object", "properties": { "query": { "type": "string" }, "link": { "type": "string" } }, "additionalProperties": true } }, "delivered_to": { "type": "string" }, "pagination": { "anyOf": [ { "$ref": "#/$defs/SearchPagination" }, { "type": "array", "items": { "$ref": "#/$defs/SearchPagination" } } ], "description": "One pagination object, or per-page entries when a range of pages is returned." }, "result_information": { "$ref": "#/$defs/ResultInformation" } }, "required": [ "search_results" ] }, "SellerFeedbackResult": { "type": "object", "additionalProperties": true, "properties": { "seller_feedback": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "body": { "type": "string" }, "date": { "type": "object", "additionalProperties": true, "properties": { "raw": { "type": "string" }, "timestamp": { "type": "integer" } } }, "has_response": { "type": "boolean" }, "profile": { "type": "object", "additionalProperties": true, "properties": { "avatar": { "type": "string" }, "url": { "type": "string" } } }, "rater": { "type": "string" }, "rating": { "type": "integer" } } } }, "pagination": { "anyOf": [ { "$ref": "#/$defs/FeedbackPagination" }, { "type": "array", "items": { "$ref": "#/$defs/FeedbackPagination" } } ] }, "not_match": { "type": "array", "items": {} } }, "required": [ "seller_feedback" ] }, "SellerProductsResult": { "type": "object", "properties": { "seller_products": { "type": "array", "items": { "type": "object", "properties": { "asin": { "type": "string" }, "brand": { "type": "string" }, "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "additionalProperties": true } }, "color_options": { "type": "object", "properties": { "additional_count": { "type": "integer" }, "raw": { "type": "string" }, "total_count": { "type": "integer" } }, "additionalProperties": true }, "image": { "type": "string" }, "main_image": { "$ref": "#/$defs/Image" }, "is_prime": { "type": "boolean" }, "is_sponsored": { "type": "boolean" }, "link": { "type": "string" }, "position": { "type": "integer" }, "price": { "$ref": "#/$defs/Price" }, "prices": { "type": "array", "items": { "$ref": "#/$defs/Price" } }, "product_type": { "type": "string" }, "rating": { "type": "string" }, "rating_text": { "type": "string" }, "ratings_total": { "type": "integer" }, "shipping_details": { "type": "string" }, "title": { "type": "string" }, "coupon_text": { "type": "string" } }, "additionalProperties": true } }, "refinements": { "type": "object", "properties": { "availability": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "refinement_display_name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": true } }, "condition": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "refinement_display_name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": true } }, "customer_reviews": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "refinement_display_name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": true } }, "deals_discounts": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "refinement_display_name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": true } }, "delivery_day": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "refinement_display_name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": true } }, "department": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "refinement_display_name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": true } }, "eligible_for_free_shipping": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "refinement_display_name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": true } }, "international_shipping": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "refinement_display_name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": true } }, "sustainability_features": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "refinement_display_name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": true } } }, "additionalProperties": true }, "pagination": { "anyOf": [ { "$ref": "#/$defs/SearchPagination" }, { "type": "array", "items": { "$ref": "#/$defs/SearchPagination" } } ], "description": "One pagination object, or per-page entries when a range of pages is returned." }, "result_information": { "$ref": "#/$defs/ResultInformation" }, "delivered_to": { "type": "string" } }, "additionalProperties": true, "required": [ "seller_products" ] }, "SellerProfileFeedbackPeriod": { "type": "object", "additionalProperties": true, "properties": { "1_star": { "type": "string" }, "2_star": { "type": "string" }, "3_star": { "type": "string" }, "4_star": { "type": "string" }, "5_star": { "type": "string" }, "count": { "type": "number" } } }, "SellerProfileResult": { "type": "object", "additionalProperties": true, "properties": { "seller_details": { "type": "object", "additionalProperties": true, "properties": { "business_address": { "type": "string" }, "business_address_rows": { "type": "array", "items": { "type": "string" } }, "business_country": { "type": "string" }, "business_name": { "type": "string" }, "detailed_information": { "type": "string" }, "logo": { "type": "string" }, "main_image": { "type": "object", "additionalProperties": true, "properties": { "id": { "type": "string" }, "link": { "type": "string" } } }, "name": { "type": "string" }, "rating": { "type": "number" }, "ratings_total": { "type": "number" }, "ratings_total_percentage": { "type": "number" }, "store_link": { "type": "string" } } }, "feedback_summary": { "type": "object", "additionalProperties": true, "properties": { "1_month": { "$ref": "#/$defs/SellerProfileFeedbackPeriod" }, "3_month": { "$ref": "#/$defs/SellerProfileFeedbackPeriod" }, "12_month": { "$ref": "#/$defs/SellerProfileFeedbackPeriod" }, "all_time": { "$ref": "#/$defs/SellerProfileFeedbackPeriod" } } }, "feedback": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "body": { "type": "string" }, "is_strikethrough": { "type": "boolean" }, "message_from_amazon": { "type": "string" }, "position": { "type": "number" }, "rater": { "type": "string" }, "rating": { "type": "string" } } } }, "not_match": { "type": "array", "items": { "type": "string" } }, "ask_a_question": { "type": "string" }, "country_code": { "type": "string" } }, "required": [ "seller_details" ] } } }