`x-guidance` appears in the info block and on operations. Its value is a string. Used by 25 providers across 56 OpenAPI documents. Observed values include `POST a small JSON body (see each operation''s requestBody) with no`, `Call this once per website to order directory submissions. Save the submissionid`, `Send a query that is either a plain IP address (like 8.8.8.8) or an ASN referenc`, `Call this when a user asks whether a domain's email logo (BIMI) setup will work,`. Consistent with data & schema semantics — this is inferred from where the key appears and what it carries, not from any published definition.
Data & schema semanticsderived description
How this description was produced. It is assembled from what was
measured in the corpus — where this key appears in a document, what shape its value
takes, the values observed, and how many providers use it. It is not taken
from a published definition, because for most extensions none exists. Read it as
evidence, not as a specification. If you own this extension and want it described
properly, tell us.
84 occurrences
56 documents
25 providers
purpose-named
Where it appears
Location in the document
Occurrences
info
56
operation
28
What its value looks like
Value shape
Occurrences
string
81
object
3
Observed values
Sampled from the specifications, most frequent first.
POST a small JSON body (see each operation''s requestBody) with noCall this once per website to order directory submissions. Save the submissionidSend a query that is either a plain IP address (like 8.8.8.8) or an ASN referencCall this when a user asks whether a domain's email logo (BIMI) setup will work,POST a JSON body with a required 'url' field (the endpoint to probe) and an optiSend an empty body for the newest available inflation report. Send 'period' as YSend a JSON body with a 'url' (required, must start with http:// or https://) anCall this endpoint with POST and a JSON body containing a ''domains'' array of b
Extensions exist because a provider needed something the specification would not
carry. Most of what they hold is not the API contract at all — it is operational
metadata about the contract: documentation, lifecycle, policy, provenance,
and now agents. That metadata is usually better placed alongside the contract, in an
Overlay or an
APIs.json index, than crammed inside it.
See everything else doing the
data & schema semantics job.
Every extension here is available over the APIs.io API and to AI agents over MCP. OpenAPI Extensions is not yet its own endpoint on the v1 API. Reach it through catalog search and the tag graph, or the MCP server.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for openapi extensions
3 MCP tools reach this
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.