|Did this page help you? Yes | No | Tell us about it...|
Welcome to the Product Advertising API Getting Started Guide. Product Advertising API is a free service that gives you access to Amazon's world-class web service, a service that millions of customers use every day. As a developer, you can build Product Advertising API applications that leverage this robust, scalable, and reliable technology. You get access to much of the data that Amazon uses, including the items for sale, customer reviews, seller reviews, as well as most of the functionality that you see on www.amazon.com, such as finding items, finding similar items, displaying customer reviews, and product promotions. In short, Product Advertising API operations open the doors to Amazon's databases so that you can take advantage of Amazon's sophisticated e-commerce data and functionality. Using Product Advertising API, you can build your own web store to sell Amazon items or your own items, or you can build an application that helps others create their own e-commerce storefronts.
This guide is divided into several major sections that allow you to practice using Product Advertising API in a simple environment. Each of the sections listed here builds on the previous sections, so that if you read and work through the examples in sequence, you gain a basic understanding of the Product Advertising API.
What is Product Advertising API?—The rest of this section describes the key concepts of Product Advertising API, the knowledge required to use it, and related resources that you can use to interact with the service.
Getting Started—The Getting Started section describes how to become an Amazon Associate and get the identifiers you need to submit requests.
Beyond the getting started section, you’ll probably want to learn more about Product Advertising API operations. The following sections provide detailed information about working with Product Advertising API requests and responses:
Narrowing search results with response
ItemSearch function can take a variety
of parameters that help narrow the list of items to only those that match the customer's
wishes. Response groups are included in requests either by default or explicitly.
Response groups select from all of the item data returned to determine which data to
display. The Offer response group, for example, returns information about an item's
offer, that is, its price and availability.
Narrowing search results with request parameters—Search indices are used to restrict a request to a certain portion of Amazon's database. The database, called the catalog, contains millions of items. Returning 100,000 items is not useful to the customer. So, request parameters, including the search index, are used to narrow the results to make them match the customer's expectation. For example, a Harry Potter book and the DVD of that book reside in different search indices. By specifying the search index, you return the information relevant to the customer's interest.
Structured requests and responses—Requests are structured. Each has an endpoint, which is the URL of the Product Advertising API, webservices.amazon.com. Responses, by default, are returned in XML, which makes parsing the response easier.
Making REST requests to search for items—One of the first and most common tasks a customer undertakes is searching for items to buy. They supply search parameters, such as whether they are looking for a book, DVD, or article of clothing. This guide shows how to make a REST request in multiple computer languages that searches through Amazon's catalog of items and selects those that are related to the keywords entered on the command line. The response processing code assumes the items returned are books. The response is parsed so that the title, author, and price of the item are displayed.
This guide assumes that you are familiar with XML syntax and structure and that you have a basic understanding of web services. For overviews of these topics, go to the following links:
In addition, you need to be familiar with one of these programming languages: Java, C#, PHP, and Perl.
You can hide the sections of this guide that don't apply to the programming language you are using. There is a language selection menu in the upper-right corner of pages with language-specific text. Select your language to hide all others, or select All to show the examples in all available languages.
The following table lists related resources that you'll find useful as you work with Product Advertising API.
|Product Advertising API Developer Guide||The Developer Guide provides a detailed discussion of the Product Advertising API. It includes an architectural overview, programming reference, and API reference.|
|Product Advertising API information||The primary web page for information about Product Advertising API.|
|Discussion Forums||A community-based forum for developers to discuss technical questions related to Amazon Web Services.|
|Contact Us||A central contact point for inquiries concerning AWS billing, account, events, abuse, etc.|
|Conditions of Use||Detailed information about the copyright and trademark usage at Amazon.com and other topics.|