AWS Documentation » Amazon Product Advertising API Docs » Developer Guide » Programming Guide » Requests » Batch Requests

Batch Requests

Topics

• Parameters That Differ
• Shared Parameters
• Performing Multiple ItemLookups in One Request

The requests presented so far contain only one operation. Product Advertising API enables you to improve performance by submitting more than one request at the same time. There are two ways to do this:

Batch request

A request that uses one operation with up to two sets of parameters.

Multiple ItemIds

In an ItemLookup request, you can include up to 10 comma-separated values for ItemId. Be sure to URL-encode the commas.

Note

Batch requests are not supported for the cart operations: CartAdd, CartClear, CartCreate, CartGet, and CartModify.

There may be occasions when you want to use the same operation in two requests, each one using different input parameters. For example, you might want to run an ItemLookup request several times, each time looking up a different item. To accomplish this task, you can submit two requests or one batch request.

The following figure shows how two simple requests can be combined into one batch request.

The new syntax introduced in the batch request centers on the ways in which the operation parameters are defined. Either the parameter values are different or they are shared between the simple requests in the batch request.

Batch requests can contain up to two sets of parameters.

Note

The Product Advertising API supports ItemLookup batch requests only when the ItemType is an EAN (European Article Number), ISBN (International Standard Book Number), EISBN (Electronic International Standard Book Number), or ASIN (Amazon Standard Item Number).