Added value: +{
+  "type": "boolean"
+}

Added value: +{
+  "type": "boolean"
+}

Previous value: -"true = the provider has operations that ACT (create/update/send), so you can push something to it; false = measured and read-only. Use this when the question is \"where can I publish/send/post to\" — text search cannot tell direction, and without it a query about syndicating content returns RSS feeds and read-only APIs. Providers with no agentic-access reading are excluded either way: absent is unmeasured, not zero."New value: +"true = has write operations; false = read-only."

Previous value: -"Providers that publish an API, spec or OPERATION carrying these tags, without claiming it as their business. The complement of `tags`, and disjoint from it."New value: +"Tags on its APIs, e.g. [\"webhook\"]."

Previous value: -"Area slugs, as find_areas returns them, e.g. [\"security\"]."New value: +"Area slugs, e.g. [\"security\"]."

Previous value: -"Artifact types an API must carry, e.g. [\"OpenAPI\",\"AsyncAPI\",\"Postman\"]. Synonyms fold (MCPServer = MCP)."New value: +"Artifact types required, e.g. [\"OpenAPI\"]."

Previous value: -"Rating bands: exemplar, strong, developing, thin, minimal."New value: +"exemplar | strong | developing | thin | minimal."

Previous value: -"Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."New value: +"Optional: one sentence on why you are asking. Never used to rank; read only if a result is wrong."

Previous value: -"Providers whose derived country membership includes these slugs (e.g. united-kingdom). Membership is partial — a count is a floor."New value: +"Country slugs, e.g. [\"united-kingdom\"]."

Previous value: -"Company size band(s), comma-separated: 1-10 | 11-50 | 51-200 | 201-1000 | 1001-5000 | 5000+ | 1000+ (the last is the open-ended band the inferred rung emits when it can tell \"big\" but not how big). ESTIMATES from free public sources — Wikidata, SEC EDGAR, the provider's own About page, our own signals — never a headcount. Understanding plan."New value: +"Size band(s), e.g. \"1-10,11-50\"."

Previous value: -"Quality facet to threshold on: discoverability, contract_quality, governance, operational_transparency, developer_ergonomics, commercial_clarity. Needs min_facet."New value: +"Facet, e.g. governance; needs min_facet."

Previous value: -"Return exactly these top-level keys (overrides view)."New value: +"Only these top-level keys, e.g. [\"slug\",\"score\"]."

Previous value: -"estate = rank each corporate estate ONCE: keep the best-ranked member of each estate root (Cvent, Oracle, Amazon) in the order applied, and nest the other members of that estate found in this result set under it as `estate_members`, with `estate_member_count`. Rows outside any estate are unaffected. meta.query.ungrouped_total is the flat count. Off by default; every row carries `estate` and `estate_root` either way."New value: +"estate: one row per estate."

Previous value: -"With `tags`: also return the members of each tag's CURATED narrower tags (the `narrower` list on get_tag — Payments under Fintech), after the tag's own members. Each added row carries `via: <narrower-tag>`. Off by default, and provider_count on the tag stays the tag's own membership; provider_count_with_narrower is this total. On a tag with senses (payments, media, supply-chain), every row is routed into a sense: it carries `sense: <tag>:<id>`, meta.query.senses counts own and added members per sense, and `sense=<tag>:<id>` with include_narrower=true (REST) reads one routed sense."New value: +"With `tags`: add narrower-tag members."

Previous value: -"Industry slugs, as find_industries returns them, e.g. [\"artificial-intelligence\"]."New value: +"Industry slugs, e.g. [\"fintech\"]."

Previous value: -"How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."New value: +"How `tags` combine: any (default) or all."

Previous value: -"Only providers at or below this composite. Pair with min_score for a band-free range."New value: +"Maximum composite, e.g. 60."

Previous value: -"Minimum number of acting (non-read) operations. Use to require real write depth rather than a single write endpoint."New value: +"Minimum write operations, e.g. 5."

