Skip to main content

A Python wrapper for the Amazon Product Advertising API.

Project description

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.

Create a file ~/.amazon-product-api containing the following data:

[Credentials]
access_key = <your access key>
secret_key = <your secret key>
associate_tag = <your associate id>

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

from amazonproduct import API
api = API(locale='de')

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 api.item_search('Books', Publisher='Galileo Press'):
    print '%s: "%s"' % (book.ItemAttributes.Author,
                        book.ItemAttributes.Title)

In the background the API will iteratively retrieve all available result pages from Amazon and return each book in turn as a lxml.objectified element.

In general, this module offers a number of convenience methods that will deal with the nitty-gritty details like error checking so you won’t have to. Please refer to the extensive documentation for more details.

Installation

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

pip install 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-amazon-product-api-0.2.7.tar.gz (504.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page