Interfaces with keepa.com
Python module to interface to Keepa to query for Amazon product information and history.
Module is compatible with Python 2 and 3. keepaAPI requires:
Product history can be plotted from the raw data when matplotlib is installed.
Interfacing with the keepaAPI requires an accesskey and a monthly subscription from https://keepa.com/#!api
Module can be installed from PyPi using pip install keepaAPI
Source code can also be downloaded from GitHub and installed using python setup.py install or pip install .
import keepaAPI accesskey = 'XXXXXXXXXXXXXXXX' # enter real access key here api = keepaAPI.API(accesskey) # Single ASIN query products = api.ProductQuery('059035342X') # returns list of product data # Plot result (requires matplotlib) keepaAPI.PlotProduct(products)
Import interface and establish connection to server
import keepaAPI accesskey = 'XXXXXXXXXXXXXXXX' # enter real access key here api = keepaAPI.API(accesskey)
Single ASIN query
products = api.ProductQuery('059035342X') # See help(api.ProductQuery) for available options when querying the API
Multiple ASIN query from List
asins = ['0022841350', '0022841369', '0022841369', '0022841369'] products = api.ProductQuery(asins)
Multiple ASIN query from numpy array
asins = np.asarray(['0022841350', '0022841369', '0022841369', '0022841369']) products = api.ProductQuery(asins)
Products is a list of product data with one entry per successful result from the Keepa server. Each entry is a dictionary containing the same product data available from Amazon.
# Available keys print(products.keys()) # Print ASIN and title print('ASIN is ' + products['asin']) print('Title is ' + products['title'])
The raw data is contained within each product result. Raw data is stored as a dictonary with each key paired with its associated time history.
# Access new price history and associated time data newprice = products['data']['NEW'] newpricetime = products['data']['NEW_time'] # Can be plotted with matplotlib using: import matplotlib.pyplot as plt plt.step(newpricetime, newprice, where='pre') # Keys can be listed by print(products['data'].keys())
The product history can also be plotted from the module if matplotlib is installed
You can obtain the offers history for an ASIN (or multiple ASINs) using the offers parameter. See the documentation at Request Products for further details.
products = api.ProductQuery(asins) product = products offers = product['offers'] # each offer contains the price history of each offer offer = offers csv = offer['offerCSV'] # convert these values to numpy arrays times, prices = ConvertOfferHistory(csv) # for a list of active offers, see indices = product['liveOffersOrder'] # with this you can loop through active offers: indices = product['liveOffersOrder'] offer_times =  offer_prices =  for index in indices: csv = offers[index]['offerCSV'] times, prices = keepaAPI.ConvertOfferHistory(csv) offer_times.append(times) offer_prices.append(prices) # you can aggregrate these using np.hstack or plot at the history individually import matplotlib.pyplot as plt for i in range(len(offer_prices)): plt.step(offer_times[i], offer_prices[i]) plt.show()
This Python code, written by Alex Kaszynski, is based on Java code writen by Marius Johann, CEO keepa. Java source is can be found at https://github.com/keepacom/api_backend/
Apache License, please see license file. Work is credited to both Alex Kaszynski and Marius Johann.