Overview

Python bindings for Amazon's Product Advertising API

This module offers a light-weight access to the latest version of the Amazon Product Advertising API without getting in your way.

The Amazon Product Advertising API provides programmatic access to Amazon's product selection and discovery functionality. It has search and look up capabilities, provides information on products and other features such as Reviews, Similar Products and New and Used listings.

Basic usage

In order to use this API you'll obviously need an Amazon Associates Web Service account for which you must with Amazon at http://aws.amazon.com. Each account contains an AWSAccessKeyId and a SecretKey.

Here is an example how to use the API to search for books of a certain publisher:

AWS_KEY = '...'
SECRET_KEY = '...'

api = API(AWS_KEY, SECRET_KEY, 'de')
node = api.item_search('Books', Publisher='Galileo Press')

The node object returned is a lxml.objectified element. All its attributes can be accessed the pythonic way:

total_results = node.Items.TotalResults.pyval
total_pages = node.Items.TotalPages.pyval

# get all books from result set and
# print author and title
for book in node.Items.Item:
    print '%s: "%s"' % (book.ItemAttributes.Author,
                        book.ItemAttributes.Title)

Please refer to the more extensive documentation for more details.

Status

This module is still undergoing development. All operations can be used with the API's call(Operation=...) method. Additionally, there is a number of convenience methods that include for instance additional error checking. These are currently limited to:

  • ItemLookup
  • ItemSearch
  • SimilarityLookup
  • BrowseNodeLookup

More functionality is to follow as development progresses.

Installation

In order to install python-amazon-product-api you can use:

pip python-amazon-product-api

or download the source package from http://pypi.python.org/pypi/python-amazon-product-api, untar it and run

python setup.py install

You'll also find binaries there to make your life easier if you happen to use a Windows system. If not, please send me an e-mail and complain loudly!

Development

The development version is available bitbucket.org. Feel free to clone the repository and add your own features.

hg clone http://bitbucket.org/basti/python-amazon-product-api/

Patches are always welcome! Please make sure that your change does not break the tests!

License

This module is release under the BSD License. You can find the full text of the license in the LICENSE file.

Changelog