Previous value: -"Minimum score on `facet`. Without `facet` this does nothing."New value: +"Minimum `facet` score, e.g. 70."

Previous value: -"Only providers whose Kin Score composite is at or above this, 0-100, e.g. 60."New value: +"Minimum Kin Score composite (0-100), e.g. 60."

Previous value: -"Access model — how to start: open (no key), self-serve, approval. (providers only)"New value: +"open (no key) | self-serve | approval."

Previous value: -"Page number, 1-based (default 1). Use with `limit` to walk a long list."New value: +"Page number, 1-based (default 1)."

Previous value: -"Providers running on these platform vendors, by registry key or catalog slug (mintlify, readme, gitbook, redocly, apigee, kong, cloudflare, vercel…). \"Who are Mintlify's customers\" = platform=mintlify; \"who runs on a competitor\" = platform=readme. Each row carries `platforms` with the evidence. Detection covers ~1,240 providers — absent means not detected, not \"none\"."New value: +"Vendor slugs, e.g. [\"mintlify\"]."

Previous value: -"Narrow `platform` (or all detected platforms) to one area: documentation, developer-portal, api-gateway, hosting, cdn, status-page, support, identity, mcp-hosting."New value: +"Platform area, e.g. hosting."

Previous value: -"Access model — pricing: free, freemium, free-trial, paid, enterprise. (providers only)"New value: +"free | freemium | free-trial | paid | enterprise, e.g. [\"free\"]."

Previous value: -"Provider slugs to restrict results to, e.g. [\"stripe\",\"adyen\"]."New value: +"Provider slugs, e.g. [\"stripe\"]."

Previous value: -"Only providers callable publicly with no signup (onboarding=open). (providers only)"New value: +"Callable with no signup (onboarding=open)."

Previous value: -"true = the provider publishes at least one API (api_count > 0), including partner-gated APIs whose shape API Evangelist modeled; false = it publishes none. Product areas marked as not an API (unpublished_api_count) are not counted, so a company whose every entry is one reads false."New value: +"true = publishes an API."

Previous value: -"Free text over name + description."New value: +"Free text over name + description, e.g. \"sms\"."

Previous value: -"Region slugs, as find_regions returns them, e.g. [\"north-america\"]."New value: +"Region slugs, e.g. [\"north-america\"]."

Previous value: -"When `q` exactly names a tag, apis.io uses it: on PROVIDERS a resource tag (order, webhook, image) replaces the text search with the companies that classify themselves there — 2,182 text matches for \"order\" become the 92 that claim it; on APIS the tag's members are ADDED to the text matches, never swapped for them. Market tags (payments) and tags almost no company claims are reported and not applied. Set `off` for pure text. The resolution is always echoed as `resolved_tag`."New value: +"on (default) uses a tag `q` names; off = text only."

Previous value: -"Revenue band(s): <$1M | $1-10M | $10-100M | $100M-1B | $1B+. Estimates; filed where size_basis is sec-edgar or companies-house. Understanding plan."New value: +"Revenue band(s), e.g. \"$1-10M\"."

Previous value: -"Which rung produced the band: sec-edgar | companies-house | wikidata | editorial | derived | inferred | unknown. Ask for the filed ones when you need a defensible number. Understanding plan."New value: +"Size source, e.g. sec-edgar."

Previous value: -"probed | unprobed. USE size_status=probed when filtering for small companies: without it, \"not enterprise\" sweeps in every provider we have not looked at yet and counts them as small. Absence of a band is not a measurement. Understanding plan."New value: +"probed | unprobed (use probed for small firms)."

Previous value: -"Order results. Default: relevance with a query, composite (quality) when browsing. `demand` = Fortune-1000 adoption, scoped to the query."New value: +"Default: relevance with `q`, else composite."

Previous value: -"Tag slugs. On PROVIDERS this is identity — what the company says it does, from its own apis.yml. A resource or operation term (webhook, saml, order, oai-pmh) will correctly match no provider; use find_apis?tags= for those, or find_providers?api_tags= to reach companies whose APIs merely touch it."New value: +"Tag slugs, e.g. [\"payments\"]. On providers: what the company does (see api_tags)."

