# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for APIs.io Providers API version: 1.0.0 extends: openapi/apis-io-providers-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 10 - target: $.paths['/providers'].get update: x-apievangelist-phrasing: intent: Browse and filter API providers effect: read questions: - Which providers are tagged payments and publish an OpenAPI? - Can I filter providers by band, score range or trend? - Which providers score above 80 on a single facet? instructions: - text: List providers tagged {tags}. slots: tags: query.tags - text: Show providers in {region} with a composite score between {min_score} and {max_score}. slots: region: query.region min_score: query.min_score max_score: query.max_score - text: Find providers whose {facet} facet is at least {min_facet}. slots: facet: query.facet min_facet: query.min_facet method: generated generated: '2026-09-26' - target: $.paths['/providers/{slug}'].get update: x-apievangelist-phrasing: intent: Get one provider's profile effect: read questions: - What does the catalog know about a single provider, including its links and APIs? - Can I get just a few fields of one provider's profile? instructions: - text: Get the provider profile for {slug}. slots: slug: path.slug - text: Fetch {fields} for provider {slug}. slots: fields: query.fields slug: path.slug method: generated generated: '2026-09-26' - target: $.paths['/providers/{slug}/apis'].get update: x-apievangelist-phrasing: intent: List the APIs a provider publishes effect: read questions: - What APIs does a given provider publish? - Can I list only a provider's APIs that have an AsyncAPI? instructions: - text: List the APIs published by {slug}. slots: slug: path.slug - text: Show {slug}'s APIs tagged {tags}. slots: slug: path.slug tags: query.tags method: generated generated: '2026-09-26' - target: $.paths['/providers/{slug}/artifacts'].get update: x-apievangelist-phrasing: intent: Get every artifact a provider publishes effect: read questions: - What artifacts does a provider publish across all its APIs, in one call? - Does a provider have an Arazzo or pricing artifact anywhere in its APIs? instructions: - text: Get every artifact {slug} publishes, grouped by type. slots: slug: path.slug - text: Aggregate all artifacts across {slug}'s APIs. slots: slug: path.slug method: generated generated: '2026-09-26' - target: $.paths['/providers/{slug}/onboarding'].get update: x-apievangelist-phrasing: intent: Get a provider's getting-started details effect: read questions: - 'How do I get started with a provider: signup, docs, auth and base URLs?' - Where is a provider's developer portal and signup page? instructions: - text: Show the getting-started view for {slug}. slots: slug: path.slug - text: Get the signup, docs and base URLs for {slug}. slots: slug: path.slug method: generated generated: '2026-09-26' - target: $.paths['/providers/{slug}/similar'].get update: x-apievangelist-phrasing: intent: Find alternatives to a provider effect: read questions: - What alternatives exist to a provider I'm evaluating? - Which providers overlap most with one in tags, industry and region? instructions: - text: Find providers similar to {slug}. slots: slug: path.slug - text: Show {limit} alternatives to {slug}. slots: limit: query.limit slug: path.slug method: generated generated: '2026-09-26' - target: $.paths['/providers/{slug}/capabilities'].get update: x-apievangelist-phrasing: intent: Count what a provider publishes effect: read questions: - How many of each artifact type does a provider publish? - Which agent dimensions does a provider's public surface satisfy? instructions: - text: Count what {slug} publishes by artifact type. slots: slug: path.slug - text: Show the agent dimensions {slug} satisfies. slots: slug: path.slug method: generated generated: '2026-09-26' - target: $.paths['/providers/{slug}/operations'].get update: x-apievangelist-phrasing: intent: List every operation a provider exposes effect: read questions: - What operations can I actually call on a provider, across all its specs? - Can I find the operations a provider marks deprecated? - Which of a provider's operations move money rather than just read data? instructions: - text: List every operation {slug} exposes. slots: slug: path.slug - text: Show {slug}'s {method} operations whose path contains {path}. slots: slug: path.slug method: query.method path: query.path - text: Find operations in {slug} with agentic consequence {consequence}. slots: slug: path.slug consequence: query.consequence method: generated generated: '2026-09-26' - target: $.paths['/providers/{slug}/tools'].get update: x-apievangelist-phrasing: intent: List the MCP tools a provider ships effect: read questions: - What MCP tools does a provider ship, and which operation does each wrap? - Can I see only first-party MCP tools, not derived candidates? instructions: - text: List the MCP tools {slug} ships. slots: slug: path.slug - text: Show {slug}'s MCP tools with provenance {provenance}. slots: slug: path.slug provenance: query.provenance method: generated generated: '2026-09-26' - target: $.paths['/providers/{slug}/schema'].get update: x-apievangelist-phrasing: intent: List a provider's JSON Schemas effect: read questions: - What data shapes does a provider's API work in? - Can I search one provider's JSON Schemas by name? instructions: - text: List every JSON Schema {slug} publishes. slots: slug: path.slug - text: Find schemas matching {q} in {slug}'s APIs. slots: q: query.q slug: path.slug method: generated generated: '2026-09-26'