Discover, rate and compare APIs and providers in the APIs.io catalog; manage a listing you own.
| Endpoint | https://apis.io/mcp (streamable-http) |
|---|---|
| Registry version | 1.3.0 |
| Now | 142 tools · grade C (69) · pin ts_e92539707e648cc2dff5899fc8bb54c3 · protocol 2025-06-18 |
| First / last listed | 2026-10-26 08:36 UTC / 2026-10-26 08:36 UTC |
| Grade over time | 2026-10-26: C (69), 142 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: apis_io_search get_prices get_playground_apis find_apis get_api find_providers get_provider find_tags get_tag find_industries get_industry find_estates get_estate get_provider_estate find_regions get_region find_countries get_country find_areas get_area find_regulations get_regulation find_extensions get_extension find_ratings get_provider_rating find_cohorts get_cohort find_tag_groups get_tag_group tag_group_tags cohort_stats cohort_rankings cohort_scores find_operations deprecated_operations cohort_history cohort_failures cohort_capabilities compare_cohorts get_provider_operations get_provider_tools get_provider_schema get_provider_facets get_agent_readiness find_agent_readiness agent_readiness_dimensions find_capabilities get_capability get_capability_edges get_provider_business_capabilities get_provider_capabilities get_provider_evidence get_rating_rubric find_artifacts compare_providers gap_analysis whats_changed recommend_stack get_provider_apis get_provider_artifacts get_api_artifacts get_openapi get_provider_onboarding find_similar_providers find_similar_apis get_industry_leaders get_region_leaders get_country_leaders get_area_leaders get_rating_history find_rating_movers story_leads what_can_i_fix readiness_gates simulate_fixes claim_listing generate_artifact submit_artifact correct_facts dispute_finding set_visibility watch_listing list_watches unwatch_listing request_check check_status find_agents register_agent report_gap my_checks export_dataset industry_gap_analysis export_stack insights_overview find_company_insights insights_dimensions insights_adoption insights_industries get_company_insight company_gaps match_providers find_vcs get_vc vc_portfolio find_investors resolve enrich_provider save_search my_workspace list_saved_searches run_saved_search saved_search_net_new delete_saved_search create_list list_lists get_list add_to_list delete_list find_openapis find_asyncapis find_channels find_graphql find_arazzo find_mcp find_skills find_rules find_overlays find_scopes find_security find_plans find_rate_limits find_finops find_collections find_json_ld find_json_schemas find_json_structures find_examples find_postman find_apis_json submit_feedback report_correction
apis_io_search | START HERE. Federated overview of the APIs.io catalog for a query: the top matching APIs, providers, AND tags in one call, each with its total match count. Filter by tags, artifact types, industry, region, rating band. `limit` is per section. To page/sort the full list of ONE type, use find_apis / find_providers / find_tags; for one entity, get_api / get_provider. params: return, q, tags, match, providers, artifact_types, band, min_score, industry, region, area, sort, limit, context |
get_prices | What one call costs on the pay-as-you-go plan, by cost band. FREE — and deliberately so: an agent that learns a price only when it is refused has already been refused by its own wallet. Call this BEFORE budgeting a run of paid tools. Returns the bands (free catalog reads, single-entity synthesis, cross-catalog synthesis, per-row bulk) and every priced resource key. Under an Understanding or Influe params: context |
get_playground_apis | Curated APIs that are SAFE TO EXPERIMENT WITH — no key (or an instant, free, self-serve key), no cost, and no real-world side effects. Free, and deliberately so: this is where you start if you are new here. Every entry carries an `example_request` URL that returned HTTP 200 to an unauthenticated GET on the date shown, so it can be called immediately with no setup. Use this when you are new to this params: access, grouping, tag, limit, context |
find_apis | Paginated, sortable list of APIs across providers — filter by tag, provider, artifact type, industry, region, or rating band. `q` is lexical over the API's own name and description; include=["via_provider"] adds APIs of providers whose name matched (the union apis_io_search counts). Use apis_io_search first for a cross-type overview. Parameter reference: apis://docs/tools/find_apis. params: q, tags, match, resolve, providers, artifact_types, band, min_score, industry, region, area, pricing, onboarding, try_now, public, sort, view, fields, page, limit, include, provenance, context |
get_api | Full detail for one API by aid (provider:api-slug); set include=["content"] to inline artifact bodies. Results carry `next`: the sub-resources that exist for this entity and the exact tool call that retrieves each, computed from this record. Pass include_next=false to omit it. params: aid*, artifact_types, include, include_next, context |
find_providers | Paginated, sortable, filterable list of providers. Size filters need Understanding. Overview: apis_io_search. Reference: apis://docs/tools/find_providers. params: q, tags, match, resolve, providers, artifact_types, band, min_score, industry, region, area, pricing, onboarding, try_now, public, sort, view, fields, page, limit, api_tags, include_narrower, group, publishes_api, accepts_writes, min_acting, country, platform, platform_area, max_score, trend, facet, min_facet, employees_band, revenue_band, size_basis, size_status, context |
get_provider | Full detail for one provider: profile, rating, and the APIs it publishes. The heavy `collections` and `common` sections are omitted by default (their counts are still reported) — pass view=full for the whole document, or fields=["common"] for a section. Narrow for cheap reads: fields=["score"] returns just the rating. Relative artifact URLs are resolved to absolute, fetchable ones. Results carry ` params: slug*, view, fields, include_next, context |
find_tags | Paginated, sortable list of tags in the taxonomy. Filter by `axis` to separate MARKETS (a business someone is in) from CAPABILITIES (the name of a resource in somebody's OpenAPI) — the single most useful distinction in the vocabulary, and a coin flip without it. A tag can carry more than one axis, so axis=market means market is ONE of its axes. Use apis_io_search first for a cross-type overview. params: q, sort, view, fields, page, limit, axis, band, min_api_count, context |
get_tag | One tag: its metadata, neighbor tags, and a top sample of its providers and APIs (with totals). `provider_count` counts companies that classify THEMSELVES here; `api_provider_count` counts the ones reached only through an API or operation tag — the two are disjoint, and a tag with no providers and many APIs names a resource, not a market. `age` summarises when the members were created (created_las params: slug*, view, limit, include_next, context |
find_industries | Browse industry verticals; sort by provider/API count. params: q, sort, page, limit, context |
get_industry | One industry: metadata + a top sample of its member providers (ranked, with the total). Use find_providers?industry=slug for the full list, or view=full here. Results carry `next`: the sub-resources that exist for this entity and the exact tool call that retrieves each, computed from this record. Pass include_next=false to omit it. params: slug*, view, limit, include_next, context |
find_estates | UNDERSTANDING — Browse corporate estates — one COMPANY whose API surface is spread across many provider records (Amazon 237, Salesforce 27, Cisco 37). Ranked by member count. Use this when two slugs look like separate vendors and you need to know whether they are one company. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis params: q, page, limit, context |
get_estate | UNDERSTANDING — One estate: the owning provider, the full member roster with per-member API counts and bands, and the estate-wide rating. Use get_provider_estate(slug) to go the other way, from a provider to the company that owns it. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, include_next, context |
get_provider_estate | Which corporate estate a provider belongs to, if any. Answers 200 with estate:null when the provider stands alone — that is a measured absence, not a missing record. params: slug*, context |
find_regions | Browse geographic regions; sort by provider/API count. Returns the 18 regions themselves. The collection also holds region x industry crossover pages (nordics-healthcare and 1,097 more); those are excluded unless you ask for them with type. params: q, sort, page, limit, type, context |
get_region | One region: metadata + a top sample of its member providers (ranked, with the total). Use find_providers?region=slug for the full list, or view=full here. Results carry `next`: the sub-resources that exist for this entity and the exact tool call that retrieves each, computed from this record. Pass include_next=false to omit it. params: slug*, view, limit, include_next, context |
find_countries | Browse the country dimension — the finest of the four place taxonomies, and the one a buyer usually names ("who is in Germany"). Peer to find_industries / find_regions / find_areas. Search by text; sort by provider count. Membership is derived and known to be partial: read a count as a floor, not a census. params: q, sort, page, limit, type, context |
get_country | One country: metadata, counts, and a top sample of member providers (with the total). Use find_providers?country=slug for the full ranked list, or view=full here. params: slug*, view, limit, include_next, context |
find_areas | Browse the API Evangelist areas taxonomy (authentication, webhooks, payments, …) — curated, scored provider indexes. Search by text; sort by provider count. params: q, sort, page, limit, context |
get_area | One area: metadata, its dedicated site link, and a top sample of member providers (with the total). Use find_providers?area=slug for the full list, or view=full here. Results carry `next`: the sub-resources that exist for this entity and the exact tool call that retrieves each, computed from this record. Pass include_next=false to omit it. params: slug*, view, limit, include_next, context |
find_regulations | Browse the laws, statutes and accreditations the catalog tracks, each joined to the countries, regions and industries it binds. Filter by scope=horizontal to get the regimes that reach a provider with NO industry tag at all, which is the question tags alone cannot answer; or by kind (regulation/statute/accreditation/regulator-guidance) or jurisdiction. A null company_count means the job-corpus pas params: q, scope, kind, jurisdiction, page, limit, context |
get_regulation | One regulation: what it is, its jurisdiction and scope, a link to the law itself, and reaches[] — the country, region and industry cohorts this regime binds. Use reaches[] to go straight to the affected members with find_providers. params: slug*, context |
find_extensions | Browse every OpenAPI `x-` specification extension harvested across the catalog, with the provenance the OpenAPI Initiative registry does not carry: who publishes it, in how many documents, where in the document it appears, and what shape the value takes. Search by key or purpose; sort by occurrences. params: q, sort, page, limit, context |
get_extension | One OpenAPI specification extension: its publishers, occurrence and document counts, where it appears, and the value shapes observed. CHECK is_api_evangelist BEFORE treating a key as provider-originated — some of these are published by API Evangelist, not by a vendor. params: slug*, view, include_next, context |
find_ratings | Ranked ratings leaderboard — filter by band, score range, trend, or facet threshold. Sort by composite (default), delta (biggest gainers), or any quality facet (governance, security, …) to rank providers by that dimension. Priced per result — $0.005 per request plus $0.0002 per record returned (less past 100), capped at $0.50 a request, under pay-as-you-go; included in Understanding and Influence. params: band, min_score, trend, facet, min_facet, tags, max_score, providers, sort, page, limit, context |
get_provider_rating | One provider's full rating breakdown (composite, band, trend, six facets). Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, context |
find_cohorts | START HERE for market-level questions. Every scored population of providers in the catalog — tags, industries, regions, areas and VC portfolios — as one browsable index. Filter by kind, minimum population, or promotion tier (report/brief/data). Then call cohort_stats for the distribution, cohort_rankings for the leaderboard. Priced per result — $0.005 per request plus $0.0002 per record returned ( params: kind, min_providers, tier, q, page, limit, context |
get_cohort | One cohort: its identity, its population, and the full member roster with each provider's Kin Score and agent readiness. Understanding plan. The analysis parts (stats/rankings/scores/capabilities) are Understanding too — they moved down from Influence on 2026-09-01. Priced per result — $0.005 per request plus $0.0002 per record returned (less past 100), capped at $0.50 a request, under pay-as-you- params: kind*, slug*, context |
find_tag_groups | START HERE for capability-map questions. The 1,500+ tag groups the catalog computes — sets of tags that demonstrably travel together across providers (Cards, Logistics, Wealth Management, Observability), the layer between a single tag and a coarse facet. Every response carries a `coverage` block: about a quarter of the vocabulary is in NO group, and any count taken from here should be read against params: q, basis, exclude, min_tags, page, limit, context |
get_tag_group | One tag group: its member tags and the full provider roster resolved from the catalog, each with Kin Score and agent readiness. Filter the roster by industry, region, country or area. Free; the DISTRIBUTION over the roster (`stats`) needs Understanding. Note `source_provider_count` vs `provider_count` — the first comes from an index that caps band membership at 1,000, the second is resolved live a params: slug*, industry, region, country, area, context |
tag_group_tags | The member tags of one tag group, each joined to its catalog record — provider count, api count, tag quality band and composite. Use it to see what a group is actually made of before trusting the group as a market. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, page, limit, context |
cohort_stats | UNDERSTANDING — the DISTRIBUTION for a whole market: Kin Score mean/median/min/max/stdev, agent-readiness spread, band split, per-facet averages, and artifact adoption rates. This is the market-stats sheet from a Trend Report, computed live. Always carries a `coverage` block saying how much of the roster is actually scored AND how deeply we enriched it (`enrichment_depth`: mean catalog_gap and med params: kind*, slug*, context |
cohort_rankings | UNDERSTANDING — the leaderboard for a market, on TWO axes: rank by Kin Score composite AND rank by agent readiness. The two orders differ, and the gap between a provider's two ranks is usually the story. Priced per result — $0.005 per request plus $0.0002 per record returned (less past 100), capped at $0.50 a request, under pay-as-you-go; included in Understanding and Influence. Estimate first at params: kind*, slug*, page, limit, context |
cohort_scores | UNDERSTANDING — facet-level scores for every member of a cohort, each with the cohort average and the delta against it. A 60 in governance means nothing until you know the market sits at 45; this is the endpoint that says so. Priced per result — $0.005 per request plus $0.0002 per record returned (less past 100), capped at $0.50 a request, under pay-as-you-go; included in Understanding and Influen params: kind*, slug*, page, limit, context |
find_operations | UNDERSTANDING — CATALOG-WIDE operation search: which providers expose a path matching your terms. "Who has a POST /refunds" had no answer before this — tags are what a company says about itself, a path is what its API accepts. Terms match path SEGMENTS (all must appear), so q="payment intents" finds /payments/v1/intents. Add method to narrow by verb, deprecated=true for the retiring ones. One row params: q*, method, deprecated, max_providers, page, limit, context |
deprecated_operations | UNDERSTANDING — every provider publishing at least one operation marked deprecated in its own OpenAPI, ranked by how many. The lifecycle view of the catalog: 8,297 deprecated operations across 681 providers, which nothing could see before, because a provider's own deprecated filter needs you to already suspect that provider. Drill in with get_provider_operations(deprecated=true). Priced per result params: page, limit, context |
cohort_history | UNDERSTANDING — the SET-LEVEL time series: how a whole market's Kin Score and agent readiness moved, build by build. There was a per-provider series and a whole-dataset licence and nothing between them, so "how has banking moved over six months" had no answer. Returns the MEAN over members present on each date plus members_scored beside it — membership changes as the catalog grows, and a move you params: kind*, slug*, context |
cohort_failures | UNDERSTANDING — what a whole market gets WRONG: the agent-readiness checks its members most commonly fail, ranked by what fixing each would move the cohort mean. The inverse of gap_analysis, which says where a market is under-served; this says where it is failing the rubric. Turns "fix your OpenAPI" into "this industry does not publish OpenAPI", which is the shape of a finding worth publishing. Na params: kind*, slug*, page, limit, context |
cohort_capabilities | UNDERSTANDING — what every member of a cohort actually publishes: artifact counts by type plus the agent-readiness dimensions each one satisfies. The capability matrix behind a market report. Large cohorts come back in byte-budgeted chunks: while `complete` is false, call again with `cursor` set to `next_cursor`; the last page has `complete: true` and a null `next_cursor`. Priced B2 (cross-catalog params: kind*, slug*, cursor, context |
compare_cohorts | UNDERSTANDING — two markets side by side on one rubric: "is US payments further along than UK banking?" Returns both distributions plus the deltas on score, agent readiness, every facet and every adoption rate. A question a written report cannot answer, because a report only ever covers one market. CHECK `depth_confounded` FIRST: when the higher-scoring cohort is also the one we enriched more deep params: a*, b*, context |
get_provider_operations | Every operation a provider exposes, across all of its OpenAPIs — method, path, operationId, summary, which API it belongs to, and whether it is deprecated. The shortcut for "what can I actually call here?", which otherwise means fetching and parsing every one of their specs. Where the provider publishes agentic-access, each operation also carries its action class and CONSEQUENCE (read vs something params: slug*, method, api, path, consequence, action_class, q, page, limit, context |
get_provider_tools | Every MCP tool a provider ships, with the operation each one wraps and its auth. Reports provenance per tool: `first-party` means the provider publishes that server, `derived` means API Evangelist generated a candidate tool list from their OpenAPI because no hosted server was found. Filter with provenance=first-party for a true picture — counting derived tools as the provider's own overstates MCP params: slug*, provenance, page, limit, context |
get_provider_schema | Every JSON Schema a provider publishes — the data shapes their API works in, in one list, without walking their artifacts. Free. params: slug*, q, page, limit, context |
get_provider_facets | UNDERSTANDING — one provider's score broken into its facets (discoverability, contract quality, governance, operational transparency, developer ergonomics, commercial clarity) plus any regulatory regime that applies. The composite is one number; these are the parts a team can actually act on. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and In params: slug*, context |
get_agent_readiness | EXPLORE — the agent-readiness dimensions and standalone score for ONE provider (spec presence, MCP server, auth clarity, idempotency, error semantics, rate-limit signal, well-known catalog, consent identity, dry-run…). A STANDALONE score, not a slice of the composite. For the same question across the catalog — who is agent-ready, which dimensions have actually diffused — use find_agent_readiness ( params: slug*, context |
find_agent_readiness | UNDERSTANDING — the agent-readiness leaderboard across the whole catalog. Rank providers by agent readiness, and filter to those that DO satisfy (has) or do NOT satisfy (missing) specific dimensions — e.g. has="mcp_server,protected_resource_metadata" is the OAuth-capable MCP cohort, missing="agent_card" is the addressable market for a fix. Returns agent score + band alongside the Kin Score. Priced params: has, missing, band, min_score, sort, page, limit, context |
agent_readiness_dimensions | UNDERSTANDING — diffusion: for each agent-readiness dimension, how many scored providers satisfy it, out of how many, as a share. The denominator every "the agent web is/is not here yet" claim needs and almost never has. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: page, limit, context |
find_capabilities | START HERE for "what can a business do with these APIs". The business-capability model — 333 top-level capabilities across 28 industries — with how many catalog providers reach each one. Defaults to capabilities the catalog actually reaches; pass all=true for the whole model INCLUDING the ones with no coverage, which is a real answer rather than a gap: most of what an enterprise does runs on inter params: q, industry, all, page, limit, context |
get_capability | One business capability: its definition, its sub-capabilities, the external authorities it cites, WHICH catalog providers reach it with their ratings, and what it COSTS — `economics` carries how many suppliers publish a price and how opaque the market is (free), and for Understanding the entry-cost (USD/month) and marginal-cost (USD per unit, by unit) quartiles, take rate, pricing-basis mix, deliv params: capability*, context |
get_capability_edges | UNDERSTANDING — the evidence behind a capability. Every edge that lands on it: the provider, the tag, the exact OpenAPI file, a calibrated confidence, and the QUOTED FRAGMENT OF THE PROVIDER'S OWN CONTRACT that justifies the claim. Only edges at confidence >= 0.7 whose evidence was found verbatim in the source contract are published, so an edge here is checkable rather than asserted. This is what params: capability*, context |
get_provider_business_capabilities | UNDERSTANDING — what ONE vendor's published APIs let a business DO, rolled up by capability, with the tag-level evidence under each. Answers "what is this vendor actually for" from its own contracts rather than its marketing. NOT get_provider_capabilities, which is artifact counts and agent-readiness dimensions and is free. Understanding plan. Priced B1 (single-entity synthesis) — $0.01 per call u params: slug*, context |
get_provider_capabilities | What one provider publishes, counted by artifact type, with the agent dimensions it satisfies. Free — it is a fact about their own public surface. NOTE: this is artifact counts, NOT business capabilities — for what the vendor lets a business DO, call get_provider_business_capabilities. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence params: slug*, context |
get_provider_evidence | How a provider's score was established, part by part: first-party (they published it), verified (we fetched and confirmed it), or derived (we inferred it). Free — the basis for a claim should never sit behind the claim. Call this before disputing or quoting a score. params: slug*, context |
get_rating_rubric | UNDERSTANDING — the rubric: bands, facet weights, trend thresholds, so an agent can interpret any score. Moved behind the paywall with the ratings data on 2026-08-31. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: context |
find_artifacts | Find artifacts of ANY one type across the catalog — the cross-type entry point. Each type also has a dedicated find_<type> tool (find_mcp, find_rules, find_scopes, …) with sorts and filters unique to that type; prefer those when you know the type. Types: mcp, skills, rules, arazzo, plans, rate-limits, finops, collections, asyncapis, graphql, json-ld, channels, examples, json-schemas, json-structur params: type*, q, tags, providers, include, page, limit, context |
compare_providers | UNDERSTANDING — Compare 2+ providers side by side: composite/band, per-facet leaders, an artifact-coverage matrix, and each provider's economics — audience, pricing basis, delivery, graded entry cost (USD/month) and marginal cost (USD per unit), with the plan and the quoted figure behind each number and the date it was read; `cheapest_entry` names the cheapest published way in. Priced B2 (cross-ca params: providers*, context |
gap_analysis | UNDERSTANDING — For each provider: high-value artifacts it lacks (MCP, Arazzo, Rules, Skills…), what its peers commonly publish but it lacks, and its score vs the peer median — plus stack-level gaps across the set. Priced B2 (cross-catalog synthesis) — $0.05 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: providers*, min_share, context |
whats_changed | UNDERSTANDING — What changed in the catalog since a date: providers added/updated, plus rating movement measured FROM THAT DATE — each provider's current score against its score at the first scored snapshot on or after `since`, with `was` and `compared_to` on every row. `basis` says whether the answer came from the recorded history or (when no snapshot covers the date) from last-build trend. Price params: since*, limit, context |
recommend_stack | Design an API stack — the best-rated catalog provider per capability, assembled into a stack. The Understanding preview is the top pick per capability; the full answer adds alternatives, per-pick artifact gaps, and an exportable APIs.json + Arazzo hint. Decompose the domain into capabilities first, then pass them here. Priced B2 (cross-catalog synthesis) — $0.05 per call under pay-as-you-go; inclu params: capabilities*, region, context |
get_provider_apis | Every API one provider publishes, as a page you can filter — the provider's own catalog rather than the whole network's. Prefer this over find_apis with a `providers` filter when you already know the company: it is the endpoint the provider page itself is built from, so `meta.total` is that provider's real API count. Filter by `tags` (with `match`), require `artifact_types`, or pass include=["cont params: slug*, tags, match, artifact_types, include, fields, page, limit, context |
get_provider_artifacts | Every artifact a provider publishes — provider-level (MCP, security, scopes, rules, agentic-access) and per-API (OpenAPI, Arazzo, overlays, reference docs) — grouped by type with counts. by_type_counts is the full summary; pass `type` (e.g. OpenAPI, MCP) to scope the artifacts list to one type, since an unfiltered provider can be 250+ entries. params: slug*, type, context |
get_api_artifacts | One API's artifacts grouped by type (by_type_counts is the full summary); pass `type` to scope the list to one type (synonym-aware: MCP matches MCPServer), include=["content"] to inline the bodies. params: aid*, type, include, context |
get_openapi | An API's primary OpenAPI reference (url) — the top agent intent; set include=["content"] to inline the spec body. params: aid*, include, context |
get_provider_onboarding | A getting-started view for a provider — website, portal, signup, docs, authentication, base URLs, and first steps assembled from its registered links. params: slug*, context |
find_similar_providers | Providers similar to a given one (alternatives) by shared tags, areas, industry, region, and artifact coverage. Products under the same owner (a sister, not a rival) are left out of the ranking and listed in meta.query.family; include_family=true ranks them in, flagged same_estate. params: slug*, limit, include_family, context |
find_similar_apis | APIs similar to a given one ("more like this") by shared tags. params: aid*, limit, context |
get_industry_leaders | UNDERSTANDING — Top-rated providers in an industry vertical. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, limit, context |
get_region_leaders | UNDERSTANDING — Top-rated providers in a region. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, limit, context |
get_country_leaders | UNDERSTANDING — Top-rated providers in one country. Membership is derived and partial, so read the ranking as "the best of what we have placed there", not a national league table. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, limit, context |
get_area_leaders | UNDERSTANDING — Top-rated providers in a curated API Evangelist area. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, limit, context |
get_rating_history | UNDERSTANDING — A provider's REAL score time series: one point per scored build (composite + agent readiness on each date), plus a summary of the movement over the window — first/last, net change, direction, and the largest single-build jump with the date it happened. Not an implied previous point; these are the recorded snapshots. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as- params: slug*, context |
find_rating_movers | UNDERSTANDING — The biggest rating movers (up and down) since the previous scoring build. Priced per result — $0.005 per request plus $0.0002 per record returned (less past 100), capped at $0.50 a request, under pay-as-you-go; included in Understanding and Influence. Estimate first at /api/v1/prices/estimate. See apis://prices. params: limit, context |
story_leads | OWNER — The weekly "what's worth writing" rollup: ranked story leads from the demand map crossed with rating movement — unmet demand (searched, no result), risers/fallers, and hot-but-thin capabilities. Each lead is a headline, its signal, and a suggested angle. include=["raw"] appends the underlying demand report. Not purchasable: owner-only, at any price. params: include, context |
what_can_i_fix | INFLUENCE — the ranked, gated punch list for one provider you own. Every agent-readiness check with points still on the table (exact — these are real per-check results, each with what satisfies it), plus the Kin Score facets ranked by weight x headroom rather than by lowest score. `do_first` is the headline and prefers a BAND GATE over any amount of points, because points cannot clear a gate. Use params: slug*, context |
readiness_gates | INFLUENCE — what blocks the next agent-readiness band, GATES BEFORE POINTS. Some bands are unreachable on score alone: agent-native requires idempotency AND a stable error envelope regardless of how many points a provider collects. Returns the points gap and the unmet gate requirements separately, each priced, plus a verdict saying whether clearing the gate also closes the gap — the case a points- params: slug*, context |
simulate_fixes | INFLUENCE — project a set of fixes onto a provider's agent-readiness score and band before doing the work. Re-applies the band gate to the PROJECTED state, so it will tell you when buying points still leaves you demoted. Kin Score facets are refused rather than estimated: several checks behind them are count-based across a provider's APIs, so a single claimed fix has no computable composite value. params: slug*, fixes*, context |
claim_listing | INFLUENCE — ask to claim a listing as yours. Returns 202 with a token and the hosts it will be checked against: publish it as a DNS TXT record, or as a file at /.well-known/apis-io-challenge, and leave it up. A PERSON verifies it and emails you — there is nothing else to call. Track it with check_status. Priced B4 (human work) — worked by a person, no charge. See apis://prices. params: slug*, context |
generate_artifact | INFLUENCE — REQUEST an artifact you are being marked down for not having: apis-json, agent-card, mcp (one tool per operation you already publish), arazzo, rules (a Spectral ruleset scoped to your own failing checks), scopes and security (read out of your own OpenAPI). Returns 202 — a person generates it against your live surface, checks it, and sends it to you. Nothing is published on your behalf params: slug*, artifact, context |
submit_artifact | INFLUENCE — tell us about an artifact you publish, rather than waiting for us to find it. Returns 202; a person fetches it, checks it and re-runs the pipeline against it. Track it with check_status. Priced B4 (human work) — included in Influence; otherwise $49.00 as a one-off with its own receipt, never from a prepaid balance. If this is your own company and our data about it is wrong, report_corr params: slug*, type*, url*, contact, context |
correct_facts | INFLUENCE — propose corrections to what we say about you: name, description, url, industries, tags. Returns 202 and is applied by a person — an API that let an owner rewrite their own description unreviewed would be a marketing surface, not a catalog. Score and band are not owner-settable and are ignored. Priced B4 (human work) — included in Influence; otherwise $49.00 as a one-off with its own re params: slug*, name, description, url, industries, tags, contact, context |
dispute_finding | INFLUENCE — "you say we lack X, here it is." Send the claim in words and a URL that evidences it. Returns 202; a person fetches your evidence, checks it against what we hold, and emails you either way. Open to any paying caller — you should not have to prove ownership before you can tell us our data is wrong. Priced B4 (human work) — included in Influence; otherwise $49.00 as a one-off with its ow params: slug*, claim*, evidence_url, contact, context |
set_visibility | INFLUENCE — ask to be shown less, or not at all. `restricted` keeps a name, a description and a link to your own site, unrated and out of every ranked view; `delisted` removes you entirely. Returns 202 and is applied by a person: it strips artifacts, pages and rollups across the network, which is not something to do irreversibly on one API call. Priced B4 (human work) — worked by a person, no char params: slug*, visibility*, reason, contact, context |
watch_listing | INFLUENCE — be told when a listing you care about moves: score changes, band changes, agent-band changes, or a check closing. REQUIRES a destination: `contact` (an email address), `callback_url` (an https endpoint that receives signed JSON), or both. The first pass after registering records where the provider stands and sends nothing, so the first notification you get is about a real move. `agent_ params: slug*, events, contact, callback_url, context |
list_watches | INFLUENCE — the listings you are watching, with the events registered for each and when you started. The read half of watch_listing: call it before registering another, so you neither duplicate a watch nor assume one is in place that never took. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: context |
unwatch_listing | INFLUENCE — stop watching a listing. Takes effect immediately and removes the registration outright; there is no paused state. Removing a watch that was never registered is not an error. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, context |
request_check | INFLUENCE — ask APIs.io to (re)check something. Use it when a listing is wrong or stale, when a score looks incorrect, or to get a company profiled that is not in the catalog yet. A check can target a PROVIDER (the default) or a slice of the catalog: an `industry`, a `tag`, an `area`, or a company's `estate` — for an industry roster missing an obvious member, a tag that has drifted, or an area who params: target_type, slug, url, kind, contact, notes, context |
check_status | INFLUENCE — the status of a check request by id: queued, in_review, running, done, rejected or needs_info, with any notes shared by the reviewer. The id identifies the request, but the Influence plan is now required to read it back. To report an error for free, use report_correction or open an issue on the provider's api-evangelist repo. Priced B1 (single-entity synthesis) — $0.01 per call under p params: id*, context |
find_agents | FREE, no account — the A2A agent registry: agents that registered THEMSELVES by serving an agent card and calling register_agent. Each row carries the card URL, the operator, and the last verification of the card (grade, protocol version, transport). This is the door an unattended agent can walk through unaided; the others need a person or a voucher. params: page, limit, context |
register_agent | FREE, no account — register yourself in the A2A agent registry. Serve an agent card at /.well-known/agent-card.json on a host you control, then call this with its URL (or just the host). The card must be fetchable and pass the three A2A 1.0.0 hard checks: capabilities is an object, protocolVersion is present, skills is an array. 202 queues it for review; 422 says exactly which check failed. The ca params: card_url*, operator, contact, role, context |
report_gap | FREE, no account — tell the catalog what you looked for and could not find. The consumer door (roadmap#166): a gap report is how the catalog learns what to add next, and a person reads the queue. One required field. params: looked_for*, needed_for, found, provider, contact, context |
my_checks | INFLUENCE — the check requests you filed, newest first. Requires a key or login — an anonymous caller has no identity to scope a list to, and should read a single request with check_status instead. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: context |
export_dataset | LICENCE (sold on the Influence plan) — the WHOLE dataset, not a 100-row page: `ratings` (every rated provider with facets, trend, rubric + provenance), `providers` (the catalog with coverage + score), or `history` (every provider's full score time series — parallel date/composite/agent_readiness arrays across every scored build the catalog retains, with a movement summary per provider). `history` params: dataset, cursor, co_brand, context |
industry_gap_analysis | UNDERSTANDING — Valuable artifact types (MCP, Arazzo, Rules, Skills…) commonly missing across a whole industry — where the vertical is under-served. Priced B2 (cross-catalog synthesis) — $0.05 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, min_share, context |
export_stack | UNDERSTANDING — Export a designed capability stack as an adoptable APIs.json document (with an Arazzo hint) the team can commit. Priced B3 (bulk export) — $0.002 per row, $0.50 minimum per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: capabilities*, region, context |
insights_overview | UNDERSTANDING — the Insights root: how many companies are profiled, over how many quarters, and the top investment dimensions across the whole set. Read this FIRST — it tells you the size and vintage of the corpus before you draw a conclusion from any single company in it. Priced B2 (cross-catalog synthesis) — $0.05 per call under pay-as-you-go; included in Understanding and Influence. See apis:// params: context |
find_company_insights | Browse profiled companies (Fortune 1000) by name or industry; ranked by overall technology-readiness signal. `industry` takes an insights industry NAME from insights_industries (e.g. "Industrial") — a different vocabulary from the catalog industry slugs find_providers uses — and matches every roster a company sits on, not just its primary. Understanding plan. Priced per result — $0.005 per request params: q, industry, page, limit, context |
insights_dimensions | Cross-section ranking of the 40 tracked investment dimensions (AI, cloud, governance, security, …) by how many profiled companies show signal. Understanding plan. Priced B2 (cross-catalog synthesis) — $0.05 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: page, limit, context |
insights_adoption | Services, tools, or standards ranked by how many companies adopt them across the profiled set. Understanding plan. Priced B2 (cross-catalog synthesis) — $0.05 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: type, page, limit, context |
insights_industries | UNDERSTANDING — the demand-side industry rollup: the sectors the profiled companies fall into. Each row carries TWO counts and they answer different questions: `company_count` is the research roster, `profiled_count` is how many of those you can actually read back via find_company_insights(industry:) — size a cohort on profiled_count. The counterpart to find_industries, which counts SUPPLY (provid params: page, limit, context |
get_company_insight | UNDERSTANDING — Full demand-side profile for one company: 40-dimension readiness scores, adopted stack, and per-quarter history. Priced B2 (cross-catalog synthesis) — $0.05 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, context |
company_gaps | UNDERSTANDING — A company's weakest investment dimensions — where it is thin and a vendor could sell in. Priced B2 (cross-catalog synthesis) — $0.05 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, context |
match_providers | UNDERSTANDING — The supply↔demand join: apis.io providers whose product appears in a company's adopted stack, ranked by rating. Priced B2 (cross-catalog synthesis) — $0.05 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, context |
find_vcs | UNDERSTANDING — Find venture-capital firms by name, thesis tags, or category. Each carries a network-matched, rated portfolio graph. Sort by portfolio_on_network (default), portfolio_total, portfolio_rating, or name. Understanding plan. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: q, tags, category, sort, page, limit, context |
get_vc | UNDERSTANDING — One VC firm: identity, fund facts, and portfolio summary (totals, band distribution, average rating). Pass view=full to inline the whole portfolio. Understanding plan. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, view, context |
vc_portfolio | UNDERSTANDING — A VC firm's portfolio companies, each matched to the network and rated. Filter publishes_api=true (companies that actually ship an API — about 37% of any book), in_network=true, band, or min_score; sort by score (default), api_count, or name. The demand-side view of who a fund has backed. Understanding plan. Priced per result — $0.005 per request plus $0.0002 per record returned (l params: slug*, publishes_api, is_provider, in_network, band, min_score, sort, page, limit, context |
find_investors | UNDERSTANDING — The reverse portfolio edge: which VC firms in the network back a given provider/company (by slug). The investor COUNT is free; the named firms need Understanding. Priced B2 (cross-catalog synthesis) — $0.05 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: slug*, context |
resolve | Resolve ANY identifier — website URL, domain (stripe.com), or GitHub org (github.com/stripe) — to the apis.io provider it belongs to. Use this when you have a URL, not a slug. Understanding plan. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: identifier*, context |
enrich_provider | One call, pick your field groups — resolves a slug OR any identifier and returns exactly the groups you ask for, instead of chaining get_provider + get_provider_rating + get_provider_artifacts + get_provider_onboarding. Groups: profile, onboarding, artifacts, rating, insights. Understanding plan — the base groups moved with the rest of the discovery layer on 2026-08-31. Priced B2 (cross-catalog sy params: id*, fields, context |
save_search | UNDERSTANDING — Persist the current search criteria as a named saved search you own, so you can re-run it and get net-new results later. Criteria use the same filters as apis_io_search. Requires an apis.io API key. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: name*, q, tags, band, industry, region, area, artifact_types, match, min_score, context |
my_workspace | UNDERSTANDING — the workspace root: which plan you are on, how many saved searches and lists you hold, and where each lives. Answers "what do I have here and what can I afford" in one call, so an agent need not probe. NOT the same as the account (login, API key, usage, billing), which is https://apis.io/api/v1/auth/me. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; inclu params: context |
list_saved_searches | UNDERSTANDING — List the saved searches you own (name, criteria, when last run, how many matches are tracked). Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: context |
run_saved_search | UNDERSTANDING — Re-run one of your saved searches against the live catalog and return current matching providers. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: id*, limit, context |
saved_search_net_new | UNDERSTANDING — What is NEW for a saved search since you last checked: providers that newly match your criteria. Advances the delta cursor, so each call reports only what changed since the previous call. The agent-native version of the demand report. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: id*, context |
delete_saved_search | UNDERSTANDING — Delete a saved search you own. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: id*, context |
create_list | UNDERSTANDING — Create a named, persistent list (a shortlist / stack you own) of providers or APIs. Requires an apis.io API key. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: name*, members, context |
list_lists | UNDERSTANDING — List the lists/shortlists you own. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: context |
get_list | UNDERSTANDING — Get a list you own, with each member resolved to its current name, band, and score. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: id*, context |
add_to_list | UNDERSTANDING — Add providers/APIs (by slug or aid) to one of your lists. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: id*, members*, context |
delete_list | UNDERSTANDING — Delete a list you own. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: id*, context |
find_openapis | OpenAPI specifications across the catalog. The REST contract. get_openapi returns one API's primary spec with optional inlined body. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, context |
find_asyncapis | AsyncAPI (event-driven) specifications across the catalog. Event/streaming APIs. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, version, info_version, context |
find_channels | AsyncAPI event channels across the catalog. Individual event channels (topics/streams). Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, protocol, version, context |
find_graphql | GraphQL schemas across the catalog. GraphQL type systems. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, context |
find_arazzo | Arazzo workflows across the catalog. Multi-step API workflows chaining operations. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, context |
find_mcp | MCP servers across the catalog. Model Context Protocol servers a provider offers to agents. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, install_method, context |
find_skills | Agent Skills across the catalog. Packaged agent skills. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, context |
find_rules | Spectral governance rulesets across the catalog. API design/linting rulesets. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, context |
find_overlays | OpenAPI Overlays across the catalog. Documents applied on top of an API contract to add or change what it says. meta says who wrote it (authorship: provider / derived / generated / unmarked), whether the provider hosts it (provider_hosted — the only kind the Kin Score credits), what the actions touch (purpose), the action counts and the contract it extends. Filter by q / tags / providers; include= params: q, tags, providers, match, include, page, limit, sort, authorship, purpose, context |
find_scopes | OAuth scope catalogs across the catalog. The OAuth scopes an API defines. Understanding plan. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: q, tags, providers, match, include, page, limit, sort, context |
find_security | Security artifacts across the catalog. Authentication, domain security, VDP, trust center. Understanding plan. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. Priced B1 (single-entity synthesis) — $0.01 per call under pay-as-you-go; included in Understanding and Influence. See apis://prices. params: q, tags, providers, match, include, page, limit, sort, context |
find_plans | Pricing plans across the catalog. An API's pricing tiers. meta says who wrote the file (method), when it was read (provenance_date), who the page prices for (audience), how (pricing_basis), and whether a price is stale. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, audience, pricing_basis, method, context |
find_rate_limits | Rate-limit policies across the catalog. Declared throttling policies. meta carries method, provenance_date, the exhaustion status and the response headers that signal limit state. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, method, context |
find_finops | FinOps / billing models across the catalog. How usage is metered and billed. meta carries the billing model (pricing category), method, provenance_date, primary_unit (what the provider bills by) and `template: true` on sweep output that restates the FinOps framework without a unit, meters or a pricing category. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts params: q, tags, providers, match, include, page, limit, sort, billing_model, method, context |
find_collections | Postman / Open collections across the catalog. Runnable request collections. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, context |
find_json_ld | JSON-LD contexts across the catalog. Linked-data vocabularies. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, context |
find_json_schemas | JSON Schemas across the catalog. Standalone data schemas. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, context |
find_json_structures | JSON Structures across the catalog. Data structures behind an API. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, struct_type, context |
find_examples | Example payloads across the catalog. Real request/response examples. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, context |
find_postman | Postman collections across the catalog. Postman-format collections (by reference). Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, context |
find_apis_json | APIs.json indexes across the catalog. The APIs.json discovery documents themselves. Filter by q / tags / providers; include=["content"] inlines bodies. Use find_artifacts for cross-type search. params: q, tags, providers, match, include, page, limit, sort, context |
submit_feedback | Report something wrong with a result: wrong data, a filter that did not filter, a ranking that put off-topic results first, a number you could not reproduce, or an answer that was useless for your task. Free, and the fastest way to get a defect fixed — this is read by a human. Say what you expected as well as what you got. params: problem*, expected, about, tool, severity, context |
report_correction | Report that the catalog has a provider WRONG — a wrong website, a wrong logo, APIs that are not theirs, a count that does not match what they ship, a score computed from any of those. Free, always: correcting our own error is never a paid feature. Read by a human. If you are the provider, say so — it does not gate anything, it tells us how fast to move. params: slug*, wrong*, correct, evidence, field, relationship, context |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.