{ "openapi": "3.0.1", "info": { "title": "Selling Partner API for Catalog Items", "description": "Use the Selling Partner API for Catalog Items to retrieve information about items in the Amazon catalog.\n\nFor more information, refer to the [Catalog Items API Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/:catalog-items-api-v2022-04-01-use-case-guide).", "contact": { "name": "Selling Partner API Developer Support", "url": "https://sellercentral.amazon.com/gp/mws/contactus.html" }, "license": { "name": "Apache License 2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0" }, "version": "2022-04-01" }, "servers": [ { "url": "https://sellingpartnerapi-na.amazon.com/" } ], "paths": { "/catalog/2022-04-01/items": { "get": { "tags": [ "CatalogItemsV20220401" ], "description": "Search for a list of Amazon catalog items and item-related information. You can search by identifier or by keywords.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 2 |\n\nThe `x-amzn-RateLimit-Limit` response header contains the usage plan rate limits for the operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput might have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).", "operationId": "searchCatalogItems", "parameters": [ { "name": "identifiers", "in": "query", "description": "A comma-delimited list of product identifiers that you can use to search the Amazon catalog. **Note:** You cannot include `identifiers` and `keywords` in the same request.", "style": "form", "explode": false, "schema": { "maxItems": 20, "type": "array", "items": { "type": "string" } }, "example": "shoes" }, { "name": "identifiersType", "in": "query", "description": "The type of product identifiers that you can use to search the Amazon catalog. **Note:** `identifiersType` is required when `identifiers` is in the request.", "schema": { "type": "string", "enum": [ "ASIN", "EAN", "GTIN", "ISBN", "JAN", "MINSAN", "SKU", "UPC" ], "x-docgen-enum-table-extension": [ { "value": "ASIN", "description": "Amazon Standard Identification Number" }, { "value": "EAN", "description": "European Article Number" }, { "value": "GTIN", "description": "Global Trade Item Number" }, { "value": "ISBN", "description": "International Standard Book Number" }, { "value": "JAN", "description": "Japanese Article Number" }, { "value": "MINSAN", "description": "Minsan Code" }, { "value": "SKU", "description": "Stock Keeping Unit, a seller-specified identifier for an Amazon listing. **Note:** Must be accompanied by `sellerId`." }, { "value": "UPC", "description": "Universal Product Code" } ] }, "example": "ASIN", "x-docgen-enum-table-extension": [ { "value": "ASIN", "description": "Amazon Standard Identification Number" }, { "value": "EAN", "description": "European Article Number" }, { "value": "GTIN", "description": "Global Trade Item Number" }, { "value": "ISBN", "description": "International Standard Book Number" }, { "value": "JAN", "description": "Japanese Article Number" }, { "value": "MINSAN", "description": "Minsan Code" }, { "value": "SKU", "description": "Stock Keeping Unit, a seller-specified identifier for an Amazon listing. **Note:** Must be accompanied by `sellerId`." }, { "value": "UPC", "description": "Universal Product Code" } ] }, { "name": "marketplaceIds", "in": "query", "description": "A comma-delimited list of Amazon marketplace identifiers. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).", "required": true, "style": "form", "explode": false, "schema": { "maxItems": 1, "type": "array", "items": { "type": "string" } }, "example": "ATVPDKIKX0DER" }, { "name": "includedData", "in": "query", "description": "A comma-delimited list of datasets to include in the response.", "style": "form", "explode": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "attributes", "classifications", "dimensions", "identifiers", "images", "productTypes", "relationships", "salesRanks", "summaries", "vendorDetails" ], "x-docgen-enum-table-extension": [ { "value": "attributes", "description": "A JSON object containing structured item attribute data that is keyed by attribute name. Catalog item attributes conform to the related Amazon product type definitions that you can get from the [Product Type Definitions API](https://developer-docs.amazon.com/sp-api/reference/product-type-definitions-v2020-09-01)." }, { "value": "classifications", "description": "Classifications (browse nodes) for an item in the Amazon catalog." }, { "value": "dimensions", "description": "Dimensions of an item in the Amazon catalog." }, { "value": "identifiers", "description": "Identifiers that are associated with the item in the Amazon catalog, such as UPC and EAN." }, { "value": "images", "description": "Images for an item in the Amazon catalog." }, { "value": "productTypes", "description": "Product types associated with the Amazon catalog item." }, { "value": "relationships", "description": "Relationship details of an Amazon catalog item (for example, variations)." }, { "value": "salesRanks", "description": "Sales ranks of an Amazon catalog item." }, { "value": "summaries", "description": "Summary of an Amazon catalog item. For more information, refer to the `attributes` of an Amazon catalog item." }, { "value": "vendorDetails", "description": "Vendor details associated with an Amazon catalog item. Vendor details are only available to vendors." } ] }, "default": "[\"summaries\"]" }, "example": "summaries" }, { "name": "locale", "in": "query", "description": "The locale for which you want to retrieve localized summaries. Defaults to the primary locale of the marketplace.", "schema": { "type": "string" }, "example": "en_US" }, { "name": "sellerId", "in": "query", "description": "A selling partner identifier, such as a seller account or vendor code. **Note:** Required when `identifiersType` is `SKU`.", "schema": { "type": "string" } }, { "name": "keywords", "in": "query", "description": "A comma-delimited list of keywords that you can use to search the Amazon catalog. **Note:** You cannot include `keywords` and `identifiers` in the same request.", "style": "form", "explode": false, "schema": { "maxItems": 20, "type": "array", "items": { "type": "string" } }, "example": "shoes" }, { "name": "brandNames", "in": "query", "description": "A comma-delimited list of brand names that you can use to limit the search in queries based on `keywords`. **Note:** Cannot be used with `identifiers`.", "style": "form", "explode": false, "schema": { "type": "array", "items": { "type": "string" } }, "example": "Beautiful Boats" }, { "name": "classificationIds", "in": "query", "description": "A comma-delimited list of classification identifiers that you can use to limit the search in queries based on `keywords`. **Note:** Cannot be used with `identifiers`.", "style": "form", "explode": false, "schema": { "type": "array", "items": { "type": "string" } }, "example": "12345678" }, { "name": "pageSize", "in": "query", "description": "The number of results to include on each page.", "schema": { "maximum": 20, "type": "integer", "default": 10 }, "example": 9 }, { "name": "pageToken", "in": "query", "description": "A token that you can use to fetch a specific page when there are multiple pages of results.", "schema": { "type": "string" }, "example": "sdlkj234lkj234lksjdflkjwdflkjsfdlkj234234234234" }, { "name": "keywordsLocale", "in": "query", "description": "The language of the keywords that are included in queries based on `keywords`. Defaults to the primary locale of the marketplace. **Note:** Cannot be used with `identifiers`.", "schema": { "type": "string" }, "example": "en_US" } ], "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ItemSearchResults" }, "example": { "numberOfResults": 1, "pagination": { "nextToken": "xsdflkj324lkjsdlkj3423klkjsdfkljlk2j34klj2l3k4jlksdjl234", "previousToken": "ilkjsdflkj234lkjds234234lkjl234lksjdflkj234234lkjsfsdflkj333d" }, "refinements": { "brands": [ { "numberOfResults": 1, "brandName": "SAMSUNG" } ], "classifications": [ { "numberOfResults": 1, "displayName": "Electronics", "classificationId": "493964" } ] }, "items": [ { "asin": "B07N4M94X4", "attributes": { "total_hdmi_ports": [ { "value": 4, "marketplace_id": "ATVPDKIKX0DER" } ], "resolution": [ { "language_tag": "en_US", "value": "4K", "marketplace_id": "ATVPDKIKX0DER" } ], "item_weight": [ { "unit": "pounds", "value": 107.6, "marketplace_id": "ATVPDKIKX0DER" } ], "product_subcategory": [ { "value": "50400120", "marketplace_id": "ATVPDKIKX0DER" } ], "bullet_point": [ { "language_tag": "en_US", "value": "SMART TV WITH UNIVERSAL GUIDE: Simple on-screen Guide is an easy way to find streaming content and live TV shows", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "100% COLOR VOLUME WITH QUANTUM DOTS: Powered by Quantum dots, Samsung\u2019s 4K QLED TV offers over a billion shades of brilliant color and 100% color volume for exceptional depth of detail that will draw you in to the picture for the best 4K TV experience", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "QUANTUM PROCESSOR 4K: Intelligently powered processor instantly upscales content to 4K for sharp detail and refined color", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "QUANTUM HDR 4X: 4K depth of detail with high dynamic range powered by HDR10+ delivers the lightest to darkest colors, scene by scene, for amazing picture realism", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "AMBIENT MODE: Customizes and complements your living space by turning a blank screen of this big screen TV into enticing visuals including d\u00e9cor, info, photos and artwork", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "SMART TV FEATURES: OneRemote to control all compatible devices, Bixby voice command, on-screen universal guide, SmartThings to control compatible home appliances and devices, smart speaker expandability with Alexa and Google Assistant compatibility, and more", "marketplace_id": "ATVPDKIKX0DER" } ], "item_dimensions": [ { "width": { "unit": "inches", "value": 72.4 }, "length": { "unit": "inches", "value": 2.4 }, "height": { "unit": "inches", "value": 41.4 }, "marketplace_id": "ATVPDKIKX0DER" } ], "brand": [ { "language_tag": "en_US", "value": "SAMSUNG", "marketplace_id": "ATVPDKIKX0DER" } ], "control_method": [ { "value": "voice", "marketplace_id": "ATVPDKIKX0DER" } ], "item_package_dimensions": [ { "length": { "unit": "centimeters", "value": 26.67 }, "width": { "unit": "centimeters", "value": 121.92 }, "height": { "unit": "centimeters", "value": 203.2 }, "marketplace_id": "ATVPDKIKX0DER" } ], "image_aspect_ratio": [ { "language_tag": "en_US", "value": "16:9", "marketplace_id": "ATVPDKIKX0DER" } ], "part_number": [ { "value": "QN82Q60RAFXZA", "marketplace_id": "ATVPDKIKX0DER" } ], "includes_remote": [ { "value": true, "marketplace_id": "ATVPDKIKX0DER" } ], "style": [ { "language_tag": "en_US", "value": "TV only", "marketplace_id": "ATVPDKIKX0DER" } ], "item_type_name": [ { "language_tag": "en_US", "value": "TV", "marketplace_id": "ATVPDKIKX0DER" } ], "battery": [ { "cell_composition": [ { "value": "alkaline" } ], "marketplace_id": "ATVPDKIKX0DER" } ], "image_contrast_ratio": [ { "language_tag": "en_US", "value": "QLED 4K", "marketplace_id": "ATVPDKIKX0DER" } ], "manufacturer": [ { "language_tag": "en_US", "value": "Samsung", "marketplace_id": "ATVPDKIKX0DER" } ], "number_of_boxes": [ { "value": 1, "marketplace_id": "ATVPDKIKX0DER" } ], "total_usb_ports": [ { "value": 2, "marketplace_id": "ATVPDKIKX0DER" } ], "model_number": [ { "value": "QN82Q60RAFXZA", "marketplace_id": "ATVPDKIKX0DER" } ], "supplier_declared_dg_hz_regulation": [ { "value": "not_applicable", "marketplace_id": "ATVPDKIKX0DER" } ], "num_batteries": [ { "quantity": 2, "type": "aaa", "marketplace_id": "ATVPDKIKX0DER" } ], "california_proposition_65": [ { "compliance_type": "on_product_combined_cancer_reproductive", "marketplace_id": "ATVPDKIKX0DER" }, { "compliance_type": "chemical", "chemical_names": [ "di_2_ethylhexyl_phthalate_dehp" ], "marketplace_id": "ATVPDKIKX0DER" } ], "display": [ { "resolution_maximum": [ { "unit": "pixels", "language_tag": "en_US", "value": "3840 x 2160" } ], "size": [ { "unit": "inches", "value": 82 } ], "type": [ { "language_tag": "en_US", "value": "QLED" } ], "marketplace_id": "ATVPDKIKX0DER" } ], "item_name": [ { "language_tag": "en_US", "value": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility", "marketplace_id": "ATVPDKIKX0DER" } ], "list_price": [ { "currency": "USD", "value": 3799.99, "marketplace_id": "ATVPDKIKX0DER" } ], "batteries_required": [ { "value": false, "marketplace_id": "ATVPDKIKX0DER" } ], "includes_rechargable_battery": [ { "value": false, "marketplace_id": "ATVPDKIKX0DER" } ], "product_site_launch_date": [ { "value": "2019-03-11T08:00:01.000Z", "marketplace_id": "ATVPDKIKX0DER" } ], "product_category": [ { "value": "50400100", "marketplace_id": "ATVPDKIKX0DER" } ], "batteries_included": [ { "value": false, "marketplace_id": "ATVPDKIKX0DER" } ], "connectivity_technology": [ { "language_tag": "en_US", "value": "Bluetooth", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "USB", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Wireless", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "HDMI", "marketplace_id": "ATVPDKIKX0DER" } ], "included_components": [ { "language_tag": "en_US", "value": "QLED Standard Smart Remote", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Power Cable", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Stand", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Samsung Smart Control", "marketplace_id": "ATVPDKIKX0DER" } ], "specification_met": [ { "language_tag": "en_US", "value": "", "marketplace_id": "ATVPDKIKX0DER" } ], "parental_control_technology": [ { "value": "V-Chip", "marketplace_id": "ATVPDKIKX0DER" } ], "power_consumption": [ { "unit": "watts", "value": 120, "marketplace_id": "ATVPDKIKX0DER" } ], "cpsia_cautionary_statement": [ { "value": "no_warning_applicable", "marketplace_id": "ATVPDKIKX0DER" } ], "item_type_keyword": [ { "value": "qled-televisions", "marketplace_id": "ATVPDKIKX0DER" } ], "number_of_items": [ { "value": 1, "marketplace_id": "ATVPDKIKX0DER" } ], "warranty_description": [ { "language_tag": "en_US", "value": "1 year manufacturer", "marketplace_id": "ATVPDKIKX0DER" } ], "max_resolution": [ { "unit": "pixels", "value": 8.3, "marketplace_id": "ATVPDKIKX0DER" } ], "color": [ { "language_tag": "en_US", "value": "Black", "marketplace_id": "ATVPDKIKX0DER" } ], "screen_surface_description": [ { "language_tag": "en_US", "value": "Flat", "marketplace_id": "ATVPDKIKX0DER" } ], "item_package_weight": [ { "unit": "kilograms", "value": 62.142, "marketplace_id": "ATVPDKIKX0DER" } ], "speaker_type": [ { "language_tag": "en_US", "value": "2CH", "marketplace_id": "ATVPDKIKX0DER" } ], "supported_internet_services": [ { "language_tag": "en_US", "value": "Amazon Instant Video", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "YouTube", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Netflix", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Hulu", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Browser", "marketplace_id": "ATVPDKIKX0DER" } ], "tuner_technology": [ { "language_tag": "en_US", "value": "Analog Tuner", "marketplace_id": "ATVPDKIKX0DER" } ], "controller_type": [ { "language_tag": "en_US", "value": "SmartThings", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Voice Control", "marketplace_id": "ATVPDKIKX0DER" } ], "special_feature": [ { "language_tag": "en_US", "value": "100% Color Volume with Quantum Dot; Quantum Processor 4K; Ambient Mode; Quantum HDR 4X; Real Game Enhancer", "marketplace_id": "ATVPDKIKX0DER" } ], "wireless_communication_technology": [ { "language_tag": "en_US", "value": "Wi-Fi::Wi-Fi Direct::Bluetooth", "marketplace_id": "ATVPDKIKX0DER" } ], "model_year": [ { "value": 2019, "marketplace_id": "ATVPDKIKX0DER" } ], "power_source_type": [ { "language_tag": "en_US", "value": "Corded Electric", "marketplace_id": "ATVPDKIKX0DER" } ], "street_date": [ { "value": "2019-03-21T00:00:01Z", "marketplace_id": "ATVPDKIKX0DER" } ], "mounting_type": [ { "language_tag": "en_US", "value": "Table Mount", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Wall Mount", "marketplace_id": "ATVPDKIKX0DER" } ], "refresh_rate": [ { "unit": "hertz", "language_tag": "en_US", "value": "120", "marketplace_id": "ATVPDKIKX0DER" } ] }, "classifications": [ { "marketplaceId": "ATVPDKIKX0DER", "classifications": [ { "displayName": "QLED TVs", "classificationId": "21489946011", "parent": { "displayName": "Televisions", "classificationId": "172659", "parent": { "displayName": "Television & Video", "classificationId": "1266092011", "parent": { "displayName": "Electronics", "classificationId": "172282" } } } } ] } ], "dimensions": [ { "marketplaceId": "ATVPDKIKX0DER", "item": { "height": { "unit": "inches", "value": 41.4 }, "length": { "unit": "inches", "value": 2.4 }, "weight": { "unit": "pounds", "value": 107.6 }, "width": { "unit": "inches", "value": 72.4 } }, "package": { "height": { "unit": "inches", "value": 10.49999998929 }, "length": { "unit": "inches", "value": 79.9999999184 }, "weight": { "unit": "kilograms", "value": 62.142 }, "width": { "unit": "inches", "value": 47.99999995104 } } } ], "identifiers": [ { "marketplaceId": "ATVPDKIKX0DER", "identifiers": [ { "identifier": "0887276302195", "identifierType": "EAN" }, { "identifier": "00887276302195", "identifierType": "GTIN" }, { "identifier": "887276302195", "identifierType": "UPC" } ] } ], "images": [ { "marketplaceId": "ATVPDKIKX0DER", "images": [ { "variant": "MAIN", "link": "https://m.media-amazon.com/images/I/91uohwV+k3L.jpg", "height": 1707, "width": 2560 }, { "variant": "MAIN", "link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg", "height": 333, "width": 500 }, { "variant": "PT01", "link": "https://m.media-amazon.com/images/I/81w2rTVShlL.jpg", "height": 2560, "width": 2560 }, { "variant": "PT01", "link": "https://m.media-amazon.com/images/I/41Px9eq9tkL.jpg", "height": 500, "width": 500 }, { "variant": "PT02", "link": "https://m.media-amazon.com/images/I/51NTNhdhPyL.jpg", "height": 375, "width": 500 }, { "variant": "PT03", "link": "https://m.media-amazon.com/images/I/51o4zpL+A3L.jpg", "height": 375, "width": 500 }, { "variant": "PT04", "link": "https://m.media-amazon.com/images/I/71ux2k9GAZL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT04", "link": "https://m.media-amazon.com/images/I/61UUX63yw1L.jpg", "height": 500, "width": 500 }, { "variant": "PT05", "link": "https://m.media-amazon.com/images/I/61LwHkljX-L.jpg", "height": 1000, "width": 1000 }, { "variant": "PT05", "link": "https://m.media-amazon.com/images/I/51wJTQty3PL.jpg", "height": 500, "width": 500 }, { "variant": "PT06", "link": "https://m.media-amazon.com/images/I/61uvoB4VvoL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT06", "link": "https://m.media-amazon.com/images/I/51ZexIO628L.jpg", "height": 500, "width": 500 }, { "variant": "PT07", "link": "https://m.media-amazon.com/images/I/7121MGd2ncL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT07", "link": "https://m.media-amazon.com/images/I/61QK+JBMrGL.jpg", "height": 500, "width": 500 }, { "variant": "PT08", "link": "https://m.media-amazon.com/images/I/61ECcGlG4IL.jpg", "height": 1080, "width": 1920 }, { "variant": "PT08", "link": "https://m.media-amazon.com/images/I/31TxwfqvB5L.jpg", "height": 281, "width": 500 } ] } ], "productTypes": [ { "marketplaceId": "ATVPDKIKX0DER", "productType": "TELEVISION" } ], "salesRanks": [ { "marketplaceId": "ATVPDKIKX0DER", "classificationRanks": [ { "classificationId": "21489946011", "title": "QLED TVs", "link": "http://www.amazon.com/gp/bestsellers/electronics/21489946011", "rank": 113 } ], "displayGroupRanks": [ { "websiteDisplayGroup": "ce_display_on_website", "title": "Electronics", "link": "http://www.amazon.com/gp/bestsellers/electronics", "rank": 72855 } ] } ], "summaries": [ { "marketplaceId": "ATVPDKIKX0DER", "brand": "SAMSUNG", "browseClassification": { "displayName": "QLED TVs", "classificationId": "21489946011" }, "color": "Black", "itemClassification": "BASE_PRODUCT", "itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility", "manufacturer": "Samsung", "modelNumber": "QN82Q60RAFXZA", "packageQuantity": 1, "partNumber": "QN82Q60RAFXZA", "size": "82-Inch", "style": "TV only", "websiteDisplayGroup": "home_theater_display_on_website", "websiteDisplayGroupName": "Home Theater" } ], "relationships": [ { "marketplaceId": "ATVPDKIKX0DER", "relationships": [ { "type": "VARIATION", "parentAsins": [ "B08J7TQ9FL" ], "variationTheme": { "attributes": [ "color", "size" ], "theme": "SIZE_NAME/COLOR_NAME" } } ] } ], "vendorDetails": [ { "marketplaceId": "ATVPDKIKX0DER", "brandCode": "SAMF9", "manufacturerCode": "SAMF9", "manufacturerCodeParent": "SAMF9", "productCategory": { "displayName": "Televisions", "value": "50400100" }, "productGroup": "Home Entertainment", "productSubcategory": { "displayName": "Plasma TVs", "value": "50400120" }, "replenishmentCategory": "OBSOLETE" } ] } ] } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "keywords": { "value": [ "samsung", "tv" ] }, "marketplaceIds": { "value": [ "ATVPDKIKX0DER" ] }, "includedData": { "value": [ "classifications", "dimensions", "identifiers", "images", "productTypes", "relationships", "salesRanks", "summaries", "vendorDetails" ] } } }, "response": { "numberOfResults": 1, "pagination": { "nextToken": "xsdflkj324lkjsdlkj3423klkjsdfkljlk2j34klj2l3k4jlksdjl234", "previousToken": "ilkjsdflkj234lkjds234234lkjl234lksjdflkj234234lkjsfsdflkj333d" }, "refinements": { "brands": [ { "numberOfResults": 1, "brandName": "SAMSUNG" } ], "classifications": [ { "numberOfResults": 1, "displayName": "Electronics", "classificationId": "493964" } ] }, "items": [ { "asin": "B07N4M94X4", "classifications": [ { "marketplaceId": "ATVPDKIKX0DER", "classifications": [ { "displayName": "QLED TVs", "classificationId": "21489946011", "parent": { "displayName": "Televisions", "classificationId": "172659", "parent": { "displayName": "Television & Video", "classificationId": "1266092011", "parent": { "displayName": "Electronics", "classificationId": "172282" } } } } ] } ], "dimensions": [ { "marketplaceId": "ATVPDKIKX0DER", "item": { "height": { "unit": "inches", "value": 41.4 }, "length": { "unit": "inches", "value": 2.4 }, "weight": { "unit": "pounds", "value": 107.6 }, "width": { "unit": "inches", "value": 72.4 } }, "package": { "height": { "unit": "inches", "value": 10.49999998929 }, "length": { "unit": "inches", "value": 79.9999999184 }, "weight": { "unit": "kilograms", "value": 62.142 }, "width": { "unit": "inches", "value": 47.99999995104 } } } ], "identifiers": [ { "marketplaceId": "ATVPDKIKX0DER", "identifiers": [ { "identifier": "0887276302195", "identifierType": "EAN" }, { "identifier": "00887276302195", "identifierType": "GTIN" }, { "identifier": "887276302195", "identifierType": "UPC" } ] } ], "images": [ { "marketplaceId": "ATVPDKIKX0DER", "images": [ { "variant": "MAIN", "link": "https://m.media-amazon.com/images/I/91uohwV+k3L.jpg", "height": 1707, "width": 2560 }, { "variant": "MAIN", "link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg", "height": 333, "width": 500 }, { "variant": "PT01", "link": "https://m.media-amazon.com/images/I/81w2rTVShlL.jpg", "height": 2560, "width": 2560 }, { "variant": "PT01", "link": "https://m.media-amazon.com/images/I/41Px9eq9tkL.jpg", "height": 500, "width": 500 }, { "variant": "PT02", "link": "https://m.media-amazon.com/images/I/51NTNhdhPyL.jpg", "height": 375, "width": 500 }, { "variant": "PT03", "link": "https://m.media-amazon.com/images/I/51o4zpL+A3L.jpg", "height": 375, "width": 500 }, { "variant": "PT04", "link": "https://m.media-amazon.com/images/I/71ux2k9GAZL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT04", "link": "https://m.media-amazon.com/images/I/61UUX63yw1L.jpg", "height": 500, "width": 500 }, { "variant": "PT05", "link": "https://m.media-amazon.com/images/I/61LwHkljX-L.jpg", "height": 1000, "width": 1000 }, { "variant": "PT05", "link": "https://m.media-amazon.com/images/I/51wJTQty3PL.jpg", "height": 500, "width": 500 }, { "variant": "PT06", "link": "https://m.media-amazon.com/images/I/61uvoB4VvoL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT06", "link": "https://m.media-amazon.com/images/I/51ZexIO628L.jpg", "height": 500, "width": 500 }, { "variant": "PT07", "link": "https://m.media-amazon.com/images/I/7121MGd2ncL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT07", "link": "https://m.media-amazon.com/images/I/61QK+JBMrGL.jpg", "height": 500, "width": 500 }, { "variant": "PT08", "link": "https://m.media-amazon.com/images/I/61ECcGlG4IL.jpg", "height": 1080, "width": 1920 }, { "variant": "PT08", "link": "https://m.media-amazon.com/images/I/31TxwfqvB5L.jpg", "height": 281, "width": 500 } ] } ], "productTypes": [ { "marketplaceId": "ATVPDKIKX0DER", "productType": "TELEVISION" } ], "salesRanks": [ { "marketplaceId": "ATVPDKIKX0DER", "classificationRanks": [ { "classificationId": "21489946011", "title": "QLED TVs", "link": "http://www.amazon.com/gp/bestsellers/electronics/21489946011", "rank": 113 } ], "displayGroupRanks": [ { "websiteDisplayGroup": "ce_display_on_website", "title": "Electronics", "link": "http://www.amazon.com/gp/bestsellers/electronics", "rank": 72855 } ] } ], "summaries": [ { "marketplaceId": "ATVPDKIKX0DER", "brand": "SAMSUNG", "browseClassification": { "displayName": "QLED TVs", "classificationId": "21489946011" }, "color": "Black", "itemClassification": "BASE_PRODUCT", "itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility", "manufacturer": "Samsung", "modelNumber": "QN82Q60RAFXZA", "packageQuantity": 1, "partNumber": "QN82Q60RAFXZA", "size": "82-Inch", "style": "TV only", "websiteDisplayGroup": "home_theater_display_on_website", "websiteDisplayGroupName": "Home Theater" } ], "relationships": [ { "marketplaceId": "ATVPDKIKX0DER", "relationships": [ { "type": "VARIATION", "parentAsins": [ "B08J7TQ9FL" ], "variationTheme": { "attributes": [ "color", "size" ], "theme": "SIZE_NAME/COLOR_NAME" } } ] } ], "vendorDetails": [ { "marketplaceId": "ATVPDKIKX0DER", "brandCode": "SAMF9", "manufacturerCode": "SAMF9", "manufacturerCodeParent": "SAMF9", "productCategory": { "displayName": "Televisions", "value": "50400100" }, "productGroup": "Home Entertainment", "productSubcategory": { "displayName": "Plasma TVs", "value": "50400120" }, "replenishmentCategory": "OBSOLETE" } ] } ] } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "keywords": { "value": [ "samsung", "tv" ] }, "marketplaceIds": { "value": [ "" ] }, "includedData": { "value": [ "classifications", "dimensions", "identifiers", "images", "productTypes", "relationships", "salesRanks", "summaries", "vendorDetails" ] } } }, "response": { "errors": [ { "code": "400", "message": "Request has missing or invalid parameters and cannot be parsed." } ] } } ] } }, "403": { "description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "413": { "description": "The request size exceeded the maximum accepted size.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "415": { "description": "The request payload is in an unsupported format.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "500": { "description": "An unexpected condition occurred that prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } } } } }, "/catalog/2022-04-01/items/{asin}": { "get": { "tags": [ "CatalogItemsV20220401" ], "description": "Retrieves details for an item in the Amazon catalog.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 2 |\n\nThe `x-amzn-RateLimit-Limit` response header contains the usage plan rate limits for the operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput might have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).", "operationId": "getCatalogItem", "parameters": [ { "name": "asin", "in": "path", "description": "The Amazon Standard Identification Number (ASIN) of the item.", "required": true, "schema": { "type": "string" } }, { "name": "marketplaceIds", "in": "query", "description": "A comma-delimited list of Amazon marketplace identifiers. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).", "required": true, "style": "form", "explode": false, "schema": { "type": "array", "items": { "type": "string" } }, "example": "ATVPDKIKX0DER" }, { "name": "includedData", "in": "query", "description": "A comma-delimited list of datasets to include in the response.", "style": "form", "explode": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "attributes", "classifications", "dimensions", "identifiers", "images", "productTypes", "relationships", "salesRanks", "summaries", "vendorDetails" ], "x-docgen-enum-table-extension": [ { "value": "attributes", "description": "A JSON object containing structured item attribute data that is keyed by attribute name. Catalog item attributes conform to the related Amazon product type definitions that you can get from the [Product Type Definitions API](https://developer-docs.amazon.com/sp-api/reference/product-type-definitions-v2020-09-01)." }, { "value": "classifications", "description": "Classifications (browse nodes) for an item in the Amazon catalog." }, { "value": "dimensions", "description": "Dimensions of an item in the Amazon catalog." }, { "value": "identifiers", "description": "Identifiers that are associated with the item in the Amazon catalog, such as UPC and EA." }, { "value": "images", "description": "Images for an item in the Amazon catalog." }, { "value": "productTypes", "description": "Product types associated with the Amazon catalog item." }, { "value": "salesRanks", "description": "Sales ranks of an Amazon catalog item." }, { "value": "summaries", "description": "Summary of an Amazon catalog item. For more information, refer to the `attributes` of an Amazon catalog item." }, { "value": "relationships", "description": "Relationship details of an Amazon catalog item (for example, variations)." }, { "value": "vendorDetails", "description": "Vendor details associated with an Amazon catalog item. Vendor details are only available to vendors." } ] }, "default": "[\"summaries\"]" }, "example": "summaries" }, { "name": "locale", "in": "query", "description": "The locale for which you want to retrieve localized summaries. Defaults to the primary locale of the marketplace.", "schema": { "type": "string" }, "example": "en_US" } ], "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Item" }, "example": { "asin": "B07N4M94X4", "attributes": { "total_hdmi_ports": [ { "value": 4, "marketplace_id": "ATVPDKIKX0DER" } ], "resolution": [ { "language_tag": "en_US", "value": "4K", "marketplace_id": "ATVPDKIKX0DER" } ], "item_weight": [ { "unit": "pounds", "value": 107.6, "marketplace_id": "ATVPDKIKX0DER" } ], "product_subcategory": [ { "value": "50400120", "marketplace_id": "ATVPDKIKX0DER" } ], "bullet_point": [ { "language_tag": "en_US", "value": "SMART TV WITH UNIVERSAL GUIDE: Simple on-screen Guide is an easy way to find streaming content and live TV shows", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "100% COLOR VOLUME WITH QUANTUM DOTS: Powered by Quantum dots, Samsung\u2019s 4K QLED TV offers over a billion shades of brilliant color and 100% color volume for exceptional depth of detail that will draw you in to the picture for the best 4K TV experience", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "QUANTUM PROCESSOR 4K: Intelligently powered processor instantly upscales content to 4K for sharp detail and refined color", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "QUANTUM HDR 4X: 4K depth of detail with high dynamic range powered by HDR10+ delivers the lightest to darkest colors, scene by scene, for amazing picture realism", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "AMBIENT MODE: Customizes and complements your living space by turning a blank screen of this big screen TV into enticing visuals including d\u00e9cor, info, photos and artwork", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "SMART TV FEATURES: OneRemote to control all compatible devices, Bixby voice command, on-screen universal guide, SmartThings to control compatible home appliances and devices, smart speaker expandability with Alexa and Google Assistant compatibility, and more", "marketplace_id": "ATVPDKIKX0DER" } ], "item_dimensions": [ { "width": { "unit": "inches", "value": 72.4 }, "length": { "unit": "inches", "value": 2.4 }, "height": { "unit": "inches", "value": 41.4 }, "marketplace_id": "ATVPDKIKX0DER" } ], "brand": [ { "language_tag": "en_US", "value": "SAMSUNG", "marketplace_id": "ATVPDKIKX0DER" } ], "control_method": [ { "value": "voice", "marketplace_id": "ATVPDKIKX0DER" } ], "item_package_dimensions": [ { "length": { "unit": "centimeters", "value": 26.67 }, "width": { "unit": "centimeters", "value": 121.92 }, "height": { "unit": "centimeters", "value": 203.2 }, "marketplace_id": "ATVPDKIKX0DER" } ], "image_aspect_ratio": [ { "language_tag": "en_US", "value": "16:9", "marketplace_id": "ATVPDKIKX0DER" } ], "part_number": [ { "value": "QN82Q60RAFXZA", "marketplace_id": "ATVPDKIKX0DER" } ], "includes_remote": [ { "value": true, "marketplace_id": "ATVPDKIKX0DER" } ], "style": [ { "language_tag": "en_US", "value": "TV only", "marketplace_id": "ATVPDKIKX0DER" } ], "item_type_name": [ { "language_tag": "en_US", "value": "TV", "marketplace_id": "ATVPDKIKX0DER" } ], "battery": [ { "cell_composition": [ { "value": "alkaline" } ], "marketplace_id": "ATVPDKIKX0DER" } ], "image_contrast_ratio": [ { "language_tag": "en_US", "value": "QLED 4K", "marketplace_id": "ATVPDKIKX0DER" } ], "manufacturer": [ { "language_tag": "en_US", "value": "Samsung", "marketplace_id": "ATVPDKIKX0DER" } ], "number_of_boxes": [ { "value": 1, "marketplace_id": "ATVPDKIKX0DER" } ], "total_usb_ports": [ { "value": 2, "marketplace_id": "ATVPDKIKX0DER" } ], "model_number": [ { "value": "QN82Q60RAFXZA", "marketplace_id": "ATVPDKIKX0DER" } ], "supplier_declared_dg_hz_regulation": [ { "value": "not_applicable", "marketplace_id": "ATVPDKIKX0DER" } ], "num_batteries": [ { "quantity": 2, "type": "aaa", "marketplace_id": "ATVPDKIKX0DER" } ], "california_proposition_65": [ { "compliance_type": "on_product_combined_cancer_reproductive", "marketplace_id": "ATVPDKIKX0DER" }, { "compliance_type": "chemical", "chemical_names": [ "di_2_ethylhexyl_phthalate_dehp" ], "marketplace_id": "ATVPDKIKX0DER" } ], "display": [ { "resolution_maximum": [ { "unit": "pixels", "language_tag": "en_US", "value": "3840 x 2160" } ], "size": [ { "unit": "inches", "value": 82 } ], "type": [ { "language_tag": "en_US", "value": "QLED" } ], "marketplace_id": "ATVPDKIKX0DER" } ], "item_name": [ { "language_tag": "en_US", "value": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility", "marketplace_id": "ATVPDKIKX0DER" } ], "list_price": [ { "currency": "USD", "value": 3799.99, "marketplace_id": "ATVPDKIKX0DER" } ], "batteries_required": [ { "value": false, "marketplace_id": "ATVPDKIKX0DER" } ], "includes_rechargable_battery": [ { "value": false, "marketplace_id": "ATVPDKIKX0DER" } ], "product_site_launch_date": [ { "value": "2019-03-11T08:00:01.000Z", "marketplace_id": "ATVPDKIKX0DER" } ], "product_category": [ { "value": "50400100", "marketplace_id": "ATVPDKIKX0DER" } ], "batteries_included": [ { "value": false, "marketplace_id": "ATVPDKIKX0DER" } ], "connectivity_technology": [ { "language_tag": "en_US", "value": "Bluetooth", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "USB", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Wireless", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "HDMI", "marketplace_id": "ATVPDKIKX0DER" } ], "included_components": [ { "language_tag": "en_US", "value": "QLED Standard Smart Remote", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Power Cable", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Stand", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Samsung Smart Control", "marketplace_id": "ATVPDKIKX0DER" } ], "specification_met": [ { "language_tag": "en_US", "value": "", "marketplace_id": "ATVPDKIKX0DER" } ], "parental_control_technology": [ { "value": "V-Chip", "marketplace_id": "ATVPDKIKX0DER" } ], "power_consumption": [ { "unit": "watts", "value": 120, "marketplace_id": "ATVPDKIKX0DER" } ], "cpsia_cautionary_statement": [ { "value": "no_warning_applicable", "marketplace_id": "ATVPDKIKX0DER" } ], "item_type_keyword": [ { "value": "qled-televisions", "marketplace_id": "ATVPDKIKX0DER" } ], "number_of_items": [ { "value": 1, "marketplace_id": "ATVPDKIKX0DER" } ], "warranty_description": [ { "language_tag": "en_US", "value": "1 year manufacturer", "marketplace_id": "ATVPDKIKX0DER" } ], "max_resolution": [ { "unit": "pixels", "value": 8.3, "marketplace_id": "ATVPDKIKX0DER" } ], "color": [ { "language_tag": "en_US", "value": "Black", "marketplace_id": "ATVPDKIKX0DER" } ], "screen_surface_description": [ { "language_tag": "en_US", "value": "Flat", "marketplace_id": "ATVPDKIKX0DER" } ], "item_package_weight": [ { "unit": "kilograms", "value": 62.142, "marketplace_id": "ATVPDKIKX0DER" } ], "speaker_type": [ { "language_tag": "en_US", "value": "2CH", "marketplace_id": "ATVPDKIKX0DER" } ], "supported_internet_services": [ { "language_tag": "en_US", "value": "Amazon Instant Video", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "YouTube", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Netflix", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Hulu", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Browser", "marketplace_id": "ATVPDKIKX0DER" } ], "tuner_technology": [ { "language_tag": "en_US", "value": "Analog Tuner", "marketplace_id": "ATVPDKIKX0DER" } ], "controller_type": [ { "language_tag": "en_US", "value": "SmartThings", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Voice Control", "marketplace_id": "ATVPDKIKX0DER" } ], "special_feature": [ { "language_tag": "en_US", "value": "100% Color Volume with Quantum Dot; Quantum Processor 4K; Ambient Mode; Quantum HDR 4X; Real Game Enhancer", "marketplace_id": "ATVPDKIKX0DER" } ], "wireless_communication_technology": [ { "language_tag": "en_US", "value": "Wi-Fi::Wi-Fi Direct::Bluetooth", "marketplace_id": "ATVPDKIKX0DER" } ], "model_year": [ { "value": 2019, "marketplace_id": "ATVPDKIKX0DER" } ], "power_source_type": [ { "language_tag": "en_US", "value": "Corded Electric", "marketplace_id": "ATVPDKIKX0DER" } ], "street_date": [ { "value": "2019-03-21T00:00:01Z", "marketplace_id": "ATVPDKIKX0DER" } ], "mounting_type": [ { "language_tag": "en_US", "value": "Table Mount", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Wall Mount", "marketplace_id": "ATVPDKIKX0DER" } ], "refresh_rate": [ { "unit": "hertz", "language_tag": "en_US", "value": "120", "marketplace_id": "ATVPDKIKX0DER" } ] }, "classifications": [ { "marketplaceId": "ATVPDKIKX0DER", "classifications": [ { "displayName": "QLED TVs", "classificationId": "21489946011", "parent": { "displayName": "Televisions", "classificationId": "172659", "parent": { "displayName": "Television & Video", "classificationId": "1266092011", "parent": { "displayName": "Electronics", "classificationId": "172282" } } } } ] } ], "dimensions": [ { "marketplaceId": "ATVPDKIKX0DER", "item": { "height": { "unit": "inches", "value": 41.4 }, "length": { "unit": "inches", "value": 2.4 }, "weight": { "unit": "pounds", "value": 107.6 }, "width": { "unit": "inches", "value": 72.4 } }, "package": { "height": { "unit": "inches", "value": 10.49999998929 }, "length": { "unit": "inches", "value": 79.9999999184 }, "weight": { "unit": "kilograms", "value": 62.142 }, "width": { "unit": "inches", "value": 47.99999995104 } } } ], "identifiers": [ { "marketplaceId": "ATVPDKIKX0DER", "identifiers": [ { "identifier": "0887276302195", "identifierType": "EAN" }, { "identifier": "00887276302195", "identifierType": "GTIN" }, { "identifier": "887276302195", "identifierType": "UPC" } ] } ], "images": [ { "marketplaceId": "ATVPDKIKX0DER", "images": [ { "variant": "MAIN", "link": "https://m.media-amazon.com/images/I/91uohwV+k3L.jpg", "height": 1707, "width": 2560 }, { "variant": "MAIN", "link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg", "height": 333, "width": 500 }, { "variant": "PT01", "link": "https://m.media-amazon.com/images/I/81w2rTVShlL.jpg", "height": 2560, "width": 2560 }, { "variant": "PT01", "link": "https://m.media-amazon.com/images/I/41Px9eq9tkL.jpg", "height": 500, "width": 500 }, { "variant": "PT02", "link": "https://m.media-amazon.com/images/I/51NTNhdhPyL.jpg", "height": 375, "width": 500 }, { "variant": "PT03", "link": "https://m.media-amazon.com/images/I/51o4zpL+A3L.jpg", "height": 375, "width": 500 }, { "variant": "PT04", "link": "https://m.media-amazon.com/images/I/71ux2k9GAZL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT04", "link": "https://m.media-amazon.com/images/I/61UUX63yw1L.jpg", "height": 500, "width": 500 }, { "variant": "PT05", "link": "https://m.media-amazon.com/images/I/61LwHkljX-L.jpg", "height": 1000, "width": 1000 }, { "variant": "PT05", "link": "https://m.media-amazon.com/images/I/51wJTQty3PL.jpg", "height": 500, "width": 500 }, { "variant": "PT06", "link": "https://m.media-amazon.com/images/I/61uvoB4VvoL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT06", "link": "https://m.media-amazon.com/images/I/51ZexIO628L.jpg", "height": 500, "width": 500 }, { "variant": "PT07", "link": "https://m.media-amazon.com/images/I/7121MGd2ncL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT07", "link": "https://m.media-amazon.com/images/I/61QK+JBMrGL.jpg", "height": 500, "width": 500 }, { "variant": "PT08", "link": "https://m.media-amazon.com/images/I/61ECcGlG4IL.jpg", "height": 1080, "width": 1920 }, { "variant": "PT08", "link": "https://m.media-amazon.com/images/I/31TxwfqvB5L.jpg", "height": 281, "width": 500 } ] } ], "productTypes": [ { "marketplaceId": "ATVPDKIKX0DER", "productType": "TELEVISION" } ], "salesRanks": [ { "marketplaceId": "ATVPDKIKX0DER", "classificationRanks": [ { "classificationId": "21489946011", "title": "QLED TVs", "link": "http://www.amazon.com/gp/bestsellers/electronics/21489946011", "rank": 113 } ], "displayGroupRanks": [ { "websiteDisplayGroup": "ce_display_on_website", "title": "Electronics", "link": "http://www.amazon.com/gp/bestsellers/electronics", "rank": 72855 } ] } ], "summaries": [ { "marketplaceId": "ATVPDKIKX0DER", "brand": "SAMSUNG", "browseClassification": { "displayName": "QLED TVs", "classificationId": "21489946011" }, "color": "Black", "itemClassification": "BASE_PRODUCT", "itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility", "manufacturer": "Samsung", "modelNumber": "QN82Q60RAFXZA", "packageQuantity": 1, "partNumber": "QN82Q60RAFXZA", "size": "82-Inch", "style": "TV only", "websiteDisplayGroup": "home_theater_display_on_website", "websiteDisplayGroupName": "Home Theater" } ], "relationships": [ { "marketplaceId": "ATVPDKIKX0DER", "relationships": [ { "type": "VARIATION", "parentAsins": [ "B08J7TQ9FL" ], "variationTheme": { "attributes": [ "color", "size" ], "theme": "SIZE_NAME/COLOR_NAME" } } ] } ], "vendorDetails": [ { "marketplaceId": "ATVPDKIKX0DER", "brandCode": "SAMF9", "manufacturerCode": "SAMF9", "manufacturerCodeParent": "SAMF9", "productCategory": { "displayName": "Televisions", "value": "50400100" }, "productGroup": "Home Entertainment", "productSubcategory": { "displayName": "Plasma TVs", "value": "50400120" }, "replenishmentCategory": "OBSOLETE" } ] } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "asin": { "value": "B07N4M94X4" }, "marketplaceIds": { "value": [ "ATVPDKIKX0DER" ] }, "includedData": { "value": [ "classifications", "dimensions", "identifiers", "images", "productTypes", "relationships", "salesRanks", "summaries", "vendorDetails" ] } } }, "response": { "asin": "B07N4M94X4", "classifications": [ { "marketplaceId": "ATVPDKIKX0DER", "classifications": [ { "displayName": "QLED TVs", "classificationId": "21489946011", "parent": { "displayName": "Televisions", "classificationId": "172659", "parent": { "displayName": "Television & Video", "classificationId": "1266092011", "parent": { "displayName": "Electronics", "classificationId": "172282" } } } } ] } ], "dimensions": [ { "marketplaceId": "ATVPDKIKX0DER", "item": { "height": { "unit": "inches", "value": 41.4 }, "length": { "unit": "inches", "value": 2.4 }, "weight": { "unit": "pounds", "value": 107.6 }, "width": { "unit": "inches", "value": 72.4 } }, "package": { "height": { "unit": "inches", "value": 10.49999998929 }, "length": { "unit": "inches", "value": 79.9999999184 }, "weight": { "unit": "kilograms", "value": 62.142 }, "width": { "unit": "inches", "value": 47.99999995104 } } } ], "identifiers": [ { "marketplaceId": "ATVPDKIKX0DER", "identifiers": [ { "identifier": "0887276302195", "identifierType": "EAN" }, { "identifier": "00887276302195", "identifierType": "GTIN" }, { "identifier": "887276302195", "identifierType": "UPC" } ] } ], "images": [ { "marketplaceId": "ATVPDKIKX0DER", "images": [ { "variant": "MAIN", "link": "https://m.media-amazon.com/images/I/91uohwV+k3L.jpg", "height": 1707, "width": 2560 }, { "variant": "MAIN", "link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg", "height": 333, "width": 500 }, { "variant": "PT01", "link": "https://m.media-amazon.com/images/I/81w2rTVShlL.jpg", "height": 2560, "width": 2560 }, { "variant": "PT01", "link": "https://m.media-amazon.com/images/I/41Px9eq9tkL.jpg", "height": 500, "width": 500 }, { "variant": "PT02", "link": "https://m.media-amazon.com/images/I/51NTNhdhPyL.jpg", "height": 375, "width": 500 }, { "variant": "PT03", "link": "https://m.media-amazon.com/images/I/51o4zpL+A3L.jpg", "height": 375, "width": 500 }, { "variant": "PT04", "link": "https://m.media-amazon.com/images/I/71ux2k9GAZL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT04", "link": "https://m.media-amazon.com/images/I/61UUX63yw1L.jpg", "height": 500, "width": 500 }, { "variant": "PT05", "link": "https://m.media-amazon.com/images/I/61LwHkljX-L.jpg", "height": 1000, "width": 1000 }, { "variant": "PT05", "link": "https://m.media-amazon.com/images/I/51wJTQty3PL.jpg", "height": 500, "width": 500 }, { "variant": "PT06", "link": "https://m.media-amazon.com/images/I/61uvoB4VvoL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT06", "link": "https://m.media-amazon.com/images/I/51ZexIO628L.jpg", "height": 500, "width": 500 }, { "variant": "PT07", "link": "https://m.media-amazon.com/images/I/7121MGd2ncL.jpg", "height": 1000, "width": 1000 }, { "variant": "PT07", "link": "https://m.media-amazon.com/images/I/61QK+JBMrGL.jpg", "height": 500, "width": 500 }, { "variant": "PT08", "link": "https://m.media-amazon.com/images/I/61ECcGlG4IL.jpg", "height": 1080, "width": 1920 }, { "variant": "PT08", "link": "https://m.media-amazon.com/images/I/31TxwfqvB5L.jpg", "height": 281, "width": 500 } ] } ], "productTypes": [ { "marketplaceId": "ATVPDKIKX0DER", "productType": "TELEVISION" } ], "salesRanks": [ { "marketplaceId": "ATVPDKIKX0DER", "classificationRanks": [ { "classificationId": "21489946011", "title": "QLED TVs", "link": "http://www.amazon.com/gp/bestsellers/electronics/21489946011", "rank": 113 } ], "displayGroupRanks": [ { "websiteDisplayGroup": "ce_display_on_website", "title": "Electronics", "link": "http://www.amazon.com/gp/bestsellers/electronics", "rank": 72855 } ] } ], "summaries": [ { "marketplaceId": "ATVPDKIKX0DER", "brand": "SAMSUNG", "browseClassification": { "displayName": "QLED TVs", "classificationId": "21489946011" }, "color": "Black", "itemClassification": "BASE_PRODUCT", "itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility", "manufacturer": "Samsung", "modelNumber": "QN82Q60RAFXZA", "packageQuantity": 1, "partNumber": "QN82Q60RAFXZA", "size": "82-Inch", "style": "TV only", "websiteDisplayGroup": "home_theater_display_on_website", "websiteDisplayGroupName": "Home Theater" } ], "relationships": [ { "marketplaceId": "ATVPDKIKX0DER", "relationships": [ { "type": "VARIATION", "parentAsins": [ "B08J7TQ9FL" ], "variationTheme": { "attributes": [ "color", "size" ], "theme": "SIZE_NAME/COLOR_NAME" } } ] } ], "vendorDetails": [ { "marketplaceId": "ATVPDKIKX0DER", "brandCode": "SAMF9", "manufacturerCode": "SAMF9", "manufacturerCodeParent": "SAMF9", "productCategory": { "displayName": "Televisions", "value": "50400100" }, "productGroup": "Home Entertainment", "productSubcategory": { "displayName": "Plasma TVs", "value": "50400120" }, "replenishmentCategory": "OBSOLETE" } ] } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "asin": { "value": "" }, "marketplaceIds": { "value": [ "ATVPDKIKX0DER" ] }, "includedData": { "value": [ "classifications", "dimensions", "identifiers", "images", "productTypes", "relationships", "salesRanks", "summaries", "vendorDetails" ] } } }, "response": { "errors": [ { "code": "400", "message": "Request has missing or invalid parameters and cannot be parsed." } ] } } ] } }, "403": { "description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "404": { "description": "The resource specified does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "413": { "description": "The request size exceeded the maximum accepted size.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "415": { "description": "The request payload is in an unsupported format.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "500": { "description": "An unexpected condition occurred that prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorList" } } } } } } } }, "components": { "schemas": { "Error": { "required": [ "code", "message" ], "type": "object", "properties": { "code": { "type": "string", "description": "An error code that identifies the type of error that occurred." }, "message": { "type": "string", "description": "A message that describes the error condition." }, "details": { "type": "string", "description": "Additional details that can help the caller understand or fix the issue." } }, "description": "Error response returned when the request is unsuccessful." }, "ErrorList": { "required": [ "errors" ], "type": "object", "properties": { "errors": { "type": "array", "description": "A list of error responses returned when a request is unsuccessful.", "items": { "$ref": "#/components/schemas/Error" } } }, "description": "A list of error responses returned when a request is unsuccessful." }, "Item": { "required": [ "asin" ], "type": "object", "properties": { "asin": { "$ref": "#/components/schemas/ItemAsin" }, "attributes": { "$ref": "#/components/schemas/ItemAttributes" }, "classifications": { "$ref": "#/components/schemas/ItemBrowseClassifications" }, "dimensions": { "$ref": "#/components/schemas/ItemDimensions" }, "identifiers": { "$ref": "#/components/schemas/ItemIdentifiers" }, "images": { "$ref": "#/components/schemas/ItemImages" }, "productTypes": { "$ref": "#/components/schemas/ItemProductTypes" }, "relationships": { "$ref": "#/components/schemas/ItemRelationships" }, "salesRanks": { "$ref": "#/components/schemas/ItemSalesRanks" }, "summaries": { "$ref": "#/components/schemas/ItemSummaries" }, "vendorDetails": { "$ref": "#/components/schemas/ItemVendorDetails" } }, "description": "An item in the Amazon catalog." }, "ItemAsin": { "type": "string", "description": "The unique identifier of an item in the Amazon catalog." }, "ItemAttributes": { "type": "object", "additionalProperties": true, "description": "A JSON object containing structured item attribute data that is keyed by attribute name. Catalog item attributes conform to the related Amazon product type definitions that you can get from the [Product Type Definitions API](https://developer-docs.amazon.com/sp-api/reference/product-type-definitions-v2020-09-01)." }, "ItemBrowseClassification": { "required": [ "classificationId", "displayName" ], "type": "object", "properties": { "displayName": { "type": "string", "description": "Display name for the classification." }, "classificationId": { "type": "string", "description": "Identifier of the classification." }, "parent": { "$ref": "#/components/schemas/ItemBrowseClassification" } }, "description": "Classification (browse node) for an Amazon catalog item." }, "ItemContributor": { "required": [ "role", "value" ], "type": "object", "properties": { "role": { "$ref": "#/components/schemas/ItemContributorRole" }, "value": { "type": "string", "description": "Name of the contributor, such as `Jane Austen`." } }, "description": "Individual contributor to the creation of an item, such as an author or actor." }, "ItemContributorRole": { "required": [ "value" ], "type": "object", "properties": { "displayName": { "type": "string", "description": "Display name of the role in the requested locale, such as `Author` or `Actor`." }, "value": { "type": "string", "description": "Role value for the Amazon catalog item, such as `author` or `actor`." } }, "description": "Role of an individual contributor in the creation of an item, such as author or actor." }, "ItemBrowseClassifications": { "type": "array", "description": "An array of classifications (browse nodes) that is associated with the item in the Amazon catalog, grouped by `marketplaceId`.", "items": { "$ref": "#/components/schemas/ItemBrowseClassificationsByMarketplace" } }, "ItemBrowseClassificationsByMarketplace": { "required": [ "marketplaceId" ], "type": "object", "properties": { "marketplaceId": { "type": "string", "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids)." }, "classifications": { "type": "array", "description": "Classifications (browse nodes) that are associated with the item in the Amazon catalog.", "items": { "$ref": "#/components/schemas/ItemBrowseClassification" } } }, "description": "Classifications (browse nodes) that are associated with the item in the Amazon catalog for the indicated `marketplaceId`." }, "Dimension": { "type": "object", "properties": { "unit": { "type": "string", "description": "Unit of measurement for the dimension value." }, "value": { "type": "number", "description": "Numeric value of the dimension." } }, "description": "The value of an individual dimension for an Amazon catalog item or item package." }, "Dimensions": { "type": "object", "properties": { "height": { "$ref": "#/components/schemas/Dimension" }, "length": { "$ref": "#/components/schemas/Dimension" }, "weight": { "$ref": "#/components/schemas/Dimension" }, "width": { "$ref": "#/components/schemas/Dimension" } }, "description": "Dimensions of an Amazon catalog item or item in its packaging." }, "ItemDimensions": { "type": "array", "description": "An array of dimensions that are associated with the item in the Amazon catalog, grouped by `marketplaceId`.", "items": { "$ref": "#/components/schemas/ItemDimensionsByMarketplace" } }, "ItemDimensionsByMarketplace": { "required": [ "marketplaceId" ], "type": "object", "properties": { "marketplaceId": { "type": "string", "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids)." }, "item": { "$ref": "#/components/schemas/Dimensions" }, "package": { "$ref": "#/components/schemas/Dimensions" } }, "description": "Dimensions that are associated with the item in the Amazon catalog for the indicated `marketplaceId`." }, "ItemIdentifiers": { "type": "array", "description": "Identifiers associated with the item in the Amazon catalog, such as UPC and EAN identifiers.", "items": { "$ref": "#/components/schemas/ItemIdentifiersByMarketplace" } }, "ItemIdentifiersByMarketplace": { "required": [ "identifiers", "marketplaceId" ], "type": "object", "properties": { "marketplaceId": { "type": "string", "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).identifier." }, "identifiers": { "type": "array", "description": "Identifiers associated with the item in the Amazon catalog for the indicated `marketplaceId`.", "items": { "$ref": "#/components/schemas/ItemIdentifier" } } }, "description": "Identifiers that are associated with the item in the Amazon catalog, grouped by `marketplaceId`." }, "ItemIdentifier": { "required": [ "identifier", "identifierType" ], "type": "object", "properties": { "identifierType": { "type": "string", "description": "Type of identifier, such as UPC, EAN, or ISBN." }, "identifier": { "type": "string", "description": "Identifier of the item." } }, "description": "The identifier that is associated with the item in the Amazon catalog, such as a UPC or EAN identifier." }, "ItemImages": { "type": "array", "description": "The images for an item in the Amazon catalog.", "items": { "$ref": "#/components/schemas/ItemImagesByMarketplace" } }, "ItemImagesByMarketplace": { "required": [ "images", "marketplaceId" ], "type": "object", "properties": { "marketplaceId": { "type": "string", "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids)." }, "images": { "type": "array", "description": "Images for an item in the Amazon catalog, grouped by `marketplaceId`.", "items": { "$ref": "#/components/schemas/ItemImage" } } }, "description": "Images for an item in the Amazon catalog, grouped by `marketplaceId`." }, "ItemImage": { "required": [ "height", "link", "variant", "width" ], "type": "object", "properties": { "variant": { "type": "string", "description": "Variant of the image, such as `MAIN` or `PT01`.", "example": "MAIN", "enum": [ "MAIN", "PT01", "PT02", "PT03", "PT04", "PT05", "PT06", "PT07", "PT08", "SWCH" ], "x-docgen-enum-table-extension": [ { "value": "MAIN", "description": "Main image for the item" }, { "value": "PT01", "description": "Other image #1 for the item" }, { "value": "PT02", "description": "Other image #2 for the item" }, { "value": "PT03", "description": "Other image #3 for the item" }, { "value": "PT04", "description": "Other image #4 for the item" }, { "value": "PT05", "description": "Other image #5 for the item" }, { "value": "PT06", "description": "Other image #6 for the item" }, { "value": "PT07", "description": "Other image #7 for the item" }, { "value": "PT08", "description": "Other image #8 for the item" }, { "value": "SWCH", "description": "Swatch image for the item" } ] }, "link": { "type": "string", "description": "URL for the image." }, "height": { "type": "integer", "description": "Height of the image in pixels." }, "width": { "type": "integer", "description": "Width of the image in pixels." } }, "description": "Image for an item in the Amazon catalog." }, "ItemProductTypes": { "type": "array", "description": "Product types that are associated with the Amazon catalog item.", "items": { "$ref": "#/components/schemas/ItemProductTypeByMarketplace" } }, "ItemProductTypeByMarketplace": { "type": "object", "properties": { "marketplaceId": { "type": "string", "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids)." }, "productType": { "type": "string", "description": "Name of the product type that is associated with the Amazon catalog item.", "example": "LUGGAGE" } }, "description": "Product type that is associated with the Amazon catalog item, grouped by `marketplaceId`." }, "ItemSalesRanks": { "type": "array", "description": "Sales ranks of an Amazon catalog item.", "items": { "$ref": "#/components/schemas/ItemSalesRanksByMarketplace" } }, "ItemSalesRanksByMarketplace": { "required": [ "marketplaceId" ], "type": "object", "properties": { "marketplaceId": { "type": "string", "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids)." }, "classificationRanks": { "type": "array", "description": "Sales ranks of an Amazon catalog item for a `marketplaceId`, grouped by classification.", "items": { "$ref": "#/components/schemas/ItemClassificationSalesRank" } }, "displayGroupRanks": { "type": "array", "description": "Sales ranks of an Amazon catalog item for a `marketplaceId`, grouped by website display group.", "items": { "$ref": "#/components/schemas/ItemDisplayGroupSalesRank" } } }, "description": "Sales ranks of an Amazon catalog item, grouped by `marketplaceId`." }, "ItemClassificationSalesRank": { "required": [ "classificationId", "rank", "title" ], "type": "object", "properties": { "classificationId": { "type": "string", "description": "Identifier of the classification that is associated with the sales rank." }, "title": { "type": "string", "description": "Name of the sales rank." }, "link": { "type": "string", "description": "Corresponding Amazon retail website URL for the sales category." }, "rank": { "type": "integer", "description": "Sales rank." } }, "description": "Sales rank of an Amazon catalog item." }, "ItemDisplayGroupSalesRank": { "required": [ "rank", "title", "websiteDisplayGroup" ], "type": "object", "properties": { "websiteDisplayGroup": { "type": "string", "description": "Name of the website display group that is associated with the sales rank" }, "title": { "type": "string", "description": "Name of the sales rank." }, "link": { "type": "string", "description": "Corresponding Amazon retail website URL for the sales rank." }, "rank": { "type": "integer", "description": "Sales rank." } }, "description": "Sales rank of an Amazon catalog item, grouped by website display group." }, "ItemSummaries": { "type": "array", "description": "Summaries of Amazon catalog items.", "items": { "$ref": "#/components/schemas/ItemSummaryByMarketplace" } }, "ItemSummaryByMarketplace": { "required": [ "marketplaceId" ], "type": "object", "properties": { "marketplaceId": { "type": "string", "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids)." }, "adultProduct": { "type": "boolean", "description": "When `true`, the Amazon catalog item is intended for an adult audience or is sexual in nature." }, "autographed": { "type": "boolean", "description": "When `true`, the Amazon catalog item is autographed." }, "brand": { "type": "string", "description": "Name of the brand that is associated with the Amazon catalog item." }, "browseClassification": { "$ref": "#/components/schemas/ItemBrowseClassification" }, "color": { "type": "string", "description": "The color that is associated with the Amazon catalog item." }, "contributors": { "type": "array", "description": "Individual contributors to the creation of the item, such as the authors or actors.", "items": { "$ref": "#/components/schemas/ItemContributor" } }, "itemClassification": { "type": "string", "description": "Classification type that is associated with the Amazon catalog item.", "enum": [ "BASE_PRODUCT", "OTHER", "PRODUCT_BUNDLE", "VARIATION_PARENT" ], "x-docgen-enum-table-extension": [ { "value": "BASE_PRODUCT", "description": "A product that can be directly purchased. Can be a standalone ASIN or a variation child item in the Amazon catalog." }, { "value": "OTHER", "description": "An item in the Amazon catalog that is not `BASE_PRODUCT`, `PRODUCT_BUNDLE`, or `VARIATION_PARENT`." }, { "value": "PRODUCT_BUNDLE", "description": "A parent catalog item that represents a bundle of items." }, { "value": "VARIATION_PARENT", "description": "A parent catalog item that groups child items into a variation family." } ] }, "itemName": { "type": "string", "description": "The name that is associated with the Amazon catalog item." }, "manufacturer": { "type": "string", "description": "The name of the manufacturer that is associated with the Amazon catalog item." }, "memorabilia": { "type": "boolean", "description": "When true, the item is classified as memorabilia." }, "modelNumber": { "type": "string", "description": "The model number that is associated with the Amazon catalog item." }, "packageQuantity": { "type": "integer", "description": "The quantity of the Amazon catalog item within one package." }, "partNumber": { "type": "string", "description": "The part number that is associated with the Amazon catalog item." }, "releaseDate": { "type": "string", "description": "The earliest date on which the Amazon catalog item can be shipped to customers.", "format": "date" }, "size": { "type": "string", "description": "The name of the size of the Amazon catalog item." }, "style": { "type": "string", "description": "The name of the style that is associated with the Amazon catalog item." }, "tradeInEligible": { "type": "boolean", "description": "When true, the Amazon catalog item is eligible for trade-in." }, "websiteDisplayGroup": { "type": "string", "description": "The identifier of the website display group that is associated with the Amazon catalog item." }, "websiteDisplayGroupName": { "type": "string", "description": "The display name of the website display group that is associated with the Amazon catalog item." } }, "description": "Information about an Amazon catalog item for the indicated `marketplaceId`." }, "ItemVariationTheme": { "type": "object", "properties": { "attributes": { "type": "array", "description": "Names of the Amazon catalog item attributes that are associated with the variation theme.", "items": { "type": "string" } }, "theme": { "type": "string", "description": "Variation theme that indicates the combination of Amazon catalog item attributes that define the variation family.", "example": "COLOR_NAME/STYLE_NAME" } }, "description": "The variation theme is a list of Amazon catalog item attributes that define the variation family." }, "ItemRelationships": { "type": "array", "description": "Relationships grouped by `marketplaceId` for an Amazon catalog item (for example, variations).", "items": { "$ref": "#/components/schemas/ItemRelationshipsByMarketplace" } }, "ItemRelationshipsByMarketplace": { "required": [ "marketplaceId", "relationships" ], "type": "object", "properties": { "marketplaceId": { "type": "string", "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids)." }, "relationships": { "type": "array", "description": "Relationships for the item.", "items": { "$ref": "#/components/schemas/ItemRelationship" } } }, "description": "Relationship details for the Amazon catalog item for the specified Amazon `marketplaceId`." }, "ItemRelationship": { "required": [ "type" ], "type": "object", "properties": { "childAsins": { "type": "array", "description": "ASINs of the related items that are children of this item.", "items": { "type": "string" } }, "parentAsins": { "type": "array", "description": "ASINs of the related items that are parents of this item.", "items": { "type": "string" } }, "variationTheme": { "$ref": "#/components/schemas/ItemVariationTheme" }, "type": { "type": "string", "description": "Type of relationship.", "example": "VARIATION", "enum": [ "VARIATION", "PACKAGE_HIERARCHY" ], "x-docgen-enum-table-extension": [ { "value": "VARIATION", "description": "The Amazon catalog item in the request is a variation parent or variation child of the related items that are identified by ASIN." }, { "value": "PACKAGE_HIERARCHY", "description": "The Amazon catalog item in the request is a package container or is contained by the related items that are identified by ASIN." } ] } }, "description": "Relationship details for an Amazon catalog item." }, "ItemVendorDetailsCategory": { "type": "object", "properties": { "displayName": { "type": "string", "description": "The display name of the product category or subcategory." }, "value": { "type": "string", "description": "The code that identifies the product category or subcategory." } }, "description": "The product category or subcategory that is associated with an Amazon catalog item." }, "ItemVendorDetails": { "type": "array", "description": "The vendor details that are associated with an Amazon catalog item. Vendor details are only available to vendors.", "items": { "$ref": "#/components/schemas/ItemVendorDetailsByMarketplace" } }, "ItemVendorDetailsByMarketplace": { "required": [ "marketplaceId" ], "type": "object", "properties": { "marketplaceId": { "type": "string", "description": "Amazon marketplace identifier. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids)." }, "brandCode": { "type": "string", "description": "The brand code that is associated with an Amazon catalog item." }, "manufacturerCode": { "type": "string", "description": "The manufacturer code that is associated with an Amazon catalog item." }, "manufacturerCodeParent": { "type": "string", "description": "The parent vendor code of the manufacturer code." }, "productCategory": { "$ref": "#/components/schemas/ItemVendorDetailsCategory" }, "productGroup": { "type": "string", "description": "The product group that is associated with an Amazon catalog item." }, "productSubcategory": { "$ref": "#/components/schemas/ItemVendorDetailsCategory" }, "replenishmentCategory": { "type": "string", "description": "The replenishment category that is associated with an Amazon catalog item.", "enum": [ "ALLOCATED", "BASIC_REPLENISHMENT", "IN_SEASON", "LIMITED_REPLENISHMENT", "MANUFACTURER_OUT_OF_STOCK", "NEW_PRODUCT", "NON_REPLENISHABLE", "NON_STOCKUPABLE", "OBSOLETE", "PLANNED_REPLENISHMENT" ], "x-docgen-enum-table-extension": [ { "value": "ALLOCATED", "description": "The vendor allocates the inventory to Amazon and Amazon manually purchases it." }, { "value": "BASIC_REPLENISHMENT", "description": "Inventory is manually purchased." }, { "value": "IN_SEASON", "description": "Seasonal item that is manually purchased." }, { "value": "LIMITED_REPLENISHMENT", "description": "Amazon generates orders for this item automatically based on unfilled demand." }, { "value": "MANUFACTURER_OUT_OF_STOCK", "description": "The vendor is out of stock for an extended period of time and cannot backorder." }, { "value": "NEW_PRODUCT", "description": "Amazon does not yet stock this item." }, { "value": "NON_REPLENISHABLE", "description": "Indicates assortment parent used for detail page display, not actual items." }, { "value": "NON_STOCKUPABLE", "description": "Drop ship inventory that Amazon does not stock in its fulfillment centers." }, { "value": "OBSOLETE", "description": "The item is obsolete and should not be ordered." }, { "value": "PLANNED_REPLENISHMENT", "description": "Active items that should be automatically ordered." } ] } }, "description": "The vendor details that are associated with an Amazon catalog item for the specified `marketplaceId`." }, "ItemSearchResults": { "required": [ "items", "numberOfResults" ], "type": "object", "properties": { "numberOfResults": { "type": "integer", "description": "For searches that are based on `identifiers`, `numberOfResults` is the total number of Amazon catalog items found. For searches that are based on `keywords`, `numberOfResults` is the estimated total number of Amazon catalog items that are matched by the search query. Only results up to the page count limit are returned per request regardless of the number found.\n\n**Note:** The maximum number of items (ASINs) that can be returned and paged through is 1,000." }, "pagination": { "$ref": "#/components/schemas/Pagination" }, "refinements": { "$ref": "#/components/schemas/Refinements" }, "items": { "type": "array", "description": "A list of items from the Amazon catalog.", "items": { "$ref": "#/components/schemas/Item" } } }, "description": "Items in the Amazon catalog and search-related metadata." }, "Pagination": { "type": "object", "properties": { "nextToken": { "type": "string", "description": "A token that you can use to retrieve the next page." }, "previousToken": { "type": "string", "description": "A token that you can use to retrieve the previous page." } }, "description": "Pagination occurs when a request produces a response that exceeds the `pageSize`. This means that the response is divided into individual pages. To retrieve the next page or the previous page of results, you must pass the `nextToken` value or the `previousToken` value as the `pageToken` parameter in the next request. There is no `nextToken` in the pagination object on the last page." }, "Refinements": { "required": [ "brands", "classifications" ], "type": "object", "properties": { "brands": { "type": "array", "description": "A list of brands you can use to refine your search.", "items": { "$ref": "#/components/schemas/BrandRefinement" } }, "classifications": { "type": "array", "description": "A list of classifications you can use to refine your search.", "items": { "$ref": "#/components/schemas/ClassificationRefinement" } } }, "description": "Optional fields that you can use to refine your search results." }, "BrandRefinement": { "required": [ "brandName", "numberOfResults" ], "type": "object", "properties": { "numberOfResults": { "type": "integer", "description": "The estimated number of results that would be returned if you refine your search by the specified `brandName`." }, "brandName": { "type": "string", "description": "The brand name that you can use to refine your search." } }, "description": "A brand that you can use to refine your search." }, "ClassificationRefinement": { "required": [ "classificationId", "displayName", "numberOfResults" ], "type": "object", "properties": { "numberOfResults": { "type": "integer", "description": "The estimated number of results that would be returned if you refine your search by the specified `classificationId`." }, "displayName": { "type": "string", "description": "Display name for the classification." }, "classificationId": { "type": "string", "description": "The identifier of the classification that you can use to refine your search." } }, "description": "A classification that you can use to refine your search." } } }, "x-original-swagger-version": "2.0" }