Product Advertising API
Developer Guide (API Version 2013-08-01)

Batch Requests

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.


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.


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).