Common Request Parameters
An alphanumeric token that uniquely identifies an Associate. This token is the
means by which Amazon identifies the Associate to credit for a sale. If a request is
made without identifying an Associate, Associate fees are not paid by Amazon. If the
AssociateTag is included in the
Valid values: An alphanumeric token distributed by Amazon that uniquely identifies an Associate. Use this value in all requests to receive credit for the customer's purchase.
||An alphanumeric token that uniquely identifies a seller. For information about getting an AWS
access key ID, see Becoming an Associate. |
Valid value: Access Key ID distributed by Amazon.
||Specifies the format of the content in the response. For example, to transform your Product Advertising API response into HTML, set |
Valid values: text/html, text/xml
||Directs a request for products and offers to the marketplace domain that you specify. A marketplace domain is a website that is powered by Amazon.com and that supports the Amazon Associates program. For more information, see MarketplaceDomain Parameter.||No|
||An optional parameter that can be used to filter search results and offer listings to include only items sold by Amazon.
By default, the API returns items sold by various merchants including Amazon. If the value “Amazon” is supplied, only items
sold by Amazon are included in the response.|
Valid values: Amazon
||Specifies the Product Advertising API operation to execute. For more information, see Operations.
Valid values: An Product Advertising API operation, for example,
||Specifies the Product Advertising API service. There is only one value for
all Product Advertising API operations. |
Valid value: AWSECommerceService
||Prevents an operation from executing. Set the |
Valid values: True, False
||The version of the Product Advertising API software and WSDL to use. By default, the 2011-08-01
version is used. Alternately, specify a software version, such as 2013-08-01. For a
list of valid version numbers, refer to the Product Advertising API Release Notes. Note that the
latest version of Product Advertising API is not used by default.|
Valid values: Valid WSDL version date, for example, 2013-08-01.
||Specifies whether responses are XML-encoded in a single pass or a double pass. By
Valid values: Single, Double
AssociateTag parameter is a required parameter in Product Advertising API
requests. When you register as an Amazon Associate, an Associate tag is sent to you by return email.
An Associate tag, also known as an Associate ID, is an automatically generated unique identifier
that you will need to make requests through the Product Advertising API. When you log in to the
Amazon Associates website for your locale, the page that you are directed to includes a message
that says "Signed in as" followed by your Associate tag.
Once a cart is associated with an Associate Tag, you must use it in every other cart operation related to that shopping cart. Otherwise, you will receive an error.
If you do not include an Associate Tag in the
your request will fail.
AssociateTag is locale-specific, that is, for each locale in which you
want to earn Associate revenue, you must get an Associate Tag. If you try to use a US-locale
Associate Tag, for example, in the JP locale, you will not earn Associate revenue.
Be careful when specifying an AssociateTag because errors are not returned for incorrect values.