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

BrowseNodes (response)

The BrowseNodes response group returns the names and IDs of browse nodes associated with the items returned in the response.

The response also returns the names and IDs of the child and parent browse nodes of the browse nodes associated with the items returned.

A2S Query

http://ecs.amazonaws.com/onca/xml?
   Service=AWSECommerceService
   &AWSAccessKeyId=--
   &AssociateTag=browsenodes-20
   &Operation=ItemSearch
   &BrowseNode=1259929011
   &Keywords=sandpaper
   &SearchIndex=Tools
   &ResponseGroup=Request,Small,BrowseNodes
   &Version=2005-10-05

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 Small response group returns basic information about the items in a response.

The BrowseNodes response group returns the names and IDs of browse nodes associated with the items returned 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>deebd903-36e5-48bc-8f7a-e38fc94c7ca7</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,Small,BrowseNodes" />
   <Argument Name="SearchIndex" Value="Tools" />
   <Argument Name="Service" Value="AWSECommerceService"
/>
   <Argument Name="Timestamp"
Value="2019-10-19T21:03:22Z" />
   <Argument Name="Version" Value="2011-08-01" />
   <Argument Name="Signature" Value="--" />
  </Arguments>
  <RequestProcessingTime>0.1744343740000000</RequestPro
cessingTime>
 </OperationRequest>
 <Items>
  <Request>
   <IsValid>True</IsValid>
   <ItemSearchRequest>
    <BrowseNode>1259929011</BrowseNode>
    <Condition>New</Condition>
    <Keywords>sandpaper</Keywords>
    <ResponseGroup>Request</ResponseGroup>
    <ResponseGroup>Small</ResponseGroup>
    <ResponseGroup>BrowseNodes</ResponseGroup
>
    <SearchIndex>Tools</SearchIndex>
   </ItemSearchRequest>
  </Request>
  <TotalResults>1</TotalResults>
  <TotalPages>1</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>
  <Item>
   <ASIN>href="http://www.browsenodes.com/productnodes-B002RTKFWU.html">B002RTKFWUa></ASIN>
   <ParentASIN>B01APCSTB4</ParentASIN>
   <DetailPageURL>href="https://www.amazon.com/Performance-Tool-W3939-Hammer-Tough/dp/B002RTK
FWU?psc=1&SubscriptionId=--&tag=browsenodes-20&linkCode=xm2&camp=2025&creat
ive=165953&creativeASIN=B002RTKFWU">https://www.amazon.com/Performance-Tool
-W3939-Hammer-Tough/dp/B002RTKFWU?psc=1&SubscriptionId=--&tag=browsenodes-2
0&linkCode=xm2&camp=2025&creative=165953&creativeASIN=B002RTKFWU</De
tailPageURL>
   <ItemLinks>
    <ItemLink>
     <Description>Technical
Details</Description>
     <URL>href="https://www.amazon.com/Performance-Tool-W3939-Hammer-Tough/dp/tech-da
ta/B002RTKFWU?SubscriptionId=--&tag=browsenodes-20&linkCode=xm2&camp=2025&c
reative=386001&creativeASIN=B002RTKFWU">https://www.amazon.com/Performance-
Tool-W3939-Hammer-Tough/dp/tech-data/B002RTKFWU?SubscriptionId=--&tag=brows
enodes-20&linkCode=xm2&camp=2025&creative=386001&creativeASIN=B002RTKFWU
></URL>
    </ItemLink>
    <ItemLink>
     <Description>Add To Baby
Registry</Description>
     <URL>
href="https://www.amazon.com/gp/registry/baby/add-item.html?asin.0=B002RTKF
WU&SubscriptionId=--&tag=browsenodes-20&linkCode=xm2&camp=2025&creative=386
001&creativeASIN=B002RTKFWU">https://www.amazon.com/gp/registry/baby/add-it
em.html?asin.0=B002RTKFWU&SubscriptionId=--&tag=browsenodes-20&linkCode=xm2
&camp=2025&creative=386001&creativeASIN=B002RTKFWU
</URL>
    </ItemLink>
    <ItemLink>
     <Description>Add To Wedding
Registry</Description>
     <URL>href="https://www.amazon.com/gp/registry/wedding/add-item.html?asin.0=B002R
TKFWU&SubscriptionId=--&tag=browsenodes-20&linkCode=xm2&camp=2025&creative=
386001&creativeASIN=B002RTKFWU">https://www.amazon.com/gp/registry/wedding/
add-item.html?asin.0=B002RTKFWU&SubscriptionId=--&tag=browsenodes-20&linkCo
de=xm2&camp=2025&creative=386001&creativeASIN=B002RTKFWU
</URL>
    </ItemLink>
    <ItemLink>
     <Description>Add To
Wishlist</Description>
     <URL>href="https://www.amazon.com/gp/registry/wishlist/add-item.html?asin.0=B002
RTKFWU&SubscriptionId=--&tag=browsenodes-20&linkCode=xm2&camp=2025&creative
=386001&creativeASIN=B002RTKFWU">https://www.amazon.com/gp/registry/wishlis
t/add-item.html?asin.0=B002RTKFWU&SubscriptionId=--&tag=browsenodes-20&link
Code=xm2&camp=2025&creative=386001&creativeASIN=B002RTKFWU
</URL>
    </ItemLink>
    <ItemLink>
     <Description>Tell A
Friend</Description>
     <URL>href="https://www.amazon.com/gp/pdp/taf/B002RTKFWU?SubscriptionId=--&tag=br
owsenodes-20&linkCode=xm2&camp=2025&creative=386001&creativeASIN=B002RTKFWU
">https://www.amazon.com/gp/pdp/taf/B002RTKFWU?SubscriptionId=--&tag=browse
nodes-20&linkCode=xm2&camp=2025&creative=386001&creativeASIN=B002RTKFWU

</URL>
    </ItemLink>
    <ItemLink>
     <Description>All Customer
Reviews</Description>
     <URL>href="https://www.amazon.com/review/product/B002RTKFWU?SubscriptionId=--&ta
g=browsenodes-20&linkCode=xm2&camp=2025&creative=386001&creativeASIN=B002RT
KFWU">https://www.amazon.com/review/product/B002RTKFWU?SubscriptionId=--&ta
g=browsenodes-20&linkCode=xm2&camp=2025&creative=386001&creativeASIN=B002RT
KFWU
</URL>
    </ItemLink>
    <ItemLink>
     <Description>All
Offers</Description>
     <URL>href="https://www.amazon.com/gp/offer-listing/B002RTKFWU?SubscriptionId=--&
tag=browsenodes-20&linkCode=xm2&camp=2025&creative=386001&creativeASIN=B002
RTKFWU">https://www.amazon.com/gp/offer-listing/B002RTKFWU?SubscriptionId=-
-&tag=browsenodes-20&linkCode=xm2&camp=2025&creative=386001&creativeASIN=B0
02RTKFWU
</URL>
    </ItemLink>
   </ItemLinks>
   <ItemAttributes>
    <Manufacturer>Wilmar Performance
Tool</Manufacturer>
    <ProductGroup>Home
Improvement</ProductGroup>
    <Title>href="http://www.amazon.com/dp/B002RTKFWU/?tag=browsenodes-20">Performance
Tool W3939 Hammer Tough 2-1/2" Drill Press Vise</Title>
   </ItemAttributes>
   <BrowseNodes>
    <BrowseNode>
     <BrowseNodeId>href="http://www.browsenodes.com/node-468240.html">468240</BrowseNod
eId>
     <Name>href="http://www.browsenodes.com/node-468240.html">Categories</Name&
gt
     <IsCategoryRoot>1</IsCategoryRoot&g
t
     <Children>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-13397451.html">13397451</Brows
eNodeId>
       <Name>href="http://www.browsenodes.com/node-13397451.html">Appliances</Nam
e>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-551240.html">551240</BrowseNod
eId>
       <Name>href="http://www.browsenodes.com/node-551240.html">Building
Supplies</Name>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-495266.html">495266</BrowseNod
eId>
       <Name>href="http://www.browsenodes.com/node-495266.html">Electrical</Name&
gt
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-511228.html">511228</BrowseNod
eId>
       <Name>href="http://www.browsenodes.com/node-511228.html">Hardware</Name>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-3754161.html">3754161</BrowseN
odeId>
       <Name>href="http://www.browsenodes.com/node-3754161.html">Kitchen & Bath
Fixtures</Name>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-322525011.html">322525011</Bro
wseNodeId>
       <Name>href="http://www.browsenodes.com/node-322525011.html">Light
Bulbs</Name>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-495224.html">495224</BrowseNod
eId>
       <Name>href="http://www.browsenodes.com/node-495224.html">Lighting & Ceiling
Fans</Name>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-553244.html">553244</BrowseNod
eId>
       <Name>href="http://www.browsenodes.com/node-553244.html">Measuring & Layout
Tools</Name>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-228899.html">228899</BrowseNod
eId>
       <Name>href="http://www.browsenodes.com/node-228899.html">Paint, Wall Treatments &
Supplies</Name>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-328182011.html">328182011</Bro
wseNodeId>
       <Name>href="http://www.browsenodes.com/node-328182011.html">Power & Hand
Tools</Name>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-13749581.html">13749581</Brows
eNodeId>
       <Name>href="http://www.browsenodes.com/node-13749581.html">Rough
Plumbing</Name>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-3180231.html">3180231</BrowseN
odeId>
       <Name>href="http://www.browsenodes.com/node-3180231.html">Safety &
Security</Name>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-13400631.html">13400631</Brows
eNodeId>
       <Name>href="http://www.browsenodes.com/node-13400631.html">Storage & Home
Organization</Name>
      </BrowseNode>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-8106310011.html">8106310011</B
rowseNodeId>
       <Name>href="http://www.browsenodes.com/node-8106310011.html">Welding &
Soldering</Name>
      </BrowseNode>
     </Children>
     <Ancestors>
      <BrowseNode>
       <BrowseNodeId>href="http://www.browsenodes.com/node-228013.html">228013</BrowseNod
eId>
       <Name>href="http://www.browsenodes.com/node-228013.html">Tools & Home
Improvement</Name>
      </BrowseNode>
     </Ancestors>
    </BrowseNode>
   </BrowseNodes>
  </Item>
 </Items>
</ItemSearchResponse>


Copyright © 2019 by Roger Smith