Merge https://github.com/toddmotto/public-apis

# Conflicts:
#	README.md

.travis.yml

@@ -1,6 +1,14 @@
-language: ruby
+language: node_js
-rvm: 2.2
-before_script: gem install awesome_bot
-script: awesome_bot README.md --allow-ssl --allow 403,302
 notifications:
   email: false
+before_install:
+  - rvm install 2.4.0
+install:
+  - gem install httparty ruby-progressbar
+before_script:
+  - cd build
+script:
+  - ./main.sh
+after_success:
+  - ./build.sh
+  - ./deploy.sh

CONTRIBUTING.md

@@ -31,6 +31,8 @@ Please continue to follow the alphabetical ordering that is in place per section
 
 If an API seems to fall into multiple categories, please place the listing within the section most in line with the services offered through the API. For example, the Instagram API is listed under `Social` since it is mainly a social network, even though it could also apply to `Photography`.
 
+This project now offers a [JSON version](json/) of the list of services. These files are automatically updated as part of the Continuous Integration process, so there is no need to update them as part of the contribution. 
+
 ## Pull Request
 
 After you've created a branch on your fork with your changes, it's time to [make a pull request][pr-link]!

README.md

@@ -2,6 +2,8 @@
 
 A collective list of free JSON APIs for use in web development.
 
+A JSON encoding of all entries can be found [here](json).
+
 For information on contributing to this project, please see the [contributing guide](CONTRIBUTING.md).
 
 Please note a passing build status indicates all listed APIs are available since the last update. A failing build status indicates that 1 or more services may be unavailable at the moment.
