developer-api-providers.md
APIs.io API
Organizations publishing APIs on the network.
/providers
List providers, optionally filtered by free text, tags, or the artifact types they publish.
q
string · maxLength: 1024
Free-text query over name and description (and tags where applicable).
tags
string[] · maxItems: 1000 · style: form
Comma-separated tags to filter by. Tag names are Title Case (e.g. Messaging); lowercase slugs (e.g. messaging) are also accepted.
match
string · enum · maxLength: 1024
Whether results must match any (default) or all of the supplied tags.
Enum values: any
all
Default: any
artifact_types
ArtifactType[] · maxItems: 1000 · style: form
Comma-separated artifact types. Filters which artifacts are returned and (on list endpoints) which APIs qualify.
Enum values: Documentation
OpenAPI
JSONSchema
JSONStructure
JSONLD
Example
GettingStarted
APIReference
show 40 more
industry
string[] · maxItems: 1000 · style: form
Filter by one or more industry slugs.
region
string[] · maxItems: 1000 · style: form
Filter by one or more region slugs.
band
Band[] · maxItems: 1000 · style: form
Filter by one or more rating bands.
Enum values: exemplar
strong
developing
thin
minimal
min_score
number · min: 0 · max: 100
Minimum composite score (0–100).
max_score
number · min: 0 · max: 100
Maximum composite score (0–100).
trend
Trend · enum · maxLength: 1024
Filter by trend marker.
Week-over-week movement in composite score (±5 thresholds).
Enum values: rising
flat
falling
facet
FacetName · enum · maxLength: 1024
Facet to apply min_facet against.
One of the six rating facets.
Enum values: discoverability
contract_quality
governance
operational_transparency
developer_ergonomics
commercial_clarity
min_facet
number · min: 0 · max: 100
Minimum score (0–100) for the facet named by facet.
sort
string · enum · maxLength: 1024
Sort order.
Enum values: relevance
name
api_count
created
score
Default: relevance
fields
string[] · maxItems: 1000 · style: form
Sparse fieldset — comma-separated property names to return.
page
integer · min: 1 · max: 1000000
1-based page number.
Default: 1
limit
integer · min: 1 · max: 100
Items per page.
Default: 25
200400
A page of providers.
meta
Meta · required
Pagination and echoed-query metadata for collection responses.
data
Provider[] · maxItems: 1000 · required
/providers/{slug}
Returns a single provider by slug, including its provider-wide links, tags, and a summary list of the APIs it publishes.
slug
string · maxLength: 1024 · required
Provider slug (e.g. twilio).
fields
string[] · maxItems: 1000 · style: form
Sparse fieldset — comma-separated property names to return.
200404
The provider.
slug
string · maxLength: 1024 · required
name
string · maxLength: 1024 · required
description
string · maxLength: 20000
api_count
integer · max: 1000
image
string · uri · maxLength: 2048
created
string · date · maxLength: 10
common
Link[] · maxItems: 1000
Provider-wide links (Website, Docs, Pricing, GitHub, social, …).
apis
object[] · maxItems: 1000
Summary list of the provider's APIs.
tags
string[] · maxItems: 1000
Tag names in Title Case (e.g. Messaging, Authentication).
Example: ["Messaging","Authentication"]
score
ProviderScore
A provider's rating, rubric v0.3.
/providers/{slug}/apis
Returns a page of the APIs owned by one provider, optionally filtered by tags and required artifact types. Pass include=content to inline artifact bodies.
slug
string · maxLength: 1024 · required
Provider slug (e.g. twilio).
tags
string[] · maxItems: 1000 · style: form
Comma-separated tags to filter by. Tag names are Title Case (e.g. Messaging); lowercase slugs (e.g. messaging) are also accepted.
match
string · enum · maxLength: 1024
Whether results must match any (default) or all of the supplied tags.
Enum values: any
all
Default: any
artifact_types
ArtifactType[] · maxItems: 1000 · style: form
Comma-separated artifact types. Filters which artifacts are returned and (on list endpoints) which APIs qualify.
Enum values: Documentation
OpenAPI
JSONSchema
JSONStructure
JSONLD
Example
GettingStarted
APIReference
show 40 more
include
string[] · maxItems: 1000 · style: form
Extra data to embed. content fetches and inlines artifact bodies.
Enum values: content
fields
string[] · maxItems: 1000 · style: form
Sparse fieldset — comma-separated property names to return.
page
integer · min: 1 · max: 1000000
1-based page number.
Default: 1
limit
integer · min: 1 · max: 100
Items per page.
Default: 25
200404
A page of the provider's APIs.
meta
Meta · required
Pagination and echoed-query metadata for collection responses.
data
Api[] · maxItems: 1000 · required
/providers/{slug}/artifacts
Aggregates all artifacts across a provider's APIs — grouped by type (OpenAPI, MCP, Arazzo, rules, security, pricing…) — plus per-type counts. One call instead of composing several.
slug
string · maxLength: 1024 · required
Provider slug (e.g. twilio).
200404
The provider's artifacts, grouped by type.
/providers/{slug}/onboarding
Assembles website, portal, signup, docs, authentication, base URLs, and first steps from a provider's registered links and API base URLs — a best-effort onboarding descriptor.
slug
string · maxLength: 1024 · required
Provider slug (e.g. twilio).
200404
The provider's onboarding view.
/providers/{slug}/similar
Ranks catalog providers by weighted overlap of tags, industry, region, and artifact coverage — the alternatives to a given provider.
slug
string · maxLength: 1024 · required
Provider slug (e.g. twilio).
limit
integer · min: 1 · max: 100
Items per page.
Default: 25
200404
A page of similar providers, most similar first.
meta
Meta · required
Pagination and echoed-query metadata for collection responses.
data
Provider[] · maxItems: 1000 · required