Previous value: -"up | down | flat — direction of the composite since the previous scoring pass."New value: +"up | down | flat since last scoring."

Previous value: -"Only providers a developer can start using at no cost right now (free/trial + self-serve/open). (providers only)"New value: +"Usable at no cost right now (free/trial + self-serve/open)."

Previous value: -"summary (default) returns lean discovery records + *_count for dropped sections; full returns the whole record (use get_api / get_provider for one entity)."New value: +"summary (default, lean) or full."

Added value: +"Area slugs, as find_areas returns them, e.g. [\"security\"]."

Added value: +"Artifact types an API must carry, e.g. [\"OpenAPI\",\"AsyncAPI\",\"Postman\"]. Synonyms fold (MCPServer = MCP)."

Added value: +"Industry slugs, as find_industries returns them, e.g. [\"artificial-intelligence\"]."

Added value: +"Results per page, 1-100 (default 25)."

Added value: +"How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."

Added value: +"Only providers whose Kin Score composite is at or above this, 0-100, e.g. 60."

Added value: +"Page number, 1-based (default 1). Use with `limit` to walk a long list."

Added value: +"Provider slugs to restrict results to, e.g. [\"stripe\",\"adyen\"]."

Added value: +"Region slugs, as find_regions returns them, e.g. [\"north-america\"]."

Added value: +{
+  "description": "true = the provider publishes at least one API (api_count > 0), including partner-gated APIs whose shape API Evangelist modeled; false = it publishes none. Product areas marked as not an API (unpublished_api_count) are not counted, so a company whose every entry is one reads false.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "estate = rank each corporate estate ONCE: keep the best-ranked member of each estate root (Cvent, Oracle, Amazon) in the order applied, and nest the other members of that estate found in this result set under it as `estate_members`, with `estate_member_count`. Rows outside any estate are unaffected. meta.query.ungrouped_total is the flat count. Off by default; every row carries `estate` and `estate_root` either way.",
+  "enum": [
+    "estate"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "With `tags`: also return the members of each tag's CURATED narrower tags (the `narrower` list on get_tag — Payments under Fintech), after the tag's own members. Each added row carries `via: <narrower-tag>`. Off by default, and provider_count on the tag stays the tag's own membership; provider_count_with_narrower is this total. On a tag with senses (payments, media, supply-chain), every row is routed into a sense: it carries `sense: <tag>:<id>`, meta.query.senses counts own and added members per sense, and `sense=<tag>:<id>` with include_narrower=true (REST) reads one routed sense.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Providers running on these platform vendors, by registry key or catalog slug (mintlify, readme, gitbook, redocly, apigee, kong, cloudflare, vercel…). \"Who are Mintlify's customers\" = platform=mintlify; \"who runs on a competitor\" = platform=readme. Each row carries `platforms` with the evidence. Detection covers ~1,240 providers — absent means not detected, not \"none\".",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Narrow `platform` (or all detected platforms) to one area: documentation, developer-portal, api-gateway, hosting, cdn, status-page, support, identity, mcp-hosting.",
+  "type": "string"
+}

Added value: +{
+  "description": "Company size band(s), comma-separated: 1-10 | 11-50 | 51-200 | 201-1000 | 1001-5000 | 5000+ | 1000+ (the last is the open-ended band the inferred rung emits when it can tell \"big\" but not how big). ESTIMATES from free public sources — Wikidata, SEC EDGAR, the provider's own About page, our own signals — never a headcount. Understanding plan.",
+  "type": "string"
+}

Added value: +{
+  "description": "Revenue band(s): <$1M | $1-10M | $10-100M | $100M-1B | $1B+. Estimates; filed where size_basis is sec-edgar or companies-house. Understanding plan.",
+  "type": "string"
+}

Added value: +{
+  "description": "Which rung produced the band: sec-edgar | companies-house | wikidata | editorial | derived | inferred | unknown. Ask for the filed ones when you need a defensible number. Understanding plan.",
+  "type": "string"
+}

Added value: +{
+  "description": "probed | unprobed. USE size_status=probed when filtering for small companies: without it, \"not enterprise\" sweeps in every provider we have not looked at yet and counts them as small. Absence of a band is not a measurement. Understanding plan.",
+  "type": "string"
+}

Previous value: -"Tag slugs. On PROVIDERS this is identity — what the company says it does, from its own apis.yml. A resource or operation term (webhook, saml, order, oai-pmh) will correctly match no provider; use find_apis?tags= for those, or api_tags below."New value: +"Tag slugs. On PROVIDERS this is identity — what the company says it does, from its own apis.yml. A resource or operation term (webhook, saml, order, oai-pmh) will correctly match no provider; use find_apis?tags= for those, or find_providers?api_tags= to reach companies whose APIs merely touch it."

Added value: +{
+  "default": "on",
+  "description": "When `q` exactly names a tag, apis.io uses it: on PROVIDERS a resource tag (order, webhook, image) replaces the text search with the companies that classify themselves there — 2,182 text matches for \"order\" become the 92 that claim it; on APIS the tag's members are ADDED to the text matches, never swapped for them. Market tags (payments) and tags almost no company claims are reported and not applied. Set `off` for pure text. The resolution is always echoed as `resolved_tag`.",
+  "enum": [
+    "on",
+    "off"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Providers whose derived country membership includes these slugs (e.g. united-kingdom). Membership is partial — a count is a floor.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Quality facet to threshold on: discoverability, contract_quality, governance, operational_transparency, developer_ergonomics, commercial_clarity. Needs min_facet.",
+  "type": "string"
+}

Added value: +{
+  "description": "Only providers at or below this composite. Pair with min_score for a band-free range.",
+  "type": "number"
+}

Added value: +{
+  "description": "Minimum score on `facet`. Without `facet` this does nothing.",
+  "type": "number"
+}

Added value: +{
+  "description": "up | down | flat — direction of the composite since the previous scoring pass.",
+  "type": "string"
+}

Added value: +{
+  "description": "true = the provider has operations that ACT (create/update/send), so you can push something to it; false = measured and read-only. Use this when the question is \"where can I publish/send/post to\" — text search cannot tell direction, and without it a query about syndicating content returns RSS feeds and read-only APIs. Providers with no agentic-access reading are excluded either way: absent is unmeasured, not zero.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Minimum number of acting (non-read) operations. Use to require real write depth rather than a single write endpoint.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Providers that publish an API, spec or OPERATION carrying these tags, without claiming it as their business. The complement of `tags`, and disjoint from it.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Tag slugs."New value: +"Tag slugs. On PROVIDERS this is identity — what the company says it does, from its own apis.yml. A resource or operation term (webhook, saml, order, oai-pmh) will correctly match no provider; use find_apis?tags= for those, or api_tags below."

Added value: +{
+  "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable.",
+  "type": "string"
+}

Added value: +{
+  "description": "Access model — how to start: open (no key), self-serve, approval. (providers only)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Access model — pricing: free, freemium, free-trial, paid, enterprise. (providers only)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Only providers callable publicly with no signup (onboarding=open). (providers only)",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Only providers a developer can start using at no cost right now (free/trial + self-serve/open). (providers only)",
+  "type": "boolean"
+}

Added value: +"Return exactly these top-level keys (overrides view)."

Added value: +"Order results. Default: relevance with a query, composite (quality) when browsing. `demand` = Fortune-1000 adoption, scoped to the query."

Added value: +[
+  "relevance",
+  "composite",
+  "name",
+  "created",
+  "modified",
+  "api_count",
+  "demand"
+]

Added value: +{
+  "default": "summary",
+  "description": "summary (default) returns lean discovery records + *_count for dropped sections; full returns the whole record (use get_api / get_provider for one entity).",
+  "enum": [
+    "summary",
+    "full"
+  ],
+  "type": "string"
+}

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}