Update SP-API throttling rates Catalog Items v2020-12-01

This commit is contained in:
Gibran Waldron 2022-08-31 09:37:32 -07:00
parent a8e2824b75
commit f3c11a6550
1 changed files with 217 additions and 181 deletions

View File

@ -29,7 +29,7 @@
"tags": [
"catalog"
],
"description": "Search for and return a list of Amazon catalog items and associated information.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 5 | 5 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description": "Search for and return a list of Amazon catalog items and associated information.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 2 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "searchCatalogItems",
"consumes": [
"application/json"
@ -318,6 +318,23 @@
{
"request": {
"parameters": {
"keywords": {
"value": [
"red",
"polo",
"shirt"
]
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
},
"includedData": {
"value": [
"summaries"
]
}
}
},
"response": {
@ -325,114 +342,114 @@
"pagination": {
"nextToken": "9HkIVcuuPmX_bm51o3-igBfN45pxW4Ru7ElIM6GCECYCuXJKzT26f-AlJJZYjIPp8wkOEmQdma1wt_JvE7qiRmNsKy7hH"
},
"refinements": {
"brands": [
"refinements": {
"brands": [
{
"numberOfResults": 91,
"brandName": "Polo Ralph Lauren"
},
{
"numberOfResults": 79,
"brandName": "Eddie Bauer"
},
{
"numberOfResults": 46,
"brandName": "Cutter & Buck"
},
{
"numberOfResults": 39,
"brandName": "FILA"
},
{
"numberOfResults": 37,
"brandName": "Orvis"
}
],
"classifications": [
{
"numberOfResults": 1243,
"displayName": "Clothing, Shoes & Jewelry",
"classificationId": "7141124011"
},
{
"numberOfResults": 126,
"displayName": "Sports & Outdoors",
"classificationId": "3375301"
}
]
},
"items": [
{
"numberOfResults": 91,
"brandName": "Polo Ralph Lauren"
"asin": "B002N36Q3M",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "Fred Perry",
"colorName": "Wht/Brt Red/Nvy",
"itemName": "Fred Perry Men's Twin Tipped Polo Shirt-M1200, WHT/BRT RED/NVY, X-Large",
"manufacturer": "Fred Perry Men's Apparel",
"modelNumber": "M1200",
"sizeName": "X-Large",
"styleName": "Twin Tipped Polo Shirt-m1200"
}
]
},
{
"numberOfResults": 79,
"brandName": "Eddie Bauer"
"asin": "B002N3ABSI",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "Fred Perry",
"colorName": "White/Bright Red/Navy",
"itemName": "Fred Perry Men's Twin Tipped Polo, White/Bright Red/Navy, SM",
"manufacturer": "Fred Perry Apparel Mens",
"modelNumber": "M1200-748",
"sizeName": "SM",
"styleName": "Twin Tipped Fred Perry Polo"
}
]
},
{
"numberOfResults": 46,
"brandName": "Cutter & Buck"
"asin": "B01N5B3598",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "NHL",
"colorName": "Red",
"itemName": "NHL New Jersey Devils Men's Polo, Small, Red",
"manufacturer": "Knight's Apparel",
"modelNumber": "H0MEE3ZAMZ",
"sizeName": "Small"
}
]
},
{
"numberOfResults": 39,
"brandName": "FILA"
"asin": "B00HIVDUXI",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "adidas",
"colorName": "Bold Red/White",
"itemName": "Adidas Golf Men's Puremotion Textured Stripe Polo, Bold Red/White, Large",
"manufacturer": "TaylorMade - Adidas Golf Apparel",
"modelNumber": "TM3010S4",
"sizeName": "Large"
}
]
},
{
"numberOfResults": 37,
"brandName": "Orvis"
}
],
"classifications": [
{
"numberOfResults": 1243,
"displayName": "Clothing, Shoes & Jewelry",
"classificationId": "7141124011"
},
{
"numberOfResults": 126,
"displayName": "Sports & Outdoors",
"classificationId": "3375301"
"asin": "B005ZZ12YS",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "RALPH LAUREN",
"colorName": "Black / Red Pony",
"itemName": "Polo Ralph Lauren Men's Long-sleeved T-shirt / Sleepwear / Thermal in Black, Red Pony (Large / L)",
"sizeName": "Large"
}
]
}
]
},
"items": [
{
"asin": "B002N36Q3M",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "Fred Perry",
"colorName": "Wht/Brt Red/Nvy",
"itemName": "Fred Perry Men's Twin Tipped Polo Shirt-M1200, WHT/BRT RED/NVY, X-Large",
"manufacturer": "Fred Perry Men's Apparel",
"modelNumber": "M1200",
"sizeName": "X-Large",
"styleName": "Twin Tipped Polo Shirt-m1200"
}
]
},
{
"asin": "B002N3ABSI",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "Fred Perry",
"colorName": "White/Bright Red/Navy",
"itemName": "Fred Perry Men's Twin Tipped Polo, White/Bright Red/Navy, SM",
"manufacturer": "Fred Perry Apparel Mens",
"modelNumber": "M1200-748",
"sizeName": "SM",
"styleName": "Twin Tipped Fred Perry Polo"
}
]
},
{
"asin": "B01N5B3598",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "NHL",
"colorName": "Red",
"itemName": "NHL New Jersey Devils Men's Polo, Small, Red",
"manufacturer": "Knight's Apparel",
"modelNumber": "H0MEE3ZAMZ",
"sizeName": "Small"
}
]
},
{
"asin": "B00HIVDUXI",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "adidas",
"colorName": "Bold Red/White",
"itemName": "Adidas Golf Men's Puremotion Textured Stripe Polo, Bold Red/White, Large",
"manufacturer": "TaylorMade - Adidas Golf Apparel",
"modelNumber": "TM3010S4",
"sizeName": "Large"
}
]
},
{
"asin": "B005ZZ12YS",
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "RALPH LAUREN",
"colorName": "Black / Red Pony",
"itemName": "Polo Ralph Lauren Men's Long-sleeved T-shirt / Sleepwear / Thermal in Black, Red Pony (Large / L)",
"sizeName": "Large"
}
]
}
]
}
}
]
@ -570,7 +587,7 @@
"tags": [
"catalog"
],
"description": "Retrieves details for an item in the Amazon catalog.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 5 | 5 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"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 returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "getCatalogItem",
"consumes": [
"application/json"
@ -775,6 +792,25 @@
{
"request": {
"parameters": {
"asin": {
"value": "B07N4M94X4"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
},
"includedData": {
"value": [
"identifiers",
"images",
"productTypes",
"salesRanks",
"summaries",
"variations",
"vendorDetails"
]
}
}
},
"response": {
@ -782,88 +818,88 @@
"identifiers": [
{
"marketplaceId": "ATVPDKIKX0DER",
"identifiers": [
{
"identifierType": "ean",
"identifier": "0887276302195"
},
{
"identifierType": "upc",
"identifier": "887276302195"
}
]
}
],
"images": [
{
"marketplaceId": "ATVPDKIKX0DER",
"images": [
{
"variant": "MAIN",
"link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg",
"height": 333,
"width": 500
}
]
}
],
"productTypes": [
{
"marketplaceId": "ATVPDKIKX0DER",
"productType": "TELEVISION"
}
],
"salesRanks": [
{
"marketplaceId": "ATVPDKIKX0DER",
"ranks": [
{
"title": "OLED TVs",
"link": "http://www.amazon.com/gp/bestsellers/electronics/6463520011",
"rank": 3
},
{
"title": "Electronics",
"link": "http://www.amazon.com/gp/bestsellers/electronics",
"rank": 1544
}
]
}
],
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "Samsung Electronics",
"browseNode": "6463520011",
"colorName": "Black",
"itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility",
"manufacturer": "Samsung",
"modelNumber": "QN82Q60RAFXZA",
"sizeName": "82-Inch",
"styleName": "TV only"
}
],
"variations": [
{
"marketplaceId": "ATVPDKIKX0DER",
"asins": [
"B08J7TQ9FL"
],
"variationType": "CHILD"
}
],
"vendorDetails": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandCode": "SAMF9",
"categoryCode": "50400100",
"manufacturerCode": "SAMF9",
"manufacturerCodeParent": "SAMF9",
"productGroup": "Home Entertainment",
"replenishmentCategory": "NEW_PRODUCT",
"subcategoryCode": "50400150"
}
]
"identifiers": [
{
"identifierType": "ean",
"identifier": "0887276302195"
},
{
"identifierType": "upc",
"identifier": "887276302195"
}
]
}
],
"images": [
{
"marketplaceId": "ATVPDKIKX0DER",
"images": [
{
"variant": "MAIN",
"link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg",
"height": 333,
"width": 500
}
]
}
],
"productTypes": [
{
"marketplaceId": "ATVPDKIKX0DER",
"productType": "TELEVISION"
}
],
"salesRanks": [
{
"marketplaceId": "ATVPDKIKX0DER",
"ranks": [
{
"title": "OLED TVs",
"link": "http://www.amazon.com/gp/bestsellers/electronics/6463520011",
"rank": 3
},
{
"title": "Electronics",
"link": "http://www.amazon.com/gp/bestsellers/electronics",
"rank": 1544
}
]
}
],
"summaries": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandName": "Samsung Electronics",
"browseNode": "6463520011",
"colorName": "Black",
"itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility",
"manufacturer": "Samsung",
"modelNumber": "QN82Q60RAFXZA",
"sizeName": "82-Inch",
"styleName": "TV only"
}
],
"variations": [
{
"marketplaceId": "ATVPDKIKX0DER",
"asins": [
"B08J7TQ9FL"
],
"variationType": "CHILD"
}
],
"vendorDetails": [
{
"marketplaceId": "ATVPDKIKX0DER",
"brandCode": "SAMF9",
"categoryCode": "50400100",
"manufacturerCode": "SAMF9",
"manufacturerCodeParent": "SAMF9",
"productGroup": "Home Entertainment",
"replenishmentCategory": "NEW_PRODUCT",
"subcategoryCode": "50400150"
}
]
}
}
]