@@ -48,16 +50,15 @@ Please note a passing build status indicates all listed APIs are available since
 * [Weather](#weather)
 
 ### Animals
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
-| IUCN | IUCN Red List of Threatened Species | `token` | No | [Go!](http://apiv3.iucnredlist.org/api/v3/docs) |
+| Dogs | Based on the [Stanford Dogs Dataset](http://vision.stanford.edu/aditya86/ImageNetDogs/) | No | Yes | [Go!](https://dog.ceo/dog-api/) |
-| Petfinder | Adoption | Yes | Yes | [Go!](https://www.petfinder.com/developers/api-docs/) |
+| IUCN | IUCN Red List of Threatened Species | `apiKey` | No | [Go!](http://apiv3.iucnredlist.org/api/v3/docs) |
+| Petfinder | Adoption | `apiKey` | Yes | [Go!](https://www.petfinder.com/developers/api-docs/) |
 | RescueGroups | Adoption | No | Yes | [Go!](https://userguide.rescuegroups.org/display/APIDG/API+Developers+Guide+Home) |
 
 ### Anime
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | AniList | AniList Anime | `OAuth` | No | [Go!](http://anilist-api.readthedocs.io/en/latest/) |
 | Jikan | Unofficial MyAnimeList API | No | Yes | [Go!](https://jikan.me) |
@@ -65,42 +66,39 @@ Please note a passing build status indicates all listed APIs are available since
 | Studio Ghibli | Resources from Studio Ghibli films | No | Yes | [Go!](https://ghibliapi.herokuapp.com) |
 
 ### Anti-Malware
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
-| Certly | Certly Link/Domain Flagging | `token` | Yes | [Go!](https://guard.certly.io/) |
+| AlienVault Open Threat Exchange (OTX) | IP/domain/URL reputation | `apiKey` | Yes | [Go!](https://otx.alienvault.com/api/) | 
-| Google Safe Browsing | Google Link/Domain Flagging | `token` | Yes | [Go!](https://developers.google.com/safe-browsing/) |
+| Certly | Certly Link/Domain Flagging | `apiKey` | Yes | [Go!](https://guard.certly.io/) |
-| Metacert | Metacert Link Flagging | `token` | Yes | [Go!](https://metacert.com/) |
+| Google Safe Browsing | Google Link/Domain Flagging | `apiKey` | Yes | [Go!](https://developers.google.com/safe-browsing/) |
-| VirusTotal | VirusTotal File/URL Analysis | `token` | Yes | [Go!](https://www.virustotal.com/en/documentation/public-api/) |
+| Metacert | Metacert Link Flagging | `apiKey` | Yes | [Go!](https://metacert.com/) |
+| VirusTotal | VirusTotal File/URL Analysis | `apiKey` | Yes | [Go!](https://www.virustotal.com/en/documentation/public-api/) |
 | Web Of Trust (WOT) | Website reputation | `apiKey` | Yes | [Go!](https://www.mywot.com/wiki/API) |
 
 ### Art & Design
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Dribbble | Design | `OAuth` | No | [Go!](http://developer.dribbble.com/v1/) |
-| Noun Project | Icons | `OAuth` | No | [Go!](http://api.thenounproject.com/index.html) |
+| Harvard Art Museums | Art | `apiKey` | No | [Go!](https://github.com/harvardartmuseums/api-docs) |
 | Icons8 | Icons | `OAuth` | Yes | [Go!](http://docs.icons8.apiary.io/#reference/0/meta) |
+| Noun Project | Icons | `OAuth` | No | [Go!](http://api.thenounproject.com/index.html) |
 | Rijksmuseum| Art | `apiKey` | Yes | [Go!](https://www.rijksmuseum.nl/en/api) |
 
 ### Books
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | British National Bibliography | Books | No | No | [Go!](http://bnb.data.bl.uk/) |
 | Goodreads | Books | No | Yes | [Go!](https://www.goodreads.com/api) |
 | Google Books | Books | `OAuth` | Yes | [Go!](https://developers.google.com/books/) |
 
 ### Business
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | mailgun | Email Service | `apiKey` | Yes | [Go!](https://www.mailgun.com/) |
 | markerapi | Trademark Search | No | No | [Go!](http://www.markerapi.com/) |
 
 ### Calendar
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Church Calendar | Catholic liturgical calendar | No | No | [Go!](http://calapi.inadiutorium.cz/) |
 | Holidays | Historical data regarding holidays | `apiKey` | Yes | [Go!](https://holidayapi.com/) |
@@ -108,8 +106,7 @@ Please note a passing build status indicates all listed APIs are available since
 | Non-Working Days | Database of ICS files for non working days | No | Yes | [Go!](https://github.com/gadael/icsdb) |
 
 ### Cloud Storage & File Sharing
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Box | File Sharing and Storage | `OAuth` | Yes | [Go!](https://developer.box.com/) |
 | Dropbox | File Sharing and Storage | `OAuth` | Yes | [Go!](https://www.dropbox.com/developers) |
@@ -117,15 +114,13 @@ Please note a passing build status indicates all listed APIs are available since
 | OneDrive | File Sharing and Storage | `OAuth` | Yes | [Go!](https://dev.onedrive.com/) |
 
 ### Currency Exchange
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Currencylayer | Exchange rates and currency conversion | `apiKey` | Yes | [Go!](https://currencylayer.com/documentation) |
 | Fixer.io | Exchange rates and currency conversion | No | Yes | [Go!](http://fixer.io) |
 
 ### Data Access
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | 18F | US Federal Government /Developer Program | No | No | [Go!](http://18f.github.io/API-All-the-X/) |
 | Abbreviation | Get abbreviations and meanings | `X-Mashape-Key` | Yes | [Go!](https://market.mashape.com/daxeel/abbreviations) |
@@ -134,26 +129,29 @@ Please note a passing build status indicates all listed APIs are available since
 | Celebinfo | Celebrity information | `X-Mashape-Key` | Yes | [Go!](https://market.mashape.com/daxeel/celebinfo/) |
 | Colorado Data Engine | Formatted and geolocated Colorado public data | No | Yes | [Go!](http://codataengine.org/) |
 | Colorado Information Marketplace | Colorado State Government Open Data | No | Yes | [Go!](https://data.colorado.gov/) |
+| Datakick | The open product database | `apiKey` | Yes | [Go!](https://www.datakick.org/api) |
 | Data USA | US Public Data | No | Yes | [Go!](https://datausa.io/about/api/) |
-| Dronestream | Tracks United States drone strikes | No | No | [Go!](http://dronestre.am/) |
+| Dronestream | Tracks United States drone strikes | No | Yes | [Go!](https://dronestre.am/) |
 | fonoApi | Mobile Device Description | No | Yes | [Go!](https://fonoapi.freshpixl.com/) |
 | Open Government, Australia | Australian Government Open Data | No | Yes | [Go!](https://www.data.gov.au/) |
 | Open Government, USA | United States Government Open Data | No | Yes | [Go!](https://www.data.gov/) |
 | Open Government, Canada | Canadian Government Open Data | No | No | [Go!](http://open.canada.ca/en) |
-| Open Government Data, India | Indian Government Open Data | `token` | Yes | [Go!](https://data.gov.in/) |
+| Open Government Data, India | Indian Government Open Data | `apiKey` | Yes | [Go!](https://data.gov.in/) |
+| Open Government, New Zealand | New Zealand Government Open Data | No | Yes | [Go!](https://www.data.govt.nz/) |
+| Outpan | A Database of Everything | `apiKey` | Yes | [Go!](https://outpan.mixnode.com/developers) |
 | Pearson | Dictionary Data | `apiKey` | No | [Go!](http://developer.pearson.com/apis/dictionaries) |
 | Prague Opendata | Prague City Open Data | No | No | [Go!](http://opendata.praha.eu/en) |
 | Quandl | Stock Market Data | No | Yes | [Go!](https://www.quandl.com/) |
 | Represent by Open North | Find Canadian Government Representatives | No | Yes | [Go!](https://represent.opennorth.ca/) |
 | Scoop.it | Content Curation Service | `apiKey` | No | [Go!](http://www.scoop.it/dev) |
 | Teleport | Quality of Life Data | No | Yes | [Go!](https://developers.teleport.org/) |
+| UPC database | More than 1.5 million barcode numbers from all around the world | `apiKey` | Yes | [Go!](https://upcdatabase.org/api) |
 | Wikipedia | Mediawiki Encyclopedia | No | Yes | [Go!](https://www.mediawiki.org/wiki/API:Main_page) |
 | Wordnik | Dictionary Data | No | No | [Go!](http://developer.wordnik.com) |
-| Yelp | Find Local Business | `OAuth` | Yes | [Go!](https://www.yelp.com/developers) |
+| Yelp | Find Local Business | `OAuth` | Yes | [Go!](https://www.yelp.com/developers/documentation/v3) |
 
 ### Data Validation
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | languagelayer | Language detection | No | Yes | [Go!](https://languagelayer.com) |
 | Lob.com | US Address Verification | `apiKey` | Yes | [Go!](https://lob.com/) |
@@ -162,11 +160,12 @@ Please note a passing build status indicates all listed APIs are available since
 | vatlayer | VAT number validation | No | Yes | [Go!](https://vatlayer.com) |
 
 ### Development
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Adorable Avatars | Generate random cartoon avatars | No | Yes | [Go!](http://avatars.adorable.io) |
 | APIs.guru | Wikipedia for Web APIs, OpenAPI/Swagger specs for public APIs | No | Yes | [Go!](https://apis.guru/api-doc/) |
+| BetterMeta | Return a site's meta tags in JSON format | X-Mashape-Key | Yes | [Go!](http://bettermeta.io) |
+| Changelogs.md | Structured changelog metadata from open source projects | No | Yes | [Go!](https://changelogs.md) |
 | CDNJS | Library info on CDNJS | No | Yes | [Go!](https://api.cdnjs.com/libraries/jquery) |
 | Faceplusplus | A tool to detect face | `OAuth` | Yes | [Go!](https://www.faceplusplus.com/) |
 | Genderize.io | Determines a gender from a first name | No | Yes | [Go!](https://genderize.io) |
@@ -176,14 +175,17 @@ Please note a passing build status indicates all listed APIs are available since
 | Hipster Ipsum | Generates Hipster Ipsum text | No | No | [Go!](http://hipsterjesus.com/) |
 | IPify | A simple IP Address API  | No | Yes | [Go!](https://www.ipify.org/) |
 | JSON 2 JSONP | Convert JSON to JSONP (on-the-fly) for easy cross-domain data requests using client-side JavaScript | No | Yes | [Go!](https://json2jsonp.com/) |
+| JSONbin.io | Free JSON storage service. Ideal for small scale Web apps, Websites and Mobile apps. | No | Yes | [Go!](https://jsonbin.io) |
 | JSONPlaceholder | Fake data for testing and prototyping | No | No | [Go!](http://jsonplaceholder.typicode.com/) |
 | Judge0 API | Compile and run source code | No | Yes | [Go!](https://api.judge0.com/) |
+| Kairos | Face Recognition and Emotion Analysis | `apiKey` | Yes | [Go!](https://www.kairos.com/features) |
 | Let's Validate | Uncovers the technologies used on websites and URL to thumbnail | No | Yes | [Go!](https://github.com/letsvalidate/api) |
 | LiveEdu | Live Coding Streaming | `OAuth` | Yes | [Go!](https://www.liveedu.tv/developer/applications/) |
 | Lorem Text | Generates Lorem Ipsum text | `X-Mashape-Key` | Yes | [Go!](https://market.mashape.com/montanaflynn/lorem-text-generator) |
 | Loripsum | The "lorem ipsum" generator that doesn't suck | No | No | [Go!](http://loripsum.net/) |
 | Myjson | A simple JSON store for your web or mobile app | No | No | [Go!](http://myjson.com/api) |
 | Plino | Spam filtering system | No | Yes | [Go!](https://plino.herokuapp.com/) |
+| Public APIs | A collective list of free JSON APIs for use in web development | No | Yes | [Go!](https://github.com/toddmotto/public-apis/tree/master/json) |
 | Random Word | Generate random word | No | No | [Go!](http://www.setgetgo.com/randomword/) |
 | RandomUser | Generates random user data | No | Yes | [Go!](https://randomuser.me) |
 | ReqRes | A hosted REST-API ready to respond to your AJAX requests | No | Yes | [Go!](https://reqres.in/ ) |
@@ -194,33 +196,32 @@ Please note a passing build status indicates all listed APIs are available since
 | Verse | Check what's the latest version of your favorite open-source project | No | Yes | [Go!](https://verse.pawelad.xyz/) |
 
 ### Documents & Productivity
-
+API | Description | Auth | HTTPS |Link |
-| API | Description | Auth | HTTPS |Link |
 |---|---|---|---|---|
 | File.io | File Sharing | No | Yes | [Go!](https://www.file.io) |
 | pdflayer API | HTML/URL to PDF | No | Yes | [Go!](https://pdflayer.com) |
+| Pocket | Bookmarking service | `OAuth` | Yes | [Go!](https://getpocket.com/developer/) |
 | PrexView | Data from XML or JSON to PDF, HTML or Image  | `apiKey` | Yes | [Go!](https://prexview.com) |
 | Todoist | Todo Lists | `OAuth` | Yes | [Go!](https://developer.todoist.com) |
 | Wunderlist | Todo Lists | `OAuth` | Yes | [Go!](https://developer.wunderlist.com/documentation) |
 
 ### Environment
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | AirVisual | Air quality and weather data | `apiKey` | Yes | [Go!](https://airvisual.com/api) |
 | OpenAQ | Open air quality data | `apiKey` | Yes | [Go!](https://docs.openaq.org/) |
 | PM2.5.in | Air quality of China | `apiKey` | No | [Go!](http://www.pm25.in/api_doc) |
 
 ### Finance
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Barchart OnDemand | Stock, Futures, and Forex Market Data | `apiKey` | Yes | [Go!](https://www.barchartondemand.com/free) |
+| CoinDesk | Bitcoin Price Index | No | No | [Go!](http://www.coindesk.com/api/) |
 | Consumer Financial Protection Bureau | Financial services consumer complains data | `apiKey` | Yes | [Go!](https://data.consumerfinance.gov/resource/jhzv-w97w.json) |
+| Razorpay IFSC | Indian Financial Systems Code (Bank Branch Codes) | No | Yes | [Go!](https://ifsc.razorpay.com/) |
 
 ### Food & Drink
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | BigOven | Recipe Search | `X-Mashape-Key` | No | [Go!](http://api2.bigoven.com/) |
 | BreweryDB | Beer | `apiKey` | No | [Go!](http://www.brewerydb.com/developers) |
@@ -231,13 +232,13 @@ Please note a passing build status indicates all listed APIs are available since
 | Recipe Puppy | Food | No | No | [Go!](http://www.recipepuppy.com/about/api/) |
 | TacoFancy | Community-driven taco database | No | No | [Go!](https://github.com/evz/tacofancy-api) |
 | TheCocktailDB | Cocktail Recipes | No | No | [Go!](http://www.thecocktaildb.com/) |
+| The Report of the Week | Food & Drink Reviews | No | Yes | [Go!](https://github.com/andyklimczak/TheReportOfTheWeek-API) |
 | Yummly | Find food recipes | No | Yes | [Go!](https://developer.yummly.com/) |
 | Zomato | Discover restaurants | `apiKey` | Yes | [Go!](https://developers.zomato.com/api) |
 
 
 ### Fraud Prevention
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Whitepages Pro | Global identity verification with phone, address, email, and IP | `apiKey` | Yes | [Go!](https://pro.whitepages.com/developer/documentation/identity-check-api/) |
 | Whitepages Pro | Phone reputation to detect spammy phones | `apiKey` | Yes | [Go!](https://pro.whitepages.com/developer/documentation/phone-reputation-api/) |
@@ -246,17 +247,17 @@ Please note a passing build status indicates all listed APIs are available since
 | Whitepages Pro| Get normalized physical address, residents, address type, and validity. | `apiKey` | Yes | [Go!](https://pro.whitepages.com/developer/documentation/reverse-address-api/) |
 
 ### Games & Comics
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
-| Battle.net | Blizzard Entertainment | No | Yes | [Go!](https://dev.battle.net/)  |
+| Battle.net | Blizzard Entertainment | No | Yes | [Go!](https://dev.battle.net/) |
-| Battlefield 4 | Battlefield 4 Information | No | Yes | [Go!](https://bf4stats.com/api)  |
+| Battlefield 4 | Battlefield 4 Information | No | Yes | [Go!](https://bf4stats.com/api) |
 | Chuck Norris Database | Jokes | No | No | [Go!](http://www.icndb.com/api/) |
 | Clash of Clans | Clash of Clans Game Information | No | Yes | [Go!](https://developer.clashofclans.com) |
-| Clash Royale | Clash Royale Game Information | No | Yes | [Go!](https://github.com/martincarrera/clash-royale-api)  |
+| Clash Royale | Clash Royale Game Information | No | Yes | [Go!](https://github.com/martincarrera/clash-royale-api) |
 | Comic Vine | Comics | No | Yes | [Go!](https://comicvine.gamespot.com/api/documentation) |
-| Deck of Cards | Deck of Cards | No | No | [Go!](http://deckofcardsapi.com/)  |
+| Deck of Cards | Deck of Cards | No | No | [Go!](http://deckofcardsapi.com/) |
-| Eve Online | Third-Party Developer Documentation | `OAuth` required for some parts | Yes | [Go!](https://eveonline-third-party-documentation.readthedocs.io/en/latest/) |
+| Destiny The Game | Bungie Platform API | `apiKey` | Yes | [Go!](https://www.bungie.net/en/Clan/Post/39966/85087279/0/0) |
+| Eve Online | Third-Party Developer Documentation | `OAuth` | Yes | [Go!](https://eveonline-third-party-documentation.readthedocs.io/en/latest/) |
 | Giant Bomb | Video Games | No | Yes | [Go!](https://www.giantbomb.com/api/documentation) |
 | Guild Wars 2 | Guild Wars 2 Game Information | `apiKey` | Yes | [Go!](https://wiki.guildwars2.com/wiki/API:Main) |
 | Jservice | Jeopardy Question Database | No | No | [Go!](http://jservice.io) |
@@ -264,15 +265,14 @@ Please note a passing build status indicates all listed APIs are available since
 | Marvel | Marvel Comics | `apiKey` | No | [Go!](http://developer.marvel.com) |
 | Minecraft | Minecraft server info & user info) | No | Yes | [Go!](https://mcapi.ca/) |
 | Open Trivia | Trivia Questions | No | Yes | [Go!](https://opentdb.com/api_config.php) |
+| PandaScore | E-sports games and results | `apiKey` | Yes | [Go!](https://api.pandascore.co) |
 | Pokéapi | Pokémon Information | No | No | [Go!](http://pokeapi.co) |
 | Qriusity | Quiz/Trivia Questions | No | Yes | [Go!](https://qriusity.com/) |
 | Riot Games | League of Legends Game Information | `apiKey` | Yes | [Go!](https://developer.riotgames.com/) |
 | Steam | Steam Client Interaction | `OAuth` | Yes | [Go!](https://developer.valvesoftware.com/wiki/Steam_Web_API) |
-| SWAPI | Star Wars Information | No | Yes | [Go!](https://swapi.co) |
 
 ### Geocoding
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | adresse.data.gouv.fr | Address database of France. geocoding and reverse. | No | Yes | [Go!](https://adresse.data.gouv.fr) |
 | Bing Maps | Create/customize digital maps based on Bing Maps data | `apiKey` | Yes | [Go!](https://www.microsoft.com/maps/) |
@@ -282,11 +282,13 @@ Please note a passing build status indicates all listed APIs are available since
 | Google Maps | Create/customize digital maps based on Google Maps data | `apiKey` | Yes | [Go!](https://developers.google.com/maps/) |
 | IP 2 Country | Map an IP to a country | No | Yes | [Go!](https://ip2country.info) |
 | IP Address Details| Find geolocation with ip address | No | Yes | [Go!](https://ipinfo.io/) |
+| IP Location| Find IP address location information | No | Yes | [Go!](https://ipapi.co/) |
 | IP Vigilante | Free IP Geolocation API | No | Yes | [Go!](https://www.ipvigilante.com/) |
 | Mapbox | Create/customize beautiful digital maps | `apiKey` | Yes | [Go!](https://www.mapbox.com/developers/) |
-| Mapzen Search | Open Source & Open Data Global Geocoding Service | No | Yes | [Go!](https://mapzen.com/products/search/) |
+| Mapzen Search | Open Source & Open Data Global Geocoding Service | `apiKey` | Yes | [Go!](https://mapzen.com/products/search/) |
 | Mexico | Mexico RESTful zip codes API | No | Yes | [Go!](https://github.com/IcaliaLabs/sepomex) |
-| One Map 2.0, Singapore| Singapore Land Authority REST API services for Singapore addresses  | Yes | Yes | [Go!](https://docs.onemap.sg/) |
+| One Map 2.0, Singapore| Singapore Land Authority REST API services for Singapore addresses  | `apiKey` | Yes | [Go!](https://docs.onemap.sg/) |
+| OnWater | Determine if a lat/lon is on water or land | No | Yes | [Go!](https://onwater.io/) |
 | OpenCage | Forward and reverse geocoding using open data | No | Yes | [Go!](https://geocoder.opencagedata.com) |
 | OpenStreetMap | Navigation, geolocation and geographical data | `OAuth` | No | [Go!](http://wiki.openstreetmap.org/wiki/API) |
 | PostcodeData.nl | Provide geolocation data based on postcode for Dutch addresses | No | No | [Go!](http://api.postcodedata.nl/v1/postcode/?postcode=1211EP&streetnumber=60&ref=domeinnaam.nl&type=json) |
@@ -297,40 +299,35 @@ Please note a passing build status indicates all listed APIs are available since
 
 
 ### Health
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Diabetes | Logging and retrieving diabetes information | No | No | [Go!](http://predictbgl.com/api/) |
 | Flutrack | Influenza-like symptoms with geotracking | No | No | [Go!](http://www.flutrack.org/) |
 | Makeup | Makeup Information | No | No | [Go!](http://makeup-api.herokuapp.com/) |
+| Medicare | Access to the data from the CMS - medicare.gov | No | Yes | [Go!](https://data.medicare.gov/developers) |
 | Nutritionix | Worlds largest verified nutrition database | `apiKey` | Yes | [Go!](https://developer.nutritionix.com/) |
 | openFDA | Public FDA data about drugs, devices, and foods | No | Yes | [Go!](https://open.fda.gov/api/) |
 | USDA Nutrients | National Nutrient Database for Standard Reference | No | Yes | [Go!](https://ndb.nal.usda.gov/ndb/doc/index) |
 
 ### Machine Learning
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
-| API.AI | Natural Language Processing | `apikey` | Yes | [Go!](https://api.ai/) |
+| API.AI | Natural Language Processing | `apiKey` | Yes | [Go!](https://api.ai/) |
 | Clarifai | Computer Vision | `OAuth` | Yes | [Go!](https://developer.clarifai.com/) |
-| Cleverbot | Web chat bot | `apikey` | Yes | [Go!](https://www.cleverbot.com/api/) |
+| Cleverbot | Web chat bot | `apiKey` | Yes | [Go!](https://www.cleverbot.com/api/) |
-| Keen IO | Data Analytics | `apikey` | Yes | [Go!](https://keen.io/) |
+| Keen IO | Data Analytics | `apiKey` | Yes | [Go!](https://keen.io/) |
-| Rekognition | Deep learning-based image recognition | Yes | Yes | [Go!](https://aws.amazon.com/rekognition/) |
+| Unplugg | Forecasting API for timeseries data | `apiKey` | Yes | [Go!](https://unplu.gg/test_api.html) |
-| Unplugg | Forecasting API for timeseries data | `apikey` | Yes | [Go!](https://unplu.gg/test_api.html) |
-| Cloud Vision API | Images analysis | `apikey` | Yes | [Go!](https://cloud.google.com/vision/) |
 | Wit.ai | Natural Language Processing | `OAuth` | Yes | [Go!](https://wit.ai/) |
 
 ### Math
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Newton | Symbolic and Arithmetic Math Calculator | No | Yes | [Go!](https://newton.now.sh/) |
 | Numbers API | Facts about numbers | No | No | [Go!](http://numbersapi.com) |
 
 
 ### Music
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Bandsintown | Music Events | No | Yes | [Go!](https://app.swaggerhub.com/apis/Bandsintown/PublicAPI/3.0.0) |
 | Deezer | Music | `OAuth` | No | [Go!](http://developers.deezer.com/login?redirect=/api) |
@@ -338,46 +335,44 @@ Please note a passing build status indicates all listed APIs are available since
 | Genius | Crowdsourced lyrics and music knowledge | `OAuth` | Yes | [Go!](https://docs.genius.com/) |
 | Jamendo | Music | `OAuth` | Yes | [Go!](https://developer.jamendo.com/v3.0) |
 | iTunes Search | Software products | No | Yes | [Go!](https://affiliate.itunes.apple.com/resources/documentation/itunes-store-web-service-search-api/) |
-| LastFm | Music | No | No | [Go!](http://www.last.fm/api) |
+| LastFm | Music | `apiKey` | No | [Go!](http://www.last.fm/api) |
 | Mixcloud | Music | No | Yes | [Go!](https://www.mixcloud.com/developers/) |
 | MusicBrainz | Music | No | Yes | [Go!](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2) |
 | Musikki | Music | No | Yes | [Go!](https://music-api.musikki.com/reference) |
 | Musixmatch | Music | `apiKey` | Yes | [Go!](https://developer.musixmatch.com/) |
+| Songkick | Music Events | `OAuth` | Yes | [Go!](https://www.songkick.com/developer/) |
 | Songsterr | Provides guitar, bass and drums tabs and chords  | No | Yes | [Go!](https://www.songsterr.com/a/wa/api/) |
 | Soundcloud | Music | No | Yes | [Go!](https://developers.soundcloud.com/) |
 | Spotify | Music | `OAuth` | Yes | [Go!](https://developer.spotify.com/web-api/) |
 | Vagalume | Crowdsourced lyrics and music knowledge | `apiKey` | Yes | [Go!](https://api.vagalume.com.br/docs/) |
 
 ### News
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
-| New York Times | Provides news | `apikey` | Yes | [Go!](https://developer.nytimes.com/) |
+| New York Times | Provides news | `apiKey` | Yes | [Go!](https://developer.nytimes.com/) |
-| News API | headlines currently published on a range of news sources and blogs | `apikey` | Yes | [Go!](https://newsapi.org/) |
+| News API | Headlines currently published on a range of news sources and blogs | `apiKey` | Yes | [Go!](https://newsapi.org/) |
-| The Guardian | Access all the content the Guardian creates, categorised by tags and section | `apikey` | Yes | [Go!](http://open-platform.theguardian.com/) |
+| The Guardian | Access all the content the Guardian creates, categorised by tags and section | `apiKey` | Yes | [Go!](http://open-platform.theguardian.com/) |
 
 ### Open Source projects
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Countly  | Countly web analytics | No | No | [Go!](http://resources.count.ly/docs) |
 | Drupal.org | Drupal.org | No | Yes | [Go!](https://www.drupal.org/drupalorg/docs/api) |
 | Libraries.io | Open source software libraries | `apiKey` | Yes | [Go!](https://libraries.io/api) |
 
 ### Personality
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | chucknorris.io | JSON API for hand curated Chuck Norris jokes | No | Yes | [Go!](https://api.chucknorris.io) |
 | Forismatic | Inspirational Quotes | No | No | [Go!](http://forismatic.com/en/api/) |
+| icanhazdadjoke | The largest selection of dad jokes on the internet | No | Yes | [Go!](https://icanhazdadjoke.com/api) |
 | Medium | Community of readers and writers offering unique perspectives on ideas. | `OAuth` | Yes | [Go!](https://github.com/Medium/medium-api-docs) |
 | Quotes on Design | Inspirational Quotes | No | Yes | [Go!](https://quotesondesign.com/api-v4-0/) |
 | Traitify | Assess, collect, and analyze Personality | No | Yes | [Go!](https://app.traitify.com/developer) |
 | tronalddump.io | Api & web archive for the things Donald Trump has said | No | Yes | [Go!](https://www.tronalddump.io) |
 
 ### Photography
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | 500px |  Photography Community | `OAuth` | Yes | [Go!](https://github.com/500px/api-documentation) |
 | Flickr | Flickr Services | `OAuth` | Yes | [Go!](https://www.flickr.com/services/api/) |
@@ -386,14 +381,13 @@ Please note a passing build status indicates all listed APIs are available since
 | Imgur | Images | `OAuth` | Yes | [Go!](https://api.imgur.com/#overview) |
 | ScreenShotLayer | URL 2 Image | No | Yes | [Go!](https://screenshotlayer.com) |
 | Unsplash | Photography | `OAuth` | Yes | [Go!](https://unsplash.com/developers) |
+| PlaceKitten | Resizable kitten placeholder images | No | Yes | [Go!](https://placekitten.com/) |
 
 ### Science
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | arcsecond.io | Multiple astronomy data sources | No | Yes | [Go!](https://api.arcsecond.io/) |
 | Fedger.io | Query machine intelligence data | No | Yes | [Go!](https://dev.fedger.io/docs/) |
-| Gene_info | human genome data w/ gene summaries | `apiKey` | No | [Go!](http://www.geneinfo.life) |
 | inspirehep.net | High Energy Physics info. system | No | Yes | [Go!](https://inspirehep.net/info/hep/api?ln=en) |
 | Launch Library | Upcoming Space Launches | No | Yes | [Go!](https://launchlibrary.net/1.2/docs/api.html) |
 | Minor Planet Center | Asterank.com Information | No | No | [Go!](http://www.asterank.com/mpc) |
@@ -401,24 +395,22 @@ Please note a passing build status indicates all listed APIs are available since
 | Open Notify | ISS astronauts, current location, etc | No | No | [Go!](http://open-notify.org/Open-Notify-API/) |
 | Sunrise and Sunset | Sunset and sunrise times for a given latitude and longitude. | No | Yes | [Go!](https://sunrise-sunset.org/api) |
 | USGS Earthquake Hazards Program | Earthquakes data real-time | No | Yes | [Go!](https://earthquake.usgs.gov/fdsnws/event/1/) |
+| USGS Water Services | Water quality and level info for rivers and lakes | No | Yes | [Go!](https://waterservices.usgs.gov/) |
 | World Bank | World Data | No | No | [Go!](https://datahelpdesk.worldbank.org/knowledgebase/topics/125589) |
 
 ### Security
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | AXFR Database | AXFR public database | No | No | [Go!](http://api.axfrcheck.com) |
 | UK Police | UK Police data | No | Yes | [Go!](https://data.police.uk/docs/) |
 
 ### Shopping
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | eBay | Sell and Buy on eBay | `OAuth` | Yes | [Go!](https://go.developer.ebay.com/) |
 
 ### Social
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Discord | Make bots for Discord, integrate Discord onto an external platform | `OAuth` | Yes | [Go!](https://discordapp.com/developers/docs/intro) |
 | DonReach Social Count | Get the social share count of a URL from every major social network | No | Yes | [Go!](https://donreach.com/social-share-count/) |
@@ -439,11 +431,10 @@ Please note a passing build status indicates all listed APIs are available since
 | Tumblr | Read and write Tumblr Data | `OAuth` | Yes | [Go!](https://www.tumblr.com/docs/en/api/v2) |
 | Twitch | Game Streaming API | `OAuth` | Yes | [Go!](https://github.com/justintv/Twitch-API) |
 | Twitter | Read and write Twitter data | `OAuth` | Yes | [Go!](https://dev.twitter.com/rest/public) |
-| vk | Read and write vk dat | `OAuth` | Yes | [Go!](https://vk.com/dev/sites) |
+| vk | Read and write vk data | `OAuth` | Yes | [Go!](https://vk.com/dev/sites) |
 
 ### Sports & Fitness
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Cartola FC | The Cartola FC API serves to check the partial points of your team. | No | Yes | [Go!](https://github.com/wgenial/cartrolandofc) |
 | City Bikes | City Bikes around the world | No | No | [Go!](http://api.citybik.es/v2/) |
@@ -451,28 +442,28 @@ Please note a passing build status indicates all listed APIs are available since
 | Fitbit | Fitbit Information | `OAuth` | Yes | [Go!](https://dev.fitbit.com/) |
 | Football-Data.org | Football Data | No | No | [Go!](http://api.football-data.org/index) |
 | JCDecaux Bike | JCDecaux's self-service bicycles | `apiKey` | Yes | [Go!](https://developer.jcdecaux.com/) |
-| Cricket Live Scores | live-score | `X-Mashape-Key` | Yes | [Go!](https://market.mashape.com/dev132/cricket-live-scores) |
+| Cricket Live Scores | Live cricket scores | `X-Mashape-Key` | Yes | [Go!](https://market.mashape.com/dev132/cricket-live-scores) |
 | NFL Arrests | NFL Arrest Data | No | No | [Go!](http://nflarrest.com/api/) |
 | Pro Motocross | The RESTful AMA Pro Motocross lap times for every racer on the start gate | No | No | [Go!](http://promotocrossapi.com) |
 | Strava | Connect with athletes, activities and more | `OAuth` | Yes | [Go!](https://strava.github.io/api/) |
 | UFC Data | Ultimate Fighting Championship information for events and fighters | No | No | [Go!](http://ufc-data-api.ufc.com/) |
-| Wger | Workout manager data as exercises, muscles or equipments | `apiKey` | Yes | [Go!](https://wger.de/en/software/api) |
+| Wger | Workout manager data as exercises, muscles or equipment | `apiKey` | Yes | [Go!](https://wger.de/en/software/api) |
 
 ### Tracking
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Postmon | An API to query Brazilian ZIP codes and orders easily, quickly and free | No | No | [Go!](http://postmon.com.br) |
-| Sweden  | Provides  information about parcels in transport | `apikey` | No | [Go!](https://developer.postnord.com/docs2) |
+| Sweden  | Provides information about parcels in transport | `apiKey` | No | [Go!](https://developer.postnord.com/docs2) |
 
 ### Transportation
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
+| ADS-B Exchange | Access real-time and historical data of any and all airbone aircraft. | No | Yes | [Go!](https://www.adsbexchange.com/data/) |
 | Amadeus Travel Innovation Sandbox | Travel Search - Limited usage | `apiKey` | Yes | [Go!](https://sandbox.amadeus.com/) |
+| Bay Area Rapid Transit | Stations and predicted arrivals for BART | `apiKey` | No | [Go!](http://api.bart.gov) |
 | Community Transit | Transitland API | No | Yes | [Go!](https://github.com/transitland/transitland-datastore/blob/master/README.md#api-endpoints) |
 | Goibibo | API for travel search  | `apiKey` | Yes | [Go!](https://developer.goibibo.com/docs) |
-| Indian Railways | Indian Railways Information | `token` | No | [Go!](http://api.erail.in/) |
+| Indian Railways | Indian Railways Information | `apiKey` | No | [Go!](http://api.erail.in/) |
 | Navitia | The open API for building cool stuff with transport data | `apiKey` | Yes | [Go!](https://api.navitia.io/) |
 | The Nomad List | A list of the best places to live/work remotely | No | Yes | [Go!](https://nomadlist.com/faq) |
 | Schiphol Airport | Schiphol | `apiKey` | Yes | [Go!](https://developer.schiphol.nl/) |
@@ -480,7 +471,7 @@ Please note a passing build status indicates all listed APIs are available since
 | Transport for Atlanta, US | Marta | No | No | [Go!](http://www.itsmarta.com/app-developer-resources.aspx) |
 | Transport for Auckland, New Zealand | Auckland Transport API  | No | Yes | [Go!](https://api.at.govt.nz/) |
 | Transport for Belgium | Belgian transport API | No | Yes | [Go!](https://hello.irail.be/api/) |
-| Transport for Berlin, Germany | third-party VBB API | No | Yes | [Go!](https://github.com/derhuerst/vbb-rest/blob/master/docs/index.md) |
+| Transport for Berlin, Germany | Third-party VBB API | No | Yes | [Go!](https://github.com/derhuerst/vbb-rest/blob/master/docs/index.md) |
 | Transport for Boston, US | MBTA API | No | No | [Go!](http://realtime.mbta.com/Portal/Home/Documents) |
 | Transport for Budapest, Hungary | Budapest public transport API | No | Yes | [Go!](https://apiary.io/) |
 | Transport for Chicago, US | CTA | No | No | [Go!](http://www.transitchicago.com/developers/) |
@@ -492,6 +483,8 @@ Please note a passing build status indicates all listed APIs are available since
 | Transport for London, England | TfL API | No | Yes | [Go!](https://api.tfl.gov.uk) |
 | Transport for Madrid, Spain | Madrid BUS transport API | `apiKey` | No | [Go!](http://opendata.emtmadrid.es/Servicios-web/BUS) |
 | Transport for Minneapolis, US | NexTrip API | `OAuth` | No | [Go!](http://svc.metrotransit.org/) |
+| Transport for The Netherlands | NS, only trains | `apiKey` | No | [Go!](http://www.ns.nl/reisinformatie/ns-api) |
+| Transport for The Netherlands | OVAPI, country-wide public transport | No | Yes | [Go!](https://github.com/skywave/KV78Turbo-OVAPI/wiki) |
 | Transport for New York City, US | MTA | `apiKey` | No | [Go!](http://datamine.mta.info/) |
 | Transport for Norway | Norwegian transport API | No | No | [Go!](http://reisapi.ruter.no/help) |
 | Transport for Ottawa, Canada | OC Transpo next bus arrival API | No | No | [Go!](http://www.octranspo.com/index.php/developers) |
@@ -503,45 +496,42 @@ Please note a passing build status indicates all listed APIs are available since
 | Transport for Sweden | Public Transport consumer | `OAuth` | Yes | [Go!](https://www.trafiklab.se/api) |
 | Transport for Switzerland | Swiss public transport API | No | Yes | [Go!](https://transport.opendata.ch/) |
 | Transport for Switzerland | Official Swiss Public Transport Open Data | `apiKey` | Yes | [Go!](https://opentransportdata.swiss/en/) |
-| Transport for The Netherlands | NS | No | No | [Go!](http://www.ns.nl/reisinformatie/ns-api) |
+| Transport for Tokyo, Japan | Tokyo Metro | `apiKey` | Yes | [Go!](https://developer.tokyometroapp.jp/info) |
-| Transport for Tokyo, Japan | Tokyo Metro | `apiKey` | Yes | [Go!](https://developer.tokyometroapp.jp/info)  |
 | Transport for Toronto, Canada | TTC | No | Yes | [Go!](https://myttc.ca/developers) |
 | Transport for Vancouver, Canada | TransLink | `OAuth` | Yes | [Go!](https://developer.translink.ca/) |
+| Transport for U.S. (multiple locations) | NextBus API | No | No | [Go!](http://www.nextbus.com/xmlFeedDocs/NextBusXMLFeed.pdf) |
 | Transport for Victoria, AU | PTV API | `apiKey` | Yes | [Go!](https://www.ptv.vic.gov.au/about-ptv/ptv-data-and-reports/digital-products/ptv-timetable-api/) |
 | Transport for Washington, US | Washington Metro transport API | `OAuth` | Yes | [Go!](https://developer.wmata.com/) |
 | Uber | Request Uber rides, reach riders, transport things, and reward drivers | `OAuth` | Yes | [Go!](https://developer.uber.com/) |
 | WhereIsMyTransport | Platform for public transport data in emerging cities  | `OAuth` | Yes | [Go!](https://developer.whereismytransport.com/) |
 
 ### University
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Universities List | University names, countries and domains| No | Yes | [Go!](https://github.com/Hipo/university-domains-list) |
 
 ### Vehicle
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
-| Vehicles | Lot of vehicles informations | `apiKey` | No | [Go!](http://developer.edmunds.com/api-documentation/overview/) |
+| Vehicles | Lot of vehicles information | `apiKey` | No | [Go!](http://developer.edmunds.com/api-documentation/overview/) |
 | Brazilian Vehicles and Prices | Vehicles information from Fundação Instituto de Pesquisas Econômicas - Fipe | No | Yes | [Go!](https://deividfortuna.github.io/fipe/) |
 | NHTSA Vehicles | NHTSA Product Information Catalog and Vehicle Listing | No | Yes | [Go!](https://vpic.nhtsa.dot.gov/api/) |
 
 ### Video
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | An API of Ice And Fire | Game Of Thrones API | No | Yes | [Go!](https://anapioficeandfire.com/) |
 | Dailymotion | Dailymotion Developer API | `OAuth` | Yes | [Go!](https://developer.dailymotion.com/) |
-| MovieDB | Movie Data | `apiKey` | Yes | [Go!](https://www.themoviedb.org/documentation/api) |
+| Netflix Roulette | Netflix database | No | Yes | [Go!](https://netflixroulette.net/api/) |
-| Netflix Roulette | Netflix database | No | No | [Go!](http://netflixroulette.net/api/) |
 | Ron Swanson Quotes | Television | No | Yes | [Go!](https://github.com/jamesseanwright/ron-swanson-quotes#ron-swanson-quotes-api) |
+| SWAPI | Star Wars Information | No | Yes | [Go!](https://swapi.co) |
+| TMDb | Community-based movie data | `apiKey` | Yes | [Go!](https://www.themoviedb.org/documentation/api) |
 | TVMaze | TV Show Data | No | No | [Go!](http://www.tvmaze.com/api) |
 | Vimeo | Vimeo Developer API | `OAuth` | Yes | [Go!](https://developer.vimeo.com/) |
 | YouTube | Add YouTube functionality to your sites and apps. | `OAuth` | Yes | [Go!](https://developers.google.com/youtube/) |
 
 ### Weather
-
+API | Description | Auth | HTTPS | Link |
-| API | Description | Auth | HTTPS | Link |
 |---|---|---|---|---|
 | Dark Sky | Weather | `apiKey` | Yes | [Go!](https://darksky.net/dev/) |
 | MetaWeather | Weather | No | Yes | [Go!](https://www.metaweather.com/api/) |

build/build.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+# create json directory if not already present
+mkdir -p ../json
+# parse API README and print (minified) JSON to stdout, redirect to /json
+node md2json.js ../README.md > ../json/entries.min.json
+# beautify the previously created JSON file, redirect to /json
+python -m json.tool ../json/entries.min.json > ../json/entries.json

build/deploy.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+
+set -o errexit -o nounset
+
+if [ "$TRAVIS_BRANCH" != "master" ]
+then
+  echo "This commit was made against $TRAVIS_BRANCH and not master! No deploy!"
+  exit 0
+fi
+
+rev=$(git rev-parse --short HEAD)
+
+mkdir deploy
+cd deploy
+
+git init
+git config --global user.name $GH_USER
+git config --global user.email $GH_EMAIL
+
+git remote add upstream "https://$GH_TOKEN@github.com/toddmotto/public-apis.git"
+git fetch upstream
+git reset upstream/master
+
+mv ../../json .
+
+git add json/
+git commit -m "rebuild JSON at ${rev}" -m "[ci skip]"
+git push upstream HEAD:master
+

build/main.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+
+FORMAT_FILE=../README.md
+if [ "$TRAVIS_PULL_REQUEST" == "false" ]; then
+    echo "running on $TRAVIS_BRANCH branch"
+    LINK_FILE=../README.md
+else
+    echo "running on Pull Request #$TRAVIS_PULL_REQUEST"
+    DIFF_URL="https://patch-diff.githubusercontent.com/raw/toddmotto/public-apis/pull/$TRAVIS_PULL_REQUEST.diff"
+    curl $DIFF_URL > diff.txt
+    echo "------- BEGIN DIFF -------"
+    cat diff.txt
+    echo "-------- END DIFF --------"
+    cat diff.txt | egrep "\+" > additions.txt
+    echo "------ BEGIN ADDITIONS -----"
+    cat additions.txt
+    echo "------- END ADDITIONS ------"
+    LINK_FILE=additions.txt
+fi
+
+echo "running format validation..."
+./validate_format.rb $FORMAT_FILE
+if [[ $? != 0 ]]; then
+    echo "format validation failed!"
+    exit 1
+else
+    echo "format validation passed!"
+fi
+
+echo "running link validation..."
+./validate_links.rb $LINK_FILE
+if [[ $? != 0 ]]; then
+    echo "link validation failed!"
+    exit 1
+else
+    echo "link validation passed!"
+fi

build/md2json.js

@@ -0,0 +1,131 @@
+fs = require('fs')
+
+function md_trim(str, context) {
+    str = str.replace(/(^\s+)|(\s+$)/g, "");
+
+    if (context == 1) { // Name
+        // placeholder for any formatting on name value
+    } else if (context == 2) { // Description
+        str = str.replace(".", ""); // remove ending periods on descriptions
+    } else if (context == 3) { // Auth
+        if (str.toUpperCase() == "NO") {
+            str = null
+        } else {
+            str = str.replace("`", "").replace("`", "")
+        }
+    } else if (context == 4) { // HTTPS
+        if (str.toUpperCase() == "YES") {
+            str = true
+        } else {
+            str = false
+        }
+    } else if (context == 5) { // Link
+        str = str.replace("[Go!]", "").slice(1, -1);
+    }
+    return str;
+}
+
+function handle(filename, anchor) {
+    fs.readFile(filename, 'utf8', function (err,text) {
+      if (err) {
+        return console.log(err);
+      }
+    var lines = text.split("\n");
+    var cur_line = 0;
+    var line = ""
+    var table_name = "";
+    var col_num = 0;
+    var cols = [];
+    var rows = [];
+
+    function read_line() {
+        return lines[cur_line++];
+    }
+    var root = {};
+    while (true) {
+        var cols = [];
+        var rows = [];
+        while (line.indexOf(anchor) == -1 && cur_line != lines.length) {
+            line = read_line();
+        }
+        if (cur_line == lines.length) {
+            break;
+        }
+        table_name = line.split(anchor)[1];
+        table_name = md_trim(table_name, 0)
+
+        line = read_line()
+
+        if (line) {
+            line = line.split("|")
+            for (var j in line) {
+
+                line[j] = md_trim(line[j], 0)
+                if ((j == 0 || j == line.length - 1) && line[j] === "") {
+
+                } else {
+                    cols.push(line[j]);
+                }
+            }
+            if (line.length) {
+                cols = line;
+                rows.push(cols)
+            } else {
+                console.error("markdown expect column title")
+                break;
+            }
+        } else {
+            console.error("markdown expect table content")
+            break;
+        }
+
+        line = read_line()
+
+        if (!line) {
+            console.error("markdown expect table spliter")
+            break;
+        }
+        line = read_line()
+        while (line.indexOf("|") != -1 && cur_line != lines.length) {
+
+            var line_this = line.split("|")
+            var row = []
+            for (var j in line_this) {
+                line_this[j] = md_trim(line_this[j], j)
+                if ((j == 0 || j == line_this.length - 1) && line_this[j] === "") {
+
+                } else {
+                    row.push(line_this[j]);
+                }
+
+            }
+            rows.push(row);
+            line = read_line()
+        }
+
+        var data=[];
+        for (var j in rows) {
+            if (j != 0) {
+                var ele = {};
+                for (var k in rows[j]) {
+                    ele[rows[0][k]] = rows[j][k];
+                }
+                data.push(ele);
+            }
+        }
+        root[table_name] = data;
+    }
+    console.log(JSON.stringify(root));
+  });
+}
+
+if (process.argv.length < 3) {
+    console.log("No .md file passed!");
+    return;
+}
+if (process.argv.length < 4) {
+  anchorText = "###";
+} else {
+  anchorText = process.argv[3];
+}
+handle(process.argv[2].toString(), anchorText);

build/validate_format.rb

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+auth_keys = ['apiKey', 'OAuth', 'X-Mashape-Key', 'No']
+https_keys = ['Yes', 'No']
+args = ARGV
+filename = args[0]
+fail_flag = false
+File.foreach(filename).with_index do |line, line_num|
+    line_num += 1
+    if line.start_with?('|')
+        # Skip table schema lines
+        if line.eql? "|---|---|---|---|---|\n"
+            next
+        end
+        values = line.split("|")
+        # Check Description to make sure first character is capitalized
+        desc_val = values[2].lstrip.chop
+        if !/[[:upper:]]/.match(desc_val[0])
+            puts "(#{line_num}) Invalid Description (first char not uppercase): #{desc_val}"
+            fail_flag = true
+        end
+        # Check Auth values to conform to valid options only
+        auth_val = values[3].lstrip.chop.tr('``', '')
+        if !auth_keys.include?(auth_val)
+            puts "(#{line_num}) Invalid Auth (not a valid option): #{auth_val}"
+            fail_flag = true
+        end
+        # Check HTTPS Support values to be either "Yes" or "No"
+        https_val = values[4].lstrip.chop
+        if !https_keys.include?(https_val)
+            puts "(#{line_num}) Invalid HTTPS: (must use \"Yes\" or \"No\"): #{https_val}"
+            fail_flag = true
+        end
+        # Check Link to ensure url is wrapped in "[Go!]" view
+        link_val = values[5].lstrip.chop
+        if !link_val.start_with?("[Go!](") || !link_val.end_with?(')')
+            puts "(#{line_num}) Invalid Link: (format should be \"[Go!](<LINK>)\"): #{link_val}"
+            fail_flag = true
+        end
+    end
+end
+if fail_flag
+    exit(1)
+else
+    exit(0)
+end

build/validate_links.rb

@@ -0,0 +1,77 @@
+#!/usr/bin/env ruby
+require 'httparty'
+require 'ruby-progressbar'
+require 'uri'
+allowed_codes = [200, 302, 403, 429]
+allowed_links = ["https://www.yelp.com/developers/documentation/v3"]
+args = ARGV
+filename = args[0]
+contents = File.open(filename, 'rb') { |f| f.read }
+raw_links = URI.extract(contents, ['http', 'https'])
+# Remove trailing ')' from entry URLs
+links = []
+raw_links.each do |link|
+    if link.end_with?(')')
+        links.push(link[0...-1])
+    else
+        links.push(link)
+    end
+end
+if links.length <= 0
+    puts "no links to check"
+    exit(0)
+end
+fails = []
+# Fail on any duplicate elements
+dup = links.select{|element| links.count(element) > 1}
+if dup.uniq.length > 0
+    dup.uniq.each do |e|
+        fails.push("(DUP): #{e}")
+    end
+end
+# Remove any duplicates from array
+links = links.uniq
+count = 0
+total = links.length
+progressbar = ProgressBar.create(:total => total,
+    :format => "%a %P% | Processed: %c from %C")
+# GET each link and check for valid response code from allowed_codes
+links.each do |link|
+    begin
+        count += 1
+        if allowed_links.include?(link)
+            next
+        end
+        res = HTTParty.get(link, timeout: 10)
+        if res.code.nil?
+            fails.push("(NIL): #{link}")
+            next
+        end
+        if !allowed_codes.include?(res.code)
+            fails.push("(#{res.code}): #{link}")
+        end
+    rescue Net::ReadTimeout
+        fails.push("(TMO): #{link}")
+    rescue Net::OpenTimeout
+        fails.push("(TMO): #{link}")
+    rescue OpenSSL::SSL::SSLError
+        fails.push("(SSL): #{link}")
+    rescue SocketError
+        fails.push("(SOK): #{link}")
+    rescue Errno::ECONNREFUSED
+        fails.push("(CON): #{link}")
+    end
+    progressbar.increment
+end
+puts "#{count}/#{total} links checked"
+if fails.length <= 0
+    puts "all links valid"
+    exit(0)
+else
+    puts "-- RESULTS --"
+    fails.sort!
+    fails.each do |e|
+        puts e
+    end
+    exit(1)
+end