{ "info": { "author": "John W. Miller", "author_email": "", "bugtrack_url": null, "classifiers": [ "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Topic :: Software Development :: Libraries" ], "description": "# \ud83e\udd44 spoonacular \ud83e\udd44\n---\n[![Build Status](https://travis-ci.org/johnwmillr/SpoonacularAPI.svg?branch=master)](https://travis-ci.org/johnwmillr/SpoonacularAPI)\n[![PyPI version](https://badge.fury.io/py/spoonacular.svg)](https://pypi.org/project/spoonacular/)\n[![Python version](https://img.shields.io/badge/python-3.x-brightgreen.svg)](https://pypi.org/project/spoonacular/)\n\nWant to parse a list of [ingredients](https://rapidapi.com/spoonacular/api/Recipe%20-%20Food%20-%20Nutrition/functions/Parse%20Ingredients) within a recipe? Or are you looking for a random [food joke](https://rapidapi.com/spoonacular/api/Recipe%20-%20Food%20-%20Nutrition/functions/Get%20a%20Random%20Food%20Joke)? These are just two of many endpoints provided by the marvelous [Spoonacular](https://spoonacular.com/) food and recipes API. `spoonacular` provides a simple Python interface to this API.\n\n## Installation\nThe easiest way to start using this package is to install it via [PyPI](https://pypi.python.org/pypi/spoonacular) using `pip`:\n\n`$pip install spoonacular`\n\nThank you to [@sebbekarlsson](https://github.com/sebbekarlsson) for transferring ownership of the original PyPI package name.\n\nIf you'd prefer to clone and install the repository manually, follow these steps:\n\n1. Clone this repo:\n`$git clone https://github.com/johnwmillr/SpoonacularAPI.git`\n2. Enter the cloned directory:\n`$cd SpoonacularAPI`\n3. Install:\n `$python setup.py install`\n\n## Usage\n\n### API Key\n\nYou'll need to sign up for an account on [RapidAPI](https://rapidapi.com/spoonacular/api/Recipe%20-%20Food%20-%20Nutrition/pricing) to start using `spoonacular`. Spoonacular is a freemium API, so you'll be able to start with 50 free calls a day. Registration requires a credit card number even for the free plan, because users are charged a small amount per call if they go over the daily limit. This package has a basic system in place to try and prevent overrage charges.\n\n### Examples\n\n```python\nimport spoonacular as sp\napi = sp.API(\"your_api_key_here\")\n\n# Parse an ingredient\nresponse = api.parse_ingredients(\"3.5 cups King Arthur flour\", servings=1)\ndata = response.json()\nprint(data[0]['name'])\n>>>\"flour\"\n\n# Detect text for mentions of food\nresponse = api.detect_food_in_text(\"I really want a cheeseburger.\")\ndata = response.json()\nprint(data['annotations'][0])\n>>>{\"annotation\": \"cheeseburger\", \"tag\":\"dish\"}\n\n# Get a random food joke\nresponse = api.get_a_random_food_joke()\ndata = response.json()\nprint(data['text'])\n>>>\"People are a lot less judgy when you say you ate an 'avocado salad' instead of a bowl of guacamole.\"\n```\n\n## Documentation\n - [Spoonacular website](https://spoonacular.com/food-api)\n - [RapidAPI](https://rapidapi.com/spoonacular/api/Recipe%20-%20Food%20-%20Nutrition)\n - [DocScraper](https://github.com/johnwmillr/DocScraper)\n\n## Collaboration\nPlease feel free to collaborate with a pull request or by opening an issue.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/johnwmillr/SpoonacularAPI", "keywords": "spoonacular API food recipes ingredients cuisine groceries", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "spoonacular", "package_url": "https://pypi.org/project/spoonacular/", "platform": "", "project_url": "https://pypi.org/project/spoonacular/", "project_urls": { "Homepage": "https://github.com/johnwmillr/SpoonacularAPI" }, "release_url": "https://pypi.org/project/spoonacular/3.0/", "requires_dist": [ "requests" ], "requires_python": ">=3.*", "summary": "A Python wrapper for the Spoonacular API", "version": "3.0" }, "last_serial": 5727542, "releases": { "2.0.0": [ { "comment_text": "", "digests": { "md5": "7df6b2185e9a5f86171db1b5911a40b3", "sha256": "bda1376348e0a6950020cf764718f3e037ecd98397e46d0c42836b5a3aafec9a" }, "downloads": -1, "filename": "spoonacular-2.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "7df6b2185e9a5f86171db1b5911a40b3", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.*", "size": 7544, "upload_time": "2018-08-20T21:54:57", "url": "https://files.pythonhosted.org/packages/88/5f/6adc1df361dc97dab12545c02e1c1d4f94184853063d123e1e2a98234923/spoonacular-2.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "99fdd2c39b2a0a87b6ac6d2c0071ba7a", "sha256": "6c1494011431e56f78bf11b00c87c1d039f45f012c999a40a8fe2f0ee60f4b29" }, "downloads": -1, "filename": "spoonacular-2.0.0.tar.gz", "has_sig": false, "md5_digest": "99fdd2c39b2a0a87b6ac6d2c0071ba7a", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.*", "size": 7705, "upload_time": "2018-08-20T21:54:58", "url": "https://files.pythonhosted.org/packages/66/a3/dc199cd29d33a3ace855e8aa5f28e76a71e378c96c63903c401eb9179f57/spoonacular-2.0.0.tar.gz" } ], "2.0.1": [ { "comment_text": "", "digests": { "md5": "53dac86af94f7aacea76df82b2745b8b", "sha256": "30575abe919b594cf2279e67cf9bdae0bdf7730c4316bec768b59ab14b5fd835" }, "downloads": -1, "filename": "spoonacular-2.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "53dac86af94f7aacea76df82b2745b8b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.*", "size": 7569, "upload_time": "2018-08-20T22:38:18", "url": "https://files.pythonhosted.org/packages/8b/3e/521592cb651a64e9bda0f178566816910f04d9a9f48b3cc58ad651cc650b/spoonacular-2.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "82e6c3702df33533123b516c4bf8f2c2", "sha256": "cd03069fbdceba4507805ef6445b1c4fd9e084b27b7696220129f4c85f68d1fd" }, "downloads": -1, "filename": "spoonacular-2.0.1.tar.gz", "has_sig": false, "md5_digest": "82e6c3702df33533123b516c4bf8f2c2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.*", "size": 7736, "upload_time": "2018-08-20T22:38:21", "url": "https://files.pythonhosted.org/packages/85/2d/52ffab469991fb707e9fe07daa66fe2f35e27f8823d99055c8a73db84b6d/spoonacular-2.0.1.tar.gz" } ], "2.2.1": [ { "comment_text": "", "digests": { "md5": "953b2b73f8a191f942a47921f664a4be", "sha256": "d8f220069dfd78c9f3dd8e6ba8716e7edf18a7c72d65b950bff80d2ebc09251d" }, "downloads": -1, "filename": "spoonacular-2.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "953b2b73f8a191f942a47921f664a4be", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.*", "size": 9710, "upload_time": "2018-09-30T15:24:06", "url": "https://files.pythonhosted.org/packages/bb/e5/f1561656055601f10dd6158066c5a9df35dcf930daca37a15b26a9825013/spoonacular-2.2.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3f353909a03a06b870bb08b3e0d4e0bc", "sha256": "da77fd0acb443b6f1e442a3713637115f65aa448a39ab97eee2f7b624095a39c" }, "downloads": -1, "filename": "spoonacular-2.2.1.tar.gz", "has_sig": false, "md5_digest": "3f353909a03a06b870bb08b3e0d4e0bc", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.*", "size": 10428, "upload_time": "2018-09-30T15:24:07", "url": "https://files.pythonhosted.org/packages/97/c4/33cbcfe00b067bdcf0f19c867e113df0a8bb4501de2158b799ed74226f91/spoonacular-2.2.1.tar.gz" } ], "3.0": [ { "comment_text": "", "digests": { "md5": "8de1248ec77b4e927044f37c6f8686e8", "sha256": "b655241d8c85bcf8ccf6b0d6c0c6279c5cba74760965275989e93d820fdac1f7" }, "downloads": -1, "filename": "spoonacular-3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "8de1248ec77b4e927044f37c6f8686e8", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.*", "size": 10517, "upload_time": "2019-08-25T17:31:46", "url": "https://files.pythonhosted.org/packages/18/83/31f74bf9452a597b545db89a7a2e172c7c24be3948b3657fb582c26cc43d/spoonacular-3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c67703e543d38d94f8f864180f87e541", "sha256": "a0e7f12d84342a79bf313f1c6385175f6651771d2de7381d06430a1c4b678241" }, "downloads": -1, "filename": "spoonacular-3.0.tar.gz", "has_sig": false, "md5_digest": "c67703e543d38d94f8f864180f87e541", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.*", "size": 10390, "upload_time": "2019-08-25T17:31:48", "url": "https://files.pythonhosted.org/packages/ff/21/541150521dc25fdfd8f10bcbcf6d6b227b2ed30ae1244c15320a375b39d3/spoonacular-3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8de1248ec77b4e927044f37c6f8686e8", "sha256": "b655241d8c85bcf8ccf6b0d6c0c6279c5cba74760965275989e93d820fdac1f7" }, "downloads": -1, "filename": "spoonacular-3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "8de1248ec77b4e927044f37c6f8686e8", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.*", "size": 10517, "upload_time": "2019-08-25T17:31:46", "url": "https://files.pythonhosted.org/packages/18/83/31f74bf9452a597b545db89a7a2e172c7c24be3948b3657fb582c26cc43d/spoonacular-3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c67703e543d38d94f8f864180f87e541", "sha256": "a0e7f12d84342a79bf313f1c6385175f6651771d2de7381d06430a1c4b678241" }, "downloads": -1, "filename": "spoonacular-3.0.tar.gz", "has_sig": false, "md5_digest": "c67703e543d38d94f8f864180f87e541", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.*", "size": 10390, "upload_time": "2019-08-25T17:31:48", "url": "https://files.pythonhosted.org/packages/ff/21/541150521dc25fdfd8f10bcbcf6d6b227b2ed30ae1244c15320a375b39d3/spoonacular-3.0.tar.gz" } ] }