API Evangelist conversational phrasing for Massive Com Benzinga API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Massive Com Benzinga API
  version: 1.0.0
extends: openapi/massive-com-benzinga-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: 9
- target: $.paths['/benzinga/v1/analyst-insights'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse analyst insights and rating calls
      effect: read
      questions:
      - Where can I read analyst insights behind recent rating calls on a stock?
      - Can I see analyst insight write-ups filtered by the research firm that issued them?
      - What rating actions and price-target commentary did analysts publish on a given date?
      instructions:
      - text: Pull analyst insights for {ticker}.
        slots:
          ticker: query.ticker
      - text: Show analyst insights published by {firm} on {date}.
        slots:
          firm: query.firm
          date: query.date
      - text: List analyst insights where the rating action was {rating_action}.
        slots:
          rating_action: query.rating_action
      method: generated
      generated: '2026-09-26'
- target: $.paths['/benzinga/v1/analysts'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up financial analysts and their track records
      effect: read
      questions:
      - Which analysts work at a particular research firm, and how accurate are they?
      - Can I look up an individual analyst's performance metrics by name?
      instructions:
      - text: Find the analyst named {full_name}.
        slots:
          full_name: query.full_name
      - text: List every analyst employed at {firm_name}.
        slots:
          firm_name: query.firm_name
      - text: Get analyst profile {benzinga_id}.
        slots:
          benzinga_id: query.benzinga_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/benzinga/v1/bulls-bears-say'].get
  update:
    x-apievangelist-phrasing:
      intent: Get bull and bear case summaries for a stock
      effect: read
      questions:
      - What are the bullish and bearish arguments analysts make about a stock?
      - Is there a short summary of both sides of the investment case for a company?
      instructions:
      - text: Give me the bull case and bear case for {ticker}.
        slots:
          ticker: query.ticker
      - text: Show bull/bear summaries updated since {last_updated_gte}.
        slots:
          last_updated_gte: query.last_updated.gte
      method: generated
      generated: '2026-09-26'
- target: $.paths['/benzinga/v1/consensus-ratings/{ticker}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a stock's consensus analyst rating
      effect: read
      questions:
      - What is the Wall Street consensus rating and average price target for a stock?
      - How many analysts rate a ticker buy versus hold versus sell?
      instructions:
      - text: Get the consensus analyst rating for {ticker}.
        slots:
          ticker: path.ticker
      - text: Show the consensus rating breakdown for {ticker} as of {date}.
        slots:
          ticker: path.ticker
          date: query.date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/benzinga/v1/earnings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get company earnings results and estimates
      effect: read
      questions:
      - When does a company report earnings and what EPS is expected?
      - Which companies beat revenue estimates by more than a certain surprise percent?
      - Can I get actual versus estimated EPS for a fiscal quarter?
      instructions:
      - text: Show earnings results and estimates for {ticker}.
        slots:
          ticker: query.ticker
      - text: List earnings reports scheduled on {date}.
        slots:
          date: query.date
      - text: Find earnings with an EPS surprise above {eps_surprise_percent_gt} percent.
        slots:
          eps_surprise_percent_gt: query.eps_surprise_percent.gt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/benzinga/v1/firms'].get
  update:
    x-apievangelist-phrasing:
      intent: List financial research firms
      effect: read
      questions:
      - Which brokerage and research firms are covered in the analyst ratings data?
      - Can I look up a research firm's identifier to filter ratings by it?
      instructions:
      - text: List the financial research firms in the database.
      - text: Get the research firm with ID {benzinga_id}.
        slots:
          benzinga_id: query.benzinga_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/benzinga/v1/guidance'].get
  update:
    x-apievangelist-phrasing:
      intent: Get company earnings and revenue guidance
      effect: read
      questions:
      - What EPS and revenue guidance has a company given for the coming fiscal year?
      - Did management raise or lower its forward guidance recently?
      instructions:
      - text: Show the latest company guidance for {ticker}.
        slots:
          ticker: query.ticker
      - text: List guidance issued for fiscal year {fiscal_year}.
        slots:
          fiscal_year: query.fiscal_year
      - text: Find guidance updates announced on {date}.
        slots:
          date: query.date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/benzinga/v1/ratings'].get
  update:
    x-apievangelist-phrasing:
      intent: Track analyst upgrades, downgrades and price targets
      effect: read
      questions:
      - Which analysts upgraded or downgraded a stock this week?
      - How have price targets changed for a ticker over time?
      - Can I filter rating changes to only initiations of coverage?
      instructions:
      - text: List analyst rating changes for {ticker}.
        slots:
          ticker: query.ticker
      - text: Show all upgrades and downgrades issued on {date}.
        slots:
          date: query.date
      - text: Find ratings where the price target action was {price_target_action}.
        slots:
          price_target_action: query.price_target_action
      method: generated
      generated: '2026-09-26'
- target: $.paths['/benzinga/v2/news'].get
  update:
    x-apievangelist-phrasing:
      intent: Search Benzinga financial news articles
      effect: read
      questions:
      - What financial news has been published about a stock today?
      - Can I filter market news articles by channel or tag?
      - Which news stories mention a set of tickers together?
      instructions:
      - text: Get Benzinga news articles mentioning {tickers}.
        slots:
          tickers: query.tickers
      - text: Show news articles in the {channels} channel.
        slots:
          channels: query.channels
      - text: List news articles written by {author}.
        slots:
          author: query.author
      method: generated
      generated: '2026-09-26'