# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure News Search Client News Category API
  version: 1.0.0
extends: openapi/microsoft-azure-news-category-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 1
- target: $.paths['/news'].get
  update:
    x-apievangelist-phrasing:
      intent: Get top news articles by category
      effect: read
      questions:
      - What are the top sports headlines right now?
      - Can I get news articles for a specific market like en-GB?
      - Which news categories can I ask for, such as Entertainment or Business?
      instructions:
      - text: Get the top news articles in category {category}.
        slots:
          category: query.category
      - text: Show {count} {category} news articles for market {market}.
        slots:
          count: query.count
          category: query.category
          market: query.mkt
      - text: Get top headlines for country {country} with safe search set to {safe_search}.
        slots:
          country: query.cc
          safe_search: query.safeSearch
      method: generated
      generated: '2026-10-01'