Metadata-Version: 2.1
Name: amazon-paapi5
Version: 1.0.0
Summary: Amazon Product Advertising API 5.0 wrapper for Python
Home-page: https://github.com/alefiori82/amazon-paapi5
Author: Alessandro Fiori
Author-email: alessandro.fiori@gmail.com
License: GPL-3.0
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: amightygirl.paapi5-python-sdk

Amazon Product Advertising API 5.0 wrapper for Python
=======================================================
A simple Python wrapper for the last version of the Amazon Product Advertising API. This module allows to get product information from Amazon using the official API in an easier way.
Like Bottlenose you can use cache reader and writer to limit the number of api calls.

[![PyPI](https://img.shields.io/pypi/v/amazon-paapi5?color=%231182C2&label=PyPI)](https://pypi.org/project/amazon-paapi5/)
[![Python](https://img.shields.io/github/pipenv/locked/python-version/alefiori82/amazon-paapi5/master?label=python)](https://www.python.org/)
[![License](https://img.shields.io/badge/License-GPL--3.0-%23e83633)](https://github.com/alefiori82/amazon-paapi5/blob/master/LICENSE)
[![Support](https://img.shields.io/badge/Support-Good-brightgreen)](https://github.com/alefiori82/amazon-paapi5/issues)
[![Amazon API](https://img.shields.io/badge/Amazon%20API-5.0-%23FD9B15)](https://webservices.amazon.com/paapi5/documentation/)
![](https://github.com/alefiori82/amazon-paapi5/workflows/Upload%20Python%20Package/badge.svg)
![](https://github.com/alefiori82/amazon-paapi5/workflows/Build%20package/badge.svg)


Features
--------

* Object oriented interface for simple usage.
* Get multiple products at once.
* Use cache to save api calls
* Ask for new features through the [issues](https://github.com/alefiori82/amazon-paapi5/issues) section.

Installation
-------------

You can install or upgrade the module with:

    pip install amazon-paapi5 --upgrade

Usage guide
-----------
Basic usage:

    from amazon.paapi import AmazonAPI
    amazon = AmazonAPI(KEY, SECRET, TAG, COUNTRY)
    products = amazon.search_items('harry potter')

Get multiple product information:

    products = amazon.get_items(item_ids=['B01N5IB20Q','B01F9G43WU'])
    print(product[0].image_large)
    print(product[1].prices.price)


Get variations

    products = amazon.get_variations(asin=['B01N5IB20Q','B01F9G43WU'])

Get browse nodes

    browseNodes = amazon.get_browse_nodes(browse_node_ids=['473535031'])

Use cache reader and writer

    DATA = []

    def custom_save_function(url, data): 
        DATA.append({'url':url, 'data': data}) 

    def custom_retrieval_function(url): 
        for item in DATA: 
            if item["url"] == url: 
                return item['data'] 
        return None

    amazon = AmazonAPI(KEY, SECRET, TAG, COUNTRY, CacheReader=custom_retrieval_function, CacheWriter=custom_save_function) 
    products = amazon.search_items('harry potter')


Changelog
-------------

    Version 1.0.0
        - CacheReader and CacheWriter
        - Enable throttling
    Version 0.1.0
        - First release






