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

Anatomy of a REST Request

Product Advertising API REST requests are URLs. The following example is an ItemSearch request. AWSAccessKeyId=[Access Key ID]&AssociateTag=[Associate ID]&SearchIndex=Apparel& Keywords=Shirt&Timestamp=[YYYY-MM-DDThh:mm:ssZ]&Signature=[Request Signature]

The following example is formatted with line breaks for readability. Service=AWSECommerceService& Operation=ItemSearch& AWSAccessKeyId=[Access Key ID]& AssociateTag=[Associate ID]& SearchIndex=Apparel& Keywords=Shirt& Timestamp=[YYYY-MM-DDThh:mm:ssZ]& Signature=[Request Signature]

Request Format

The following example is a more detailed ItemSearch request. The request searches by keyword in the FashionMen category. Service=AWSECommerceService& Operation=ItemSearch& AWSAccessKeyId=[Access Key ID]& AssociateTag=[Associate ID]& SearchIndex=FashionMen& Sort=price& Keywords=lacoste%20polo& ResponseGroup=Accessories%2CImages%2CItemAttributes& Timestamp=[YYYY-MM-DDThh:mm:ssZ]& Signature=[Request Signature]

When you register for Product Advertising API in your locale, use the locale-specific endpoint for each request (for example, is the endpoint for the US). See Product Advertising API Endpoints.


This term identifies the service in the request. The value is AWSECommerceService for all requests and locales.


The operation parameter determines the type of request (for example, ItemSearch, ItemLookup).


The AWS access key ID. When you register as a Product Advertising API developer, an AWS account is created for you.


The Amazon Associates account ID. You must include this value in each request to be eligible to receive a referral fee for customer purchases.


Parameters help you customize your request. For example, the SearchIndex parameter limits a request to a specific category. You can use the Sort parameter to return items by price. Requests can have up to ten parameters.


Response groups filter the type of information returned by the request. For example, the Images response group returns item images. See Response Groups.


The date and time the request was sent.


The signature authenticates your request.

For more information about Timestamp and Signature, see HMAC-SHA256 Signatures for REST Requests.

For signing examples with AWS access identifiers, see Example REST Requests.

Product Advertising API Endpoints

The endpoint varies by locale. Each locale supports HTTP and HTTPS requests. You can send requests to the locale where you registered as a Product Advertising API developer. To use other endpoints, you must register as a Product Advertising API developer for that locale.

Locale Endpoint













Response Groups

The ResponseGroup parameter is optional for all Product Advertising API operations. Response groups filter the type of information returned by the request. For example, if you want to return images, use the Image response group in the request. If you want price information, use the Offer response group.

All Product Advertising API operations share some response groups. For example, all operations use the Request response group, which returns the operation name and input parameters sent in the request.

Some response groups are specific to operation. The CartCreate, CartAdd, and CartModify operations use the Cart response group, which returns information about items in a cart. Some response groups are limited per operation. For example, the BrowseNodes response group cannot be used with cart operations.

For a complete list of operations and response groups, see API Reference.

On this page: