# 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'