Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/davemachado/public-api
Public API for the public-apis Github project
https://github.com/davemachado/public-api
Last synced: 3 months ago
JSON representation
Public API for the public-apis Github project
- Host: GitHub
- URL: https://github.com/davemachado/public-api
- Owner: davemachado
- License: apache-2.0
- Created: 2018-01-17T04:12:48.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T06:28:39.000Z (about 2 years ago)
- Last Synced: 2024-07-31T21:53:10.803Z (6 months ago)
- Language: Go
- Homepage: https://api.publicapis.org
- Size: 102 KB
- Stars: 1,435
- Watchers: 62
- Forks: 154
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- public-apis - API for this project
- public-apis - API for this project
- fucking-public-apis - API for this project
- Awesome-API-Provider - Public APIs
- jimsghstars - davemachado/public-api - Public API for the public-apis Github project (Go)
README
# Public API for Public APIs
[](https://travis-ci.org/davemachado/public-api)
[](https://goreportcard.com/report/github.com/davemachado/public-api)
Welcome to the official public API for the [public-apis](https://github.com/public-apis/public-apis) project!
This service supports [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) and requires no authentication to use. All responses are sent over HTTPS as well.
If you would like to leave feedback or request a feature, please [open an issue](https://github.com/davemachado/public-api/issues). If you would like to contribute, feel free to [open a pull request](https://github.com/davemachado/public-api/pulls).
## Github Project
https://github.com/davemachado/public-api
## Base URL
https://api.publicapis.org/
---
# Services
## **GET** /entries
*List all entries currently cataloged in the project*
### Parameters
Parameter | Type | Data Type | Description | Required
| --- | --- | --- | --- | --- |
| title | query | string | name of entry (matches via substring - i.e. "at" would return "cat" and "atlas") | No |
| description | query | string | description of entry (matches via substring) | No |
| auth | query | string | auth type of entry (can only be values matching in project or null) | No |
| https | query | bool | return entries that support HTTPS or not | No |
| cors | query | string | CORS support for entry ("yes", "no", or "unknown") | No |
| category | query | string | return entries of a specific category | No |
> For categories like "Science & Math" which have a space and an ampersand, the query is simply the first word. Using "Science & Math" as an example, the correct query would be `category=science`
## **GET** /random
*List a single entry selected at random*
### Parameters
Parameter | Type | Data Type | Description | Required
| --- | --- | --- | --- | --- |
| title | query | string | name of entry (matches via substring - i.e. "at" would return "cat" and "atlas") | No |
| description | query | string | description of entry (matches via substring) | No |
| auth | query | string | auth type of entry (can only be values matching in project or null) | No |
| https | query | bool | return entries that support HTTPS or not | No |
| cors | query | string | CORS support for entry ("yes", "no", or "unknown") | No |
| category | query | string | return entries of a specific category | No |
## **GET** /categories
*List all categories*
### Parameters
None
## **GET** /health
*Check health of the running service*
### Parameters
None
---
[](https://www.digitalocean.com/)