# patchBay

> A curated directory of 3,000+ free, public APIs across 56 categories. Search, browse, compare, and find the right API for any project.

patchBay (https://patchbay.cc) helps developers discover public APIs for their projects. Every API entry includes its name, description, authentication type, HTTPS support, CORS policy, category, and documentation URL.

## Key Pages

- [Homepage](https://patchbay.cc/): Search bar, featured APIs, editor's picks, category grid, and recently added APIs.
- [Categories](https://patchbay.cc/categories): Browse all 56 categories.
- [Category Page](https://patchbay.cc/category/{slug}): View all APIs in a specific category, with filters for auth type, HTTPS, and CORS.
- [API Detail](https://patchbay.cc/api/{slug}): Full details for a single API, including related APIs in the same category.
- [Search](https://patchbay.cc/search?q={query}): Search APIs by name or description.
- [Submit an API](https://patchbay.cc/submit): Submit a new API to the directory.
- [Featured Listings](https://patchbay.cc/featured): Information about premium featured placement for API providers.
- [Public API](https://patchbay.cc/developers): Documentation for the patchBay REST API.
- [Embed Badge](https://patchbay.cc/badge): Get a "Listed on patchBay" badge for your site or README.

## Public REST API

Query patchBay programmatically. No API key required. Base URL: `https://patchbay.cc/api/v1`

- `GET /apis` — List/search APIs. Params: `q`, `category`, `auth`, `https`, `cors`, `limit`, `offset`
- `GET /apis/{slug}` — Get a single API by slug.
- `GET /categories` — List all categories with API counts.

Rate limit: 60 requests per minute. All responses are JSON with CORS enabled.

## API Data Structure

Each API entry contains:

- **Name**: The API's name
- **Description**: What the API does
- **Auth Type**: Authentication method (e.g., "apiKey", "OAuth", "" for none)
- **HTTPS**: Whether the API supports HTTPS (true/false)
- **CORS**: CORS support status ("yes", "no", or "unknown")
- **Category**: The category the API belongs to
- **URL**: Link to the API's documentation or homepage

## Navigation

- **Search**: Use the search bar on the homepage or navigate to /search?q={query} to find APIs by name or description.
- **Browse by category**: Visit /categories to see all categories, or go directly to /category/{slug} for a specific category.
- **Filters**: On category pages, filter APIs by auth type, HTTPS support, and CORS policy.

## Optional

- [llms-full.txt](https://patchbay.cc/llms-full.txt): Extended version with all categories listed and example API entries.