Resources for Developers Using Amazon's Product Advertising API
· Home  
· Search  
· Browse Nodes  
· Data Feed?  
· FAQs  
· One-Second Rule  
· PHP Examples  
· Tips for Associates  
· Tools  
· Understanding A2S  

Create a custom Amazon Associate Store in minutes with
Associate-O-Matic.

Disappointed by Amazon.com and the Associates program?

Please consider
Shareasale

Shareasale manages affiliate programs for thousands of merchants. The site makes it easier to apply to programs and create links. And simple-to-use datafeeds are offered by most merchants.

A2S Reference

Version (parameter)

The Version parameter specifies the version of the A2S to use.

During testing and for examples, you might wish to use "&Version=2100-01-01" in your A2S queries. This will force A2S to use the latest version of the web services.

But, in your real code, specify the actual date of the latest Version at the time you test your code (see: the A2S Release Notes for information about each version). This will protect you from changes introduced in later versions.

Applies to all operations.

A2S Query

http://ecs.amazonaws.com/onca/xml?
   Service=AWSECommerceService
   &AWSAccessKeyId=--
   &AssociateTag=browsenodes-20
   &Operation=ItemSearch
   &BrowseNode=1259929011
   &Keywords=sandpaper
   &SearchIndex=Tools
   &ResponseGroup=Request,Large
   &Version=2100-01-01

The above URL executes an A2S ItemSearch query. The ItemSearch operation returns information about products which match the specified parameters such as BrowseNode and SearchIndex

The above ItemSearch operation returns products associated with the Home / Home / Tools & Hardware / Specialty Stores / Contractor Supply browse node (1259929011) and the Tools search index. Only products which match the keywords are returned.

The Request response group returns all of the parameters and their values that were submitted in a request. This helps with debugging, but be aware that all parameters, including unrecognized/invalid parameters, are included.

The Large response group returns a large amount of information about each item in the response.

A2S Response

The following is the XML response returned by A2S for the above query.
<ItemSearchResponse>
 <OperationRequest>
  <HTTPHeaders>
   <Header Name="UserAgent" Value="Oblio/1.0
(+http://www.rogersmithsoftware.com/)" />
  </HTTPHeaders>
  <RequestId>ce5ebcab-4dac-4cd4-9ce9-c6a7315b89ab</Requ
estId>
  <Arguments>
   <Argument Name="AWSAccessKeyId" Value="--" />
   <Argument Name="AssociateTag" Value="browsenodes-20"
/>
   <Argument Name="BrowseNode" Value="1259929011" />
   <Argument Name="Condition" Value="New" />
   <Argument Name="Keywords" Value="sandpaper" />
   <Argument Name="Operation" Value="ItemSearch" />
   <Argument Name="ResponseGroup" Value="Request,Large"
/>
   <Argument Name="SearchIndex" Value="Tools" />
   <Argument Name="Service" Value="AWSECommerceService"
/>
   <Argument Name="Timestamp"
Value="2018-08-17T15:36:03Z" />
   <Argument Name="Version" Value="2011-08-01" />
   <Argument Name="Signature" Value="--" />
  </Arguments>
  <RequestProcessingTime>0.0409051730000000</RequestPro
cessingTime>
 </OperationRequest>
 <Items>
  <Request>
   <IsValid>True</IsValid>
   <ItemSearchRequest>
    <BrowseNode>1259929011</BrowseNode>
    <Condition>New</Condition>
    <Keywords>sandpaper</Keywords>
    <ResponseGroup>Request</ResponseGroup>
    <ResponseGroup>Large</ResponseGroup>
    <SearchIndex>Tools</SearchIndex>
   </ItemSearchRequest>
   <Errors>
    <Error>
     <Code>AWS.ECommerceService.NoExactMatc
hes</Code>
     <Message>We did not find any matches
for your request.</Message>
    </Error>
   </Errors>
  </Request>
  <TotalResults>0</TotalResults>
  <TotalPages>0</TotalPages>
  <MoreSearchResultsUrl>https://www.amazon.com/gp/search?l
inkCode=xm2&node=1259929011&SubscriptionId=--&keywords=sandpape
r&tag=browsenodes-20&creative=386001&url=search-alias%3Dtools&a
mp;camp=2025</MoreSearchResultsUrl>
 </Items>
</ItemSearchResponse>


Copyright © 2018 by Roger Smith