# Getting Started


No signup or key is required — every endpoint is an open `GET`. The base URL is
`https://apis.io/api/v1`.

## Search the catalog

```bash
curl "https://apis.io/api/v1/search?q=payments&limit=3"
```

Scope by what comes back with `return` (`apis`, `providers`, or `tags`), and filter by `tags`,
`providers`, `artifact_types`, `industry`, `region`, and rating `band`:

```bash
# Messaging APIs from strong+ providers that ship an OpenAPI
curl "https://apis.io/api/v1/search?return=apis&tags=messaging&artifact_types=OpenAPI&band=exemplar,strong"
```

## Browse providers and APIs

```bash
curl "https://apis.io/api/v1/providers/twilio"
curl "https://apis.io/api/v1/providers/twilio/apis"
```

Fetch one API and inline a specific artifact:

```bash
curl "https://apis.io/api/v1/apis/twilio:twilio-accounts-api?artifact_types=OpenAPI&include=content"
```

## Ratings

```bash
curl "https://apis.io/api/v1/providers/twilio/rating"
curl "https://apis.io/api/v1/ratings?band=exemplar&facet=governance&min_facet=70"
```

## Pagination

Collections return `{ meta, data }` with page-based pagination:

```bash
curl "https://apis.io/api/v1/search?q=weather&page=2&limit=25"
```

```json
{ "meta": { "total": 152, "page": 2, "limit": 25, "pages": 7 }, "data": [ /* … */ ] }
```

See the full [API Reference](/api) for every parameter and response shape.