developer-api-synthesis.md
APIs.io API
Decision-grade composites over the catalog — provider comparison, gap analysis, catalog change feed, and recommended-stack design. Pro.
/compare
Compares 2+ providers — composite/band, per-facet leaders, and an artifact-coverage matrix. Pro tier.
providers
string · maxLength: 1024 · required
Comma-separated provider slugs to compare (2+).
200400403
Side-by-side comparison of the requested providers.
/gaps
For each provider — the high-value artifacts it lacks, what its peers commonly publish but it lacks, and its score vs the peer median — plus stack-level gaps across the set. Pro tier.
providers
string · maxLength: 1024 · required
Comma-separated provider slugs (1+). Multiple = treat as a stack.
min_share
number · max: 1000000000
Peer-share threshold for a gap (0–1, default 0.25).
200400403
Per-provider and stack-level gaps.
/changes
Providers added/updated since a date, plus rating movement (up/down) from the latest scoring build. Pro tier.
since
string · date · maxLength: 10 · required
Cutoff date, YYYY-MM-DD.
limit
integer · min: 1 · max: 100
Items per page.
Default: 25
200400403
Catalog changes since the given date.
/stack
Decompose a domain into capabilities, then get the best-rated catalog provider per capability assembled into a stack. FREE returns a preview (top pick per capability); PRO returns alternatives, per-pick artifact gaps, and an exportable APIs.json + Arazzo hint.
capabilities
string · maxLength: 1024 · required
Comma-separated capabilities the stack needs, e.g. payments,email,identity,observability.
region
string · maxLength: 1024
Optional region slug to prefer, e.g. europe.
200400
A recommended stack (preview for free callers; full for Pro).
/gaps/industry/{slug}
For an industry vertical, reports which valuable artifact types (MCP, Arazzo, Rules, Skills…) most member providers lack — where the vertical is under-served.
slug
string · maxLength: 1024 · required
Industry slug (e.g. financial-services).
min_share
number · max: 1000000000
Coverage threshold below which a type counts as an industry gap (0–1, default 0.5).
200404
The industry's valuable-artifact coverage and gaps.
/stack/export
Given a set of capabilities, returns the designed stack as an adoptable APIs.json document (with an Arazzo hint) the team can commit.
capabilities
string · maxLength: 1024 · required
Comma-separated capabilities the stack needs, e.g. payments,email,identity.
region
string · maxLength: 1024
Optional region slug to prefer.
200400
The exportable stack.