Welcome to the official public API for the public-apis project!

This service supports 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. If you would like to contribute, feel free to open a pull request.

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

---