# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Advertising Intelligence REST Account Stats API
  version: 1.0.0
extends: openapi/vendasta-account-stats-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: 2
- target: $.paths['/accountStats'].get
  update:
    x-apievangelist-phrasing:
      intent: List ad account stats for a business location
      effect: read
      questions:
      - How are all the connected advertising accounts for a location performing?
      - Can I narrow ad account stats to one ad provider and a date range?
      instructions:
      - text: List ad account stats for business location {location}.
        slots:
          location: query.filter[businessLocation.id]
      - text: Show {provider} ad stats for location {location} between {startAt} and {endAt}.
        slots:
          provider: query.filter[provider]
          location: query.filter[businessLocation.id]
          startAt: query.startAt
          endAt: query.endAt
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accountStats/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get stats for one connected ad account
      effect: read
      questions:
      - What results did one specific connected ad account deliver?
      - Can I get a single advertising account's stats for a custom period?
      instructions:
      - text: Get stats for connected ad account {id}.
        slots:
          id: path.id
      - text: Show performance of ad account {id} from {startAt} to {endAt}.
        slots:
          id: path.id
          startAt: query.startAt
          endAt: query.endAt
      method: generated
      generated: '2026-10-01'