Wistia · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Data Analytics:Account API

5 actions 5 updates phrasing extends openapi/wistia-analytics-account-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Wistia's API. It is a proposal applied on top of the contract, not a document Wistia publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info
$.paths['/analytics/account'].get
$.paths['/analytics/account/timeseries'].get
$.paths['/analytics/account/top_content'].get
$.paths['/analytics/account/embed_locations'].get

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Data Analytics:Account API
  version: 1.0.0
extends: openapi/wistia-analytics-account-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: 4
- target: $.paths['/analytics/account'].get
  update:
    x-apievangelist-phrasing:
      intent: Show account-wide analytics
      effect: read
      questions:
      - How many plays did my whole account get last month?
      - What's my account's overall engagement and play rate over a date range?
      instructions:
      - text: Show account analytics from {start_date} to {end_date}.
        slots:
          start_date: query.start_date
          end_date: query.end_date
      - text: Get total plays and engagement across all my media between {start_date} and {end_date}.
        slots:
          start_date: query.start_date
          end_date: query.end_date
      method: generated
      generated: '2026-10-01'
- target: $.paths['/analytics/account/timeseries'].get
  update:
    x-apievangelist-phrasing:
      intent: Chart account analytics over time
      effect: read
      questions:
      - How did my account's plays trend day by day over the last quarter?
      - Can I get account analytics broken into weekly buckets?
      instructions:
      - text: Chart my account's metrics by {granularity} between {start_date} and {end_date}.
        slots:
          granularity: query.granularity
          start_date: query.start_date
          end_date: query.end_date
      - text: Get a {granularity} timeseries of account plays from {start_date} to {end_date}.
        slots:
          granularity: query.granularity
          start_date: query.start_date
          end_date: query.end_date
      method: generated
      generated: '2026-10-01'
- target: $.paths['/analytics/account/top_content'].get
  update:
    x-apievangelist-phrasing:
      intent: Rank my top-performing content
      effect: read
      questions:
      - What were my most-watched videos last month?
      - Which folders or channels performed best over a date range?
      instructions:
      - text: Rank my top content by {sort_by} from {start_date} to {end_date}.
        slots:
          sort_by: query.sort_by
          start_date: query.start_date
          end_date: query.end_date
      - text: Show my top {group_by} between {start_date} and {end_date}.
        slots:
          group_by: query.group_by
          start_date: query.start_date
          end_date: query.end_date
      method: generated
      generated: '2026-10-01'
- target: $.paths['/analytics/account/embed_locations'].get
  update:
    x-apievangelist-phrasing:
      intent: See where my account's videos are embedded
      effect: read
      questions:
      - Which websites embed my videos the most?
      - Where across the web are my account's videos getting played?
      instructions:
      - text: List the domains embedding my account's media from {start_date} to {end_date}.
        slots:
          start_date: query.start_date
          end_date: query.end_date
      - text: Rank account embed domains by {sort_by} between {start_date} and {end_date}.
        slots:
          sort_by: query.sort_by
          start_date: query.start_date
          end_date: query.end_date
      method: generated
      generated: '2026-10-01'