TheNounProjectAPI is a Python wrapper allowing convenient access to the Noun Project API. It supports all endpoints and types of responses. Documentation for this wrapper can be found here, while the official documentation of the API itself may be found here.
TheNounProjectAPI is supported on Python 3.7+. The recommended method of installation is via pip.
pip install TheNounProjectAPI
You can also install TheNounProjectAPI directly from github using:
pip install --upgrade https://github.com/tomaarsen/TheNounProjectAPI/archive/master.zip
For help with installing Python and/or pip, see "The Hitchhiker's Guide to Python" Installation Guides
However, I'll provide a quick sample.
# See the Documentation for more information: https://tomaarsen.github.io/TheNounProjectAPI from TheNounProjectAPI import API if __name__ == "__main__": # API Key and Secret from https://api.thenounproject.com/getting_started.html#creating-an-api-key key = "<my api key>" secret = "<my api secret>" # Create api object api = API(key=key, secret=secret) # See the documentation for more endpoints icons = api.get_icons_by_term("goat", public_domain_only=True, limit=2) # >>>icons # [<IconModel: Term: Goat Feeding, Slug: goat-feeding, Id: 24014>, # <IconModel: Term: Herbivore teeth, Slug: herbivore-teeth, Id: 675870>] for icon in icons: print("Icon's term:", icon.term) print("This icon's tags:", ", ".join(tag.slug for tag in icon.tags)) print("Uploader's username:", icon.uploader.username)
Examine the TheNounProjectAPI documentation for more examples of what can be done with TheNounProjectAPI.
Documentation can be found here: https://tomaarsen.github.io/TheNounProjectAPI
python setup.py nosetests or
python setup.py test to run all tests in one batch.
TheNounProjectAPI is licensed under MIT.
Contributions are welcome.