Copy page

Documentation

Getting Started

No signup or key is required to start — search, providers, APIs, tags, taxonomy and artifacts are open GETs on the free Explore plan. The base URL is https://apis.io/api/v1.

Ratings and the other cross-catalog resources need a key on a paid plan (or a per-call x402 payment), and the API also has POST, PATCH and DELETE operations for your own workspace, account and listing. None of them changes the published catalog. See Authentication and Plans.

Search the catalog

Code
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:

Code
# 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

Code
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:

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

Ratings

Ratings need a key on a paid plan — a request without one gets a 401 that says how to unlock it, including paying for the single call with x402.

Code
curl -H "x-api-key: $APIS_IO_KEY" "https://apis.io/api/v1/providers/twilio/rating"
curl -H "x-api-key: $APIS_IO_KEY" "https://apis.io/api/v1/ratings?band=exemplar&facet=governance&min_facet=70"

Pagination

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

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

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

See the full API Reference for every parameter and response shape.