# Overview


The **APIs.io API** is a read-only discovery API over the [APIs.io](https://apis.io/) catalog —
thousands of API providers and their published APIs, plus tags, industries, regions, ratings, and
machine-readable artifacts (OpenAPI, AsyncAPI, Postman, Arazzo, JSON Schema, JSON-LD, GraphQL,
rules, and more).

The same OpenAPI contract powers three surfaces:

- **REST API** — `https://apis.io/api/v1` ([API Reference](/api))
- **MCP server** — `https://apis.io/mcp` for AI agents ([MCP Server](./mcp-server))
- **Agent skills** — [apis.io/skills](https://apis.io/skills/)

## Base URL

```
https://apis.io/api/v1
```

All endpoints are `GET`, open, and read-only — see [Authentication](./authentication).

## Core resources

| Resource | Path |
| --- | --- |
| Unified search | `/search` |
| Providers | `/providers`, `/providers/{slug}` |
| APIs | `/apis`, `/apis/{aid}` |
| Tags | `/tags`, `/tags/{slug}` |
| Industries / Regions | `/industries`, `/regions` |
| Ratings | `/ratings`, `/ratings/rubric`, `/providers/{slug}/rating` |
| Artifact collections | `/openapis`, `/asyncapis`, `/postman`, `/json-schemas`, … |

Identifiers: providers are slugs (`twilio`); APIs are `provider:api-slug` (`twilio:twilio-accounts-api`).

Start with [Getting Started](./getting-started) for runnable examples, or jump to the
[API Reference](/api).