{
    "info": {
        "author": "Alex Kaszynski",
        "author_email": "akascap@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 5 - Production/Stable",
            "Intended Audience :: End Users/Desktop",
            "License :: OSI Approved :: Apache Software License",
            "Programming Language :: Python :: 2.7",
            "Programming Language :: Python :: 3.4",
            "Programming Language :: Python :: 3.5",
            "Programming Language :: Python :: 3.6",
            "Programming Language :: Python :: 3.7",
            "Topic :: Database :: Front-Ends"
        ],
        "description": "keepa\n=====\n\n.. image:: https://img.shields.io/pypi/v/keepa.svg?logo=python&logoColor=white\n   :target: https://pypi.org/project/keepa/\n\n.. image:: https://travis-ci.org/akaszynski/keepa.svg?branch=master\n    :target: https://travis-ci.org/akaszynski/keepa\n\n.. image:: https://readthedocs.org/projects/keepaapi/badge/?version=latest\n    :target: https://keepaapi.readthedocs.io/en/latest/?badge=latest\n    :alt: Documentation Status\n\n.. image:: https://codecov.io/gh/akaszynski/keepa/branch/master/graph/badge.svg\n  :target: https://codecov.io/gh/akaszynski/keepa\n\nPython module to interface to `Keepa <https://keepa.com/>`_ to query for Amazon product information and history.\n\nDocumentation can be found on readthedocs at `keepa Documentation <https://keepaapi.readthedocs.io/en/latest/>`_.\n\n\nRequirements\n------------\nModule is compatible with Python 2 and 3. keepa requires:\n\n - ``numpy``\n - ``requests``\n\nProduct history can be plotted from the raw data when ``matplotlib`` is installed.\n\nInterfacing with the ``keepa`` requires an access key and a monthly subscription from `Keepa API <https://keepa.com/#!api>`_\n\n\nInstallation\n------------\nModule can be installed from PyPi with:\n\n  pip install keepa\n\nSource code can also be downloaded from `GitHub <https://github.com/akaszynski/keepa>`_ and installed using ``python setup.py install`` or ``pip install .``\n\n\nBrief Example\n-------------\n.. code:: python\n\n    import keepa\n    accesskey = 'XXXXXXXXXXXXXXXX' # enter real access key here\n    api = keepa.Keepa(accesskey)\n\n    # Single ASIN query\n    products = api.query('B0088PUEPK') # returns list of product data\n\n    # Plot result (requires matplotlib)\n    keepa.plot_product(products[0])\n\n.. figure:: https://github.com/akaszynski/keepa/raw/master/docs/source/images/Product_Price_Plot.png\n    :width: 500pt\n\n    Product Price Plot\n\n.. figure:: https://github.com/akaszynski/keepa/raw/master/docs/source/images/Product_Offer_Plot.png\n    :width: 500pt\n\n    Product Offers Plot\n\n\nDetailed Example\n----------------\n\nImport interface and establish connection to server\n\n.. code:: python\n\n    import keepa\n    accesskey = 'XXXXXXXXXXXXXXXX' # enter real access key here\n    api = keepa.Keepa(accesskey)\n\nSingle ASIN query\n\n.. code:: python\n\n    products = api.query('059035342X')\n\n    # See help(api.query) for available options when querying the API\n\nMultiple ASIN query from List\n\n.. code:: python\n\n    asins = ['0022841350', '0022841369', '0022841369', '0022841369']\n    products = api.query(asins)\n\nMultiple ASIN query from numpy array\n\n.. code:: python\n\n    asins = np.asarray(['0022841350', '0022841369', '0022841369', '0022841369'])\n    products = api.query(asins)\n\nProducts 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 <http://www.amazon.com>`_.\n\n.. code:: python\n\n    # Available keys\n    print(products[0].keys())\n\n    # Print ASIN and title\n    print('ASIN is ' + products[0]['asin'])\n    print('Title is ' + products[0]['title'])\n\nThe raw data is contained within each product result. Raw data is stored as a dictionary with each key paired with its associated time history.\n\n.. code:: python\n\n    # Access new price history and associated time data\n    newprice = products[0]['data']['NEW']\n    newpricetime = products[0]['data']['NEW_time']\n\n    # Can be plotted with matplotlib using:\n    import matplotlib.pyplot as plt\n    plt.step(newpricetime, newprice, where='pre')\n\n    # Keys can be listed by\n    print(products[0]['data'].keys())\n\nThe product history can also be plotted from the module if ``matplotlib`` is installed\n\n.. code:: python\n\n    keepa.plot_product(products[0])\n\nYou can obtain the offers history for an ASIN (or multiple ASINs) using the ``offers`` parameter.  See the documentation at `Request Products <https://keepa.com/#!discuss/t/request-products/110/1>`_ for further details.\n\n.. code:: python\n\n    products = api.query(asins, offers=20)\n    product = products[0]\n    offers = product['offers']\n\n    # each offer contains the price history of each offer\n    offer = offers[0]\n    csv = offer['offerCSV']\n\n    # convert these values to numpy arrays\n    times, prices = keepa.convert_offer_history(csv)\n\n    # for a list of active offers, see\n    indices = product['liveOffersOrder']\n\n    # with this you can loop through active offers:\n    indices = product['liveOffersOrder']\n    offer_times = []\n    offer_prices = []\n    for index in indices:\n        csv = offers[index]['offerCSV']\n        times, prices = keepa.convert_offer_history(csv)\n        offer_times.append(times)\n        offer_prices.append(prices)\n\n    # you can aggregate these using np.hstack or plot at the history individually\n    import matplotlib.pyplot as plt\n    for i in range(len(offer_prices)):\n        plt.step(offer_times[i], offer_prices[i])\n    plt.show()\n\n\nCredits\n-------\nThis Python code, written by Alex Kaszynski, is based on Java code written by Marius Johann, CEO keepa. Java source is can be found at `api_backend <https://github.com/keepacom/api_backend/>`_.\n\n\nLicense\n-------\nApache License, please see license file. Work is credited to both Alex Kaszynski and Marius Johann.",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/akaszynski/keepa",
        "keywords": "keepa",
        "license": "Apache Software License",
        "maintainer": "",
        "maintainer_email": "",
        "name": "keepa",
        "package_url": "https://pypi.org/project/keepa/",
        "platform": "",
        "project_url": "https://pypi.org/project/keepa/",
        "project_urls": {
            "Homepage": "https://github.com/akaszynski/keepa"
        },
        "release_url": "https://pypi.org/project/keepa/0.19.2/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Interfaces with keepa.com",
        "version": "0.19.2"
    },
    "last_serial": 5856796,
    "releases": {
        "0.16.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6063200bf335af580bf3744d008c17b2",
                    "sha256": "28dd566392fdc69057518b8eba4ab92058819c0b7e92b8b7d7b3b3f06d933414"
                },
                "downloads": -1,
                "filename": "keepa-0.16.0.tar.gz",
                "has_sig": false,
                "md5_digest": "6063200bf335af580bf3744d008c17b2",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14416,
                "upload_time": "2019-02-23T13:46:05",
                "url": "https://files.pythonhosted.org/packages/ce/1f/e88b41ee52fa7dde2f686fb3c8a44619464bf50ff2e9e5b9cd1f5f071fc4/keepa-0.16.0.tar.gz"
            }
        ],
        "0.16.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "103c3de77a6019593269bc31bcdb145c",
                    "sha256": "8156357439df88ec57eaea2e65c676f0d3dc81c4f182790ba6c86cb5cbf85143"
                },
                "downloads": -1,
                "filename": "keepa-0.16.1.tar.gz",
                "has_sig": false,
                "md5_digest": "103c3de77a6019593269bc31bcdb145c",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14423,
                "upload_time": "2019-02-23T14:30:00",
                "url": "https://files.pythonhosted.org/packages/51/42/fa6a302d2d709e04b9c1d5c527a8b7a1fac907d5b217442197a4f0717796/keepa-0.16.1.tar.gz"
            }
        ],
        "0.16.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ba4cd4a7523aab7e4a91500363188874",
                    "sha256": "65cffef5edfae68b61637a11d54136460820fcd30f140f33fb7974c406c3c98a"
                },
                "downloads": -1,
                "filename": "keepa-0.16.2.tar.gz",
                "has_sig": false,
                "md5_digest": "ba4cd4a7523aab7e4a91500363188874",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14427,
                "upload_time": "2019-02-23T14:37:48",
                "url": "https://files.pythonhosted.org/packages/87/dc/e45e9babc63cd9acee21da8a8ba8fec9eca1e429b1d40b95b3c5548bb293/keepa-0.16.2.tar.gz"
            }
        ],
        "0.16.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "5e1b493a48fc9c0f723f95d8c5cb2db5",
                    "sha256": "6fb1dc93ae6e41e2c36a29791237e194627f76d92c4b4b255e28bbf4f20c8097"
                },
                "downloads": -1,
                "filename": "keepa-0.16.3.tar.gz",
                "has_sig": false,
                "md5_digest": "5e1b493a48fc9c0f723f95d8c5cb2db5",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14471,
                "upload_time": "2019-02-27T11:21:17",
                "url": "https://files.pythonhosted.org/packages/8c/4b/3713be9635359482001cf725e987bf56afc694ac68ca80d82068b01252a1/keepa-0.16.3.tar.gz"
            }
        ],
        "0.17.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c21467537224c502db05b854b799d294",
                    "sha256": "ba4e709b1e8942ebf8ddfe1166116be24cda311e582479fbafa5f51a64fe176a"
                },
                "downloads": -1,
                "filename": "keepa-0.17.0.tar.gz",
                "has_sig": false,
                "md5_digest": "c21467537224c502db05b854b799d294",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14835,
                "upload_time": "2019-04-06T21:30:02",
                "url": "https://files.pythonhosted.org/packages/8b/d8/8a62a7638388e971d3c34aeb5bf9f05c21e0da4cc0cec079155d4e678a7b/keepa-0.17.0.tar.gz"
            }
        ],
        "0.17.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "5eb3415094efbbcc4ea5372c3a1b719d",
                    "sha256": "0664b9c976db836f0021fbdb5757d30a00342f74c211bd164671ac4a34c00444"
                },
                "downloads": -1,
                "filename": "keepa-0.17.1.tar.gz",
                "has_sig": false,
                "md5_digest": "5eb3415094efbbcc4ea5372c3a1b719d",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14149,
                "upload_time": "2019-04-09T09:52:49",
                "url": "https://files.pythonhosted.org/packages/53/27/19b3131383374bd7b5939c08133956412b926e9b995732b3422a2138e931/keepa-0.17.1.tar.gz"
            }
        ],
        "0.17.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "9aff14d056f26f8dee1855aadfc54417",
                    "sha256": "db7ac3ede7589f8b3c0048be1365da412fdabdefbc65630f9067dd4da9c9eca3"
                },
                "downloads": -1,
                "filename": "keepa-0.17.2.tar.gz",
                "has_sig": false,
                "md5_digest": "9aff14d056f26f8dee1855aadfc54417",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14153,
                "upload_time": "2019-04-09T15:01:52",
                "url": "https://files.pythonhosted.org/packages/91/3c/6af19fb6c7222922407ef15515ba49af6f7055b22510db4d8e2fac1d7811/keepa-0.17.2.tar.gz"
            }
        ],
        "0.18.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "51d1f10c50e6818750da428100036539",
                    "sha256": "f74a63579c8becc16a023f98f4df06106566db525a9c22bfce12e51e0a658c5d"
                },
                "downloads": -1,
                "filename": "keepa-0.18.0.tar.gz",
                "has_sig": false,
                "md5_digest": "51d1f10c50e6818750da428100036539",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 24420,
                "upload_time": "2019-06-12T07:35:50",
                "url": "https://files.pythonhosted.org/packages/62/71/f8fdd8e7bc5b39688713892a01f28e44ce59496ec6ca8a99515a67b1ede2/keepa-0.18.0.tar.gz"
            }
        ],
        "0.19.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "5f4563ab75f56b35aab10bbbecda7993",
                    "sha256": "8db0366a216a95c42bf7c316d16a98af17466a3303f604c56528fbbf6de3e720"
                },
                "downloads": -1,
                "filename": "keepa-0.19.0.tar.gz",
                "has_sig": false,
                "md5_digest": "5f4563ab75f56b35aab10bbbecda7993",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 23582,
                "upload_time": "2019-09-12T16:36:50",
                "url": "https://files.pythonhosted.org/packages/7b/6a/7121db5ac786c2408d044cad77a8a89f2560e13c50e0767d1297dc667762/keepa-0.19.0.tar.gz"
            }
        ],
        "0.19.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "1d5e8189eb8fb4054c49e28fb875257c",
                    "sha256": "3523d3c59995a56370c2e9c023b62aecb05d350967ffca4aa0be8eab2c408bff"
                },
                "downloads": -1,
                "filename": "keepa-0.19.1.tar.gz",
                "has_sig": false,
                "md5_digest": "1d5e8189eb8fb4054c49e28fb875257c",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 23580,
                "upload_time": "2019-09-16T07:49:45",
                "url": "https://files.pythonhosted.org/packages/44/fa/2ddde1dbebccd777ffc748ed578748ef62b0a7f45eefb2d92902df9b9517/keepa-0.19.1.tar.gz"
            }
        ],
        "0.19.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6122ec4e030702a4b4774bf5f21db51f",
                    "sha256": "a9bceb3f74b90b81ad6978fcb63541f2b2f8491006dd8f800df196597157411d"
                },
                "downloads": -1,
                "filename": "keepa-0.19.2.tar.gz",
                "has_sig": false,
                "md5_digest": "6122ec4e030702a4b4774bf5f21db51f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 23586,
                "upload_time": "2019-09-19T14:29:54",
                "url": "https://files.pythonhosted.org/packages/80/a2/25098ec662f1cd42194abf618fca1559ddcc8990da007b98115b0364618b/keepa-0.19.2.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "6122ec4e030702a4b4774bf5f21db51f",
                "sha256": "a9bceb3f74b90b81ad6978fcb63541f2b2f8491006dd8f800df196597157411d"
            },
            "downloads": -1,
            "filename": "keepa-0.19.2.tar.gz",
            "has_sig": false,
            "md5_digest": "6122ec4e030702a4b4774bf5f21db51f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 23586,
            "upload_time": "2019-09-19T14:29:54",
            "url": "https://files.pythonhosted.org/packages/80/a2/25098ec662f1cd42194abf618fca1559ddcc8990da007b98115b0364618b/keepa-0.19.2.tar.gz"
        }
    ]
}