# 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 Areas API
  version: 1.0.0
extends: openapi/apis-io-areas-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: 3
- target: $.paths['/areas'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse curated API topic areas
      effect: read
      questions:
      - What curated topic areas, like authentication or webhooks, does API Evangelist track?
      - Which curated areas have the most providers in them?
      instructions:
      - text: List the curated areas matching {q}.
        slots:
          q: query.q
      - text: Show all curated areas sorted by provider count.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/areas/{slug}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one curated area and its ranked providers
      effect: read
      questions:
      - What is in the webhooks area, and which providers belong to it?
      - Can I see an area's description, site link and full ranked member list?
      instructions:
      - text: Get the area {slug} with all of its ranked member providers.
        slots:
          slug: path.slug
      - text: Open the curated area {slug} and show its counts and site link.
        slots:
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/areas/{slug}/leaders'].get
  update:
    x-apievangelist-phrasing:
      intent: Show the top-rated providers in an area
      effect: read
      questions:
      - Who are the highest-rated providers in the payments area?
      - Which handful of providers lead a curated area on composite score?
      instructions:
      - text: Show the top {limit} providers in the {slug} area.
        slots:
          limit: query.limit
          slug: path.slug
      - text: List the leaders of curated area {slug}.
        slots:
          slug: path.slug
      method: generated
      generated: '2026-09-26'