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: -"How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."New value: +"How `tags` combine: any (default) or all."

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: -"Provider slugs to restrict results to, e.g. [\"stripe\",\"adyen\"]."New value: +"Provider slugs, e.g. [\"stripe\"]."

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

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)."

Added value: +"Pass [\"content\"] to inline each artifact's body instead of just its URL."

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: +"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: +{
+  "description": "Who the pricing page prices for: \"developer-api\" (API or platform usage), \"business-product\" (the product the API comes with), \"consumer\" (a fee schedule), \"unclear\".",
+  "type": "string"
+}

Added value: +{
+  "description": "Who wrote the file: \"searched\" (transcribed from the provider's page), \"probed\" (read live), \"generated\" (API Evangelist sweep, unverified), \"unmarked\".",
+  "type": "string"
+}

Added value: +{
+  "description": "How it is priced: \"per-call\", \"per-seat\", \"ad-valorem\", \"flat-platform\", \"tiered-subscription\", \"usage-other\", \"negotiated\", \"free\", \"none\".",
+  "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."

Previous value: -"Order: name, or plan_count (largest first)."New value: +"Order: relevance / provider / name, or plan_count (largest first)."

Previous value: -[
-  "name",
-  "plan_count"
-]New value: +[
+  "relevance",
+  "provider",
+  "name",
+  "plan_count"
+]

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"
+}