https://github.com/mikewesthad/annotated-js-api-guide
Annotated list of Web APIs for teaching/learning/experimentation
https://github.com/mikewesthad/annotated-js-api-guide
Last synced: 2 months ago
JSON representation
Annotated list of Web APIs for teaching/learning/experimentation
- Host: GitHub
- URL: https://github.com/mikewesthad/annotated-js-api-guide
- Owner: mikewesthad
- Created: 2016-12-13T14:10:39.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-12-13T20:33:17.000Z (over 8 years ago)
- Last Synced: 2025-02-14T08:46:31.527Z (4 months ago)
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Annotated List of Web APIs
This is an annotated list of Web APIs that are great for learning and experimenting in JavaScript. The APIs are broken down into categories based on how you need to connect to them.
This list is a collection of APIs I've used along with many pulled from afeld's [gist](https://gist.github.com/afeld/4952991). This is a work-in-progress. To do:
- Finish integrating other mega-lists of APIs and annotating them
- Add some sample code for how to get JSON and JSONP
- Add a section explaining CORS
- Add a section on proxying HTTPS
- Add a section on CORS proxies like or
# Table of Contents
1. [General format of API notes](#general-format-of-api-notes)
2. [APIs that are completely public](#apis-that-are-completely-public)
3. [APIs that require an API key but do not private credentials](#apis-that-require-an-api-key-but-do-not-private-credentials)
4. [APIs that require server-side programming for authorization](#apis-that-require-server-side-programming-for-authorization)
5. [References](#references)
## General format of API notes
Each API has a description that should look like this:
- Name & URL to documentation
- Any important information about the API
- Quirks
- Details of the rate limits
- Whether or not the API is configured for CORS
- Protocols: can you connect using HTTP or HTTPS?
- Formats: what data formats does the API support (JSON, XML, etc.)?
## APIs that are completely public
No API key is necessary or there is a public API key that is freely available. These are great for quick testing and learning about APIs.
- [Giphy](https://github.com/Giphy/GiphyAPI)
- Access to GIFs from Giphy
- Requires a key, but there is a public key available for experimentation & development
- Protocols: HTTP, HTTPS
- Formats: JSON, HTML
- CORS: Yes
- [Hipsterjesus](http://hipsterjesus.com/)
- Hipster ipsum generator
- Protocols: HTTP
- Formats: JSON
- CORS: Yes
- [The Open Movie Database](http://www.omdbapi.com/)
- Get info about movies and TV shows including rotten tomatoes rating and plot summary
- Protocols: HTTP, HTTPS
- Formats: JSON, XML, JSONP
- CORS: Yes
- [jService](http://jservice.io/)
- Collection of trivia questions aired on Jeopardy
- Protocols: HTTP
- Formats: JSON
- CORS: Yes
- [Pokéapi](http://pokeapi.co/)
- Pokedex API
- Daily rate limit of 300 requests per resource per IP address
- Protocols: HTTP, HTTPS
- Formats: JSON
- CORS: Yes
- [Discogs API](https://www.discogs.com/developers/#)
- Get info about artists, releases, labels, etc.
- 240 requests per minute per IP address without authorization
- Some resources (like the search endpoint) require a [authentication](https://www.discogs.com/developers/#page:authentication). You can sign up and use a user token as an easy way to access those resources (e.g. adding `&token=YOURTOKEN` to the URL).
- Protocols: HTTP, HTTPS
- Formats: JSON, JSONP
- CORS: Yes
- [The Cat API](http://thecatapi.com/) (more complete access with API key)
- Free access to `/api/images/get` endpoint without an API key
- Does not support JSON/JSONP yet, but can return an HTML image tag
- Protocols: HTTP, HTTPS
- Formats: XML, HTML, SRC
- CORS: Yes
- [COLOURlovers](http://www.colourlovers.com/api)
- Get colors/palettes
- Default format is xml, so add `format=json` for data in JSON format
- If you are making a request from the JS in the browser, you will need to use JSONP with the parameter name `jsonCallback`
- Protocols: HTTP
- Formats: XML, JSON, JSONP
- CORS: No
- [Robothash](https://robohash.org/) (pass in anything after the URL to get a robot image)
- Turn a URL into a robot image
- Returns an image, so create an `img` with src pointing to the URL
- Protocols: HTTP, HTTPS
- Formats: Image
- CORS: No
- [Dronestre.am](http://dronestre.am/)
- Database of US drone strikes
- If you are making a request from the JS in the browser, you will need to use JSONP with the parameter name `callback`
- Protocols: HTTP
- Formats: JSON, JSONP
- CORS: No
- [TVMaze API](http://www.tvmaze.com/api)
- [US Earthquakes](http://earthquake.usgs.gov/fdsnws/event/1/)
- [International Space Station (ISS) Location](http://open-notify.org/Open-Notify-API/)
- [Sunrise sunset times](http://sunrise-sunset.org/api)
- [Fuck Off As A Service (FOAAS)](https://www.foaas.com/)
- [Netflix Roulette](http://netflixroulette.net/api/)
- [NFLArrest API](http://nflarrest.com/api/)
## APIs that require an API key but do not private credentials
These APIs require you to register to get an API key, which then you use in your API requests. None of these APIs require server-side techniques to get access.
These are great for experimenting and learning, but if you are creating a final product (art installation, web app, etc.), you probably don't want your API key to be easily accessible in a public website. If someone reads your source code, they could get your API key and use up your allotted API calls.
- [Flickr](http://www.flickr.com/services/api/) (images)
- Google
- [Google Knowledge Graph](https://developers.google.com/knowledge-graph/) (information)
- [Google Maps](https://developers.google.com/maps/documentation/javascript/tutorial)
- [Google Plus](https://developers.google.com/+/api/) (people)
- [Youtube](https://developers.google.com/youtube/)
- [Bing Maps](http://msdn.microsoft.com/en-us/library/dd877180.aspx)
- [Facebook Graph API](https://developers.facebook.com/docs/reference/api/) ([JS SDK](https://developers.facebook.com/docs/reference/javascript/) allows auth via client-side)
- [Foursquare](https://developer.foursquare.com) (location)
- [Etsy](http://www.etsy.com/developers/documentation/getting_started/jsonp) (shopping)
- [GitHub](http://developer.github.com/) (code)
- [Gravatar](http://en.gravatar.com/site/implement/)
- [Lob](https://www.lob.com/docs#verify) (mailing address verification)
- [Mapbox](https://www.mapbox.com/developers/) (maps)
- Mapzen [plugins](https://mapzen.com/projects/) and [data](https://mapzen.com/data/) (maps)
- [Markit On Demand](http://dev.markitondemand.com/MODApis/) (stocks)
- [Meetup](http://www.meetup.com/meetup_api/)
- [Metropolitan Museum of Art](http://scrapi.org/)
- [OpenStreetMap](http://wiki.openstreetmap.org/wiki/Develop) (maps)
- [OpenTok](http://www.tokbox.com/opentok/api/features) (videochat)
- [Pearson](http://developer.pearson.com/apis) (publications)
- [Reddit](http://www.reddit.com/dev/api)
- [SoundCloud](http://developers.soundcloud.com/) (music/audio)
- [SpaceAPI](http://spaceapi.net/) (hackerspace directory)
- [Spotify](https://developer.spotify.com/) (music)
- [Stripe](https://stripe.com/docs/stripe.js) (payment)
- [Transitland](https://transit.land/how-it-works/) (public transit)
- [Tumblr](http://www.tumblr.com/docs/en/api/v2)
- [Twilio Client](http://www.twilio.com/client) (audio/video)
- [Vimeo Simple API](http://developer.vimeo.com/apis/simple) (video)
- Wikipedia, via [DBpedia](http://dbpedia.org/About) or [MediaWiki](http://www.mediawiki.org/wiki/API) (information)
- [Wolfram Alpha](http://products.wolframalpha.com/api/) (information, math, etc.)
## APIs that require server-side programming for authorization
- [Instagram](http://instagram.com/developer/) (images)
- [Twitter](https://dev.twitter.com/docs)
## References
-
-
-
-
-