Product Advertising API - AWS Documentation

1 Product Advertising APID eveloper GuideAPI Version 2013-08-01 Product Advertising API Developer GuideProduct Advertising API: Developer GuideCopyright 2015 and its affiliates. All rights Advertising API Developer GuideTable of ContentsWelcome .. 1 overview of Product Advertising API .. 1 Audience .. 1 Required Knowledge and Skills .. 1 How This Guide Is Organized .. 2 Programming Guide .. 3 Getting Started .. 4 Sign up as an Amazon Associate .. 4 Sign up for the Product Advertising API .. 5 Reading the Licensing Agreement .. 6 Using the Product Advertising API Scratchpad .. 7 Migrating your Product Advertising API Account from your AWS Account .. 8 Managing your Existing AWS Security Credentials for the Product Advertising API.

2 9E-Commerce and Web Services .. 11 What Is E-commerce? .. 12 What Is a Web Service? .. 12 What Is XML?.. 12 What Is a WSDL?.. 14 What Is a Schema?.. 20 Product Advertising API Terminology and Basic Concepts .. 21 The Marketplace .. 22 What Is the Product Advertising API? .. 22 How Do I Make Money Using the Product Advertising API? .. 22 Items for 23 Summary of Product Advertising API Operations .. 25 Visual Introduction to Product Advertising API .. 27 Search for Items .. 27 Find More Item Information .. 28 Create a Shopping Cart .. 29 Organization of Items on Amazon .. 29 Browse Nodes .. 29 Search Indices .. 34 Requests .. 40 Anatomy of a REST Request .. 41 REST Syntax.

3 43 SOAP Requests .. 45 Request Authentication .. 47 Batch Requests .. 60 Parameters Common to All Product Advertising API Requests .. 62 Responses .. 65 Paging and Sorting Through Responses .. 69 Find Items to 71 Search Operations .. 71 Items You Cannot Buy .. 72 Items Sold by Merchants .. 74 Common ItemSearch Parameters .. 75 Power Searches .. 80 Use Search Bins to Find Items .. 83 Find Items with Browse Nodes .. 89 Request and Response Examples .. 93 Motivate Customers to 116 Promotions .. 116 Reviews .. 119 Suggest Similar Items to 120 API Version 2013-08-01iiiProduct Advertising API Developer GuideTop Sellers .. 127 New Releases .. 129 Sort by Popularity, Price, or Condition.

4 130 Returning Price and Availability Information .. 132 Returning Prices .. 132 Determining Availability .. 137 Working With Remote Shopping Carts .. 140 Shopping Cart Concepts .. 140 Remote Shopping Cart Tasks .. 144 Add to Cart Form .. 151 Purchase Items in a Remote Shopping Cart .. 153 Order Pipeline .. 153 Implement the Proceed to Checkout Button .. 154 PurchaseURL .. 154 Troubleshooting .. 155 Syntax and Parameter Errors .. 155 Retrieving Errors .. 157 Troubleshooting Applications .. 157 Error Codes and Messages .. 158 Best Programming Practices .. 164 Read the Product Advertising API Terms and Conditions .. 165 Use the Latest API Version .. 165 Understand Available Operations.

5 165 Use the Right Response Group .. 165 Use Your Associate Tag in Product Advertising API Requests .. 166 Handling Errors .. 166 Use Caches Carefully .. 166 Use the Correct AWSA ccessKeyId .. 166 Locale 167 Associate 168 General Differences .. 168 Shipping Restrictions .. 168 API Reference .. 170 ItemSearch .. 170 BrowseNodeLookup .. 186 SimilarityLookup .. 192 CartAdd .. 195 CartClear .. 200 CartCreate .. 203 CartGet .. 208 CartModify .. 212 Common Request Parameters .. 216 Response Groups .. 218 Accessories .. 219 AlternateVersions .. 220 BrowseNodeInfo .. 221 BrowseNodes .. 224 Cart .. 226 CartNewReleases .. 228 CartTopSellers .. 229 CartSimilarities .. 231 EditorialReview.

6 234 ItemAttributes .. 236 API Version 2013-08-01ivProduct Advertising API Developer 239 Large .. 245 MostGifted .. 249 MostWishedFor .. 251 NewReleases .. 257 OfferSummary .. 261 PromotionSummary .. 263 RelatedItems .. 265 Request .. 267 Reviews .. 270 SearchBins .. 278 TopSellers .. 279 Tracks .. 281 Variations .. 282 VariationImages .. 285 VariationMatrix .. 287 VariationOffers .. 289 VariationSummary .. 292 Response Elements Common to All Response Groups .. 294 Response Elements .. 295 Locale Reference for the Product Advertising API .. 315 Locale Information for the BR Marketplace .. 316 Locale Information for the CA Marketplace .. 318 Locale Information for the CN Marketplace.

7 332 Locale Information for the DE Marketplace .. 346 Locale Information for the ES Marketplace .. 366 Locale Information for the FR Marketplace .. 383 Locale Information for the IN Marketplace .. 399 Locale Information for the IT Marketplace .. 414 Locale Information for the JP Marketplace .. 430 Locale Information for the MX Marketplace .. 448 Locale Information for the UK Marketplace .. 455 Locale Information for the US Marketplace .. 475 ItemSearch Sort Values .. 497 Sort Values .. 497 Resources .. 501 Document History .. 502 API Version 2013-08-01vProduct Advertising API Developer GuideOverview of Product Advertising APIW elcomeTopics overview of Product Advertising API (p.)

8 1) Audience (p. 1) How This Guide Is Organized (p. 2) overview of Product Advertising APIA mazon has developed a world-class web service that millions of customers use every day. As adeveloper, you can build Product Advertising API applications that leverage this robust, scalable, andreliable technology. You get access to a lot of the data used by Amazon including the items for sale,customer reviews, seller reviews, as well as most of the functionality you see on , such asfinding items, displaying customer reviews, and Product promotions. Product Advertising API operationsopen the doors to Amazon's databases so that you can take advantage of Amazon's sophisticated e-commerce data and functionality.

9 Build your own web store to sell Amazon items or your own of all, Product Advertising API is free. By signing up to become a Product Advertising API developer,you join the tens of thousands of developers who are already realizing financial gains by creatingProduct Advertising API-driven applications and web Product Advertising API works1. Your application uses the Product Advertising API to display item descriptions, images, and reviewsto your Customers shop and add items to their shopping When the customer is ready to purchase the items, your application sends an HTML form to ProductAdvertising API and Amazon completes the purchase by getting purchase information, such aspayment method and shipping address.

10 Amazon then fulfills the order by shipping the guide is intended for developers who want to build an e-commerce storefront that sells items listedon , or an application that helps others build e-commerce Knowledge and SkillsUse of this guide assumes you are familiar with the following: XML (For an overview , see W3 Schools XML Tutorial.) Basic understanding of web services (For an overview , see XML Web Services.)If you are an Amazon Associate and are looking for general information, see Amazon Associates Tools forEvery Version 2013-08-011 Product Advertising API Developer GuideHow This Guide Is OrganizedHow This Guide Is OrganizedInformationTopicsLearn the basics about the Product AdvertisingAPIT erminology and Basic Concepts (p.)