{ "info": { "author": "Michael Bock", "author_email": "api@edmunds.com", "bugtrack_url": null, "classifiers": [], "description": "# Edmunds API Python Wrapper\n\nThis is an awesome Python 2 wrapper for the [Edmunds.com API](http://developer.edmunds.com/api-documentation/overview/index.html).\nThe Edmunds.com API provides automative data including [vehicle specs](http://developer.edmunds.com/api-documentation/vehicle/), \n[pricing](http://developer.edmunds.com/api-documentation/vehicle/price_tmv/v1/), [media](http://developer.edmunds.com/api-documentation/vehicle/media_photos/v1/), \n[reviews](http://developer.edmunds.com/api-documentation/vehicle/content_ratings_and_reviews/v2/), and [more](http://developer.edmunds.com/api-documentation/overview/index.html#sec-6). \nThere are also Edmunds API endpoints for [dealership information](http://developer.edmunds.com/api-documentation/dealer/) \nand [Edmunds editorial content](http://developer.edmunds.com/api-documentation/editorial/).\n\n## Usage\nEnter your [Edmunds API key](http://edmunds.mashery.com/member/register/):\n```python\nfrom edmunds import Edmunds\napi = Edmunds('YOUR API KEY') # use Edmunds('YOUR API KEY', True) for debug mode\n```\n\nMake API calls to any endpoint, get a JSON object returned.\nFor example, get the [style details](http://developer.edmunds.com/api-documentation/vehicle/spec_style/v2/01_by_mmy/api-description.html) \nfor the 2011 Lexus RX 350:\n```python\n>>> response = api.make_call('/api/vehicle/v2/lexus/rx350/2011/styles')\n>>> response\n{u'styles': [{u'id': 101353967,\n u'make': {u'id': 200001623, u'name': u'Lexus', u'niceName': u'lexus'},\n u'model': {u'id': u'Lexus_RX_350',\n u'name': u'RX 350',\n u'niceName': u'rx-350'},\n u'name': u'4dr SUV (3.5L 6cyl 6A)',\n u'submodel': {u'body': u'SUV', u'modelName': u'RX 350 SUV'},\n u'trim': u'Base',\n u'year': {u'id': 100533091, u'year': 2011}},\n {u'id': 101353968,\n u'make': {u'id': 200001623, u'name': u'Lexus', u'niceName': u'lexus'},\n u'model': {u'id': u'Lexus_RX_350',\n u'name': u'RX 350',\n u'niceName': u'rx-350'},\n u'name': u'4dr SUV AWD (3.5L 6cyl 6A)',\n u'submodel': {u'body': u'SUV', u'modelName': u'RX 350 SUV'},\n u'trim': u'Base',\n u'year': {u'id': 100533091, u'year': 2011}}],\n u'stylesCount': 2}\n```\n\nGet [photos](http://developer.edmunds.com/api-documentation/vehicle/media_photos/v1/) \nfor the style ID 3883 (1990 Honda Civic 2dr Hatchback):\n```python\n>>> response = api.make_call('/v1/api/vehiclephoto/service/findphotosbystyleid', comparator='simple', styleId='3883')\n>>> response\n[{u'authorNames': [u'American Honda Motor Company, Inc.'],\n u'captionTranscript': u'1991 Honda Civic 2 Dr Si Hatchback',\n u'photoSrcs': [u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_131.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_396.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_300.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_400.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_500.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_185.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_175.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_196.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_423.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_276.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_87.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_150.jpg',\n u'/honda/civic/1991/oem/1991_honda_civic_2dr-hatchback_si_fq_oem_1_98.jpg'],\n u'shotTypeAbbreviation': u'FQ',\n u'subType': u'exterior',\n u'type': u'PHOTOS'}]\n```\n\n## Installation \n\nThe Edmunds API Python wrapper requires the amazing [requests library](http://docs.python-requests.org/en/latest/).\nHere are the [installation instructions](http://docs.python-requests.org/en/latest/user/install/#install) and the\n[source code](https://github.com/kennethreitz/requests/).\n\nTo install using pip:\n\n```pip install git+https://github.com/EdmundsAPI/sdk-python```\n\nThen:\n\n```git clone https://github.com/EdmundsAPI/sdk-python.git```\nor just click \"Clone in Desktop\" or \"Download ZIP\"\n\n![Install](https://photos-2.dropbox.com/t/0/AAAwB573IRFx7wrFhdmUilGQBgIcSTEjKFIoQ2sf1XsNMw/12/16428977/png/1024x768/3/1397286000/0/2/Screenshot%202014-04-12%2013.29.55.png/Aacyj_dQNGVCjJbyiazWcdk6538H61urhhFak44v-FA)\n\n\nNotes: \n* Using pip to install this package will atuomatically install the requests library\n* The files (edmunds.py and tests.py) will be installed to your Python site-packages folder\n* It is suggested you then clone the repository (using the second command) in order to download all of the files to your computer and so that you can insert your API Key into the edmunds.py code\n\n## Contents\n\n```python\nsdk-python/\n .gitignore\n AUTHORS.md # Info about development and how to contribute\n HISTORY.md # Version history\n LICENSE\n README.md # You're looking at it!\n requirements.txt\n setup.py\n edmunds/\n examples/ # Examples of using the SDK\n README.md\n media_photos.py\n spec_make.py\n __init__.py\n edmunds.py # The source code for the SDK\n tests.py\n```\n\n## Issues\n\nPlease submit any problems, requests, and comments [here](https://github.com/EdmundsAPI/sdk-python/issues).\n\n## SDK Status\n\nThis is a beta release. We have opened sourced it at this stage to guide the development of the library and allow you to freely inspect and use the source.\n\n## Documentation\n\nThe Edmunds API documentation can be found [here](http://developer.edmunds.com/api-documentation/overview/index.html).\n\n## License\n\nLicensed under the Apache v2 License.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/EdmundsAPI/sdk-python", "keywords": null, "license": "LICENSE", "maintainer": null, "maintainer_email": null, "name": "edmunds", "package_url": "https://pypi.org/project/edmunds/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/edmunds/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/EdmundsAPI/sdk-python" }, "release_url": "https://pypi.org/project/edmunds/0.1.4/", "requires_dist": null, "requires_python": null, "summary": "This is an awesome Python 2 wrapper for the Edmunds.com API.", "version": "0.1.4" }, "last_serial": 1058410, "releases": { "0.1.4": [ { "comment_text": "", "digests": { "md5": "57f18e67755c9c6178f1b91d6d61f0bf", "sha256": "da9eb0e99d757462aba54316c349b8a05ea2ac23ae49669488e76e4a273271fe" }, "downloads": -1, "filename": "edmunds-0.1.4.macosx-10.5-i386.exe", "has_sig": false, "md5_digest": "57f18e67755c9c6178f1b91d6d61f0bf", "packagetype": "bdist_wininst", "python_version": "any", "requires_python": null, "size": 71918, "upload_time": "2014-04-12T06:19:04", "url": "https://files.pythonhosted.org/packages/53/f7/35c63657174e44dd5481cdfb36eaed6e6723a85cddbae1b952560c27a0b7/edmunds-0.1.4.macosx-10.5-i386.exe" }, { "comment_text": "", "digests": { "md5": "31ec3854dcb60cdacf5fff16210951c4", "sha256": "d5ac8d101b16083922cca6426604f0d61d806ad24bcc743983f7d159a8978e68" }, "downloads": -1, "filename": "edmunds-0.1.4.tar.gz", "has_sig": false, "md5_digest": "31ec3854dcb60cdacf5fff16210951c4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10239, "upload_time": "2014-04-12T06:19:00", "url": "https://files.pythonhosted.org/packages/41/a8/1ea9eda4289a5fdf44c48677019ade3c43d4dcd7e98918c2119cebafcf94/edmunds-0.1.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "57f18e67755c9c6178f1b91d6d61f0bf", "sha256": "da9eb0e99d757462aba54316c349b8a05ea2ac23ae49669488e76e4a273271fe" }, "downloads": -1, "filename": "edmunds-0.1.4.macosx-10.5-i386.exe", "has_sig": false, "md5_digest": "57f18e67755c9c6178f1b91d6d61f0bf", "packagetype": "bdist_wininst", "python_version": "any", "requires_python": null, "size": 71918, "upload_time": "2014-04-12T06:19:04", "url": "https://files.pythonhosted.org/packages/53/f7/35c63657174e44dd5481cdfb36eaed6e6723a85cddbae1b952560c27a0b7/edmunds-0.1.4.macosx-10.5-i386.exe" }, { "comment_text": "", "digests": { "md5": "31ec3854dcb60cdacf5fff16210951c4", "sha256": "d5ac8d101b16083922cca6426604f0d61d806ad24bcc743983f7d159a8978e68" }, "downloads": -1, "filename": "edmunds-0.1.4.tar.gz", "has_sig": false, "md5_digest": "31ec3854dcb60cdacf5fff16210951c4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10239, "upload_time": "2014-04-12T06:19:00", "url": "https://files.pythonhosted.org/packages/41/a8/1ea9eda4289a5fdf44c48677019ade3c43d4dcd7e98918c2119cebafcf94/edmunds-0.1.4.tar.gz" } ] }