Skip to main content
Benzinga logo
  • Category: market data
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: BENZINGA
  • Version: 20261101_00

Tools

Slug: BENZINGA_GET_CALENDAR_EARNINGS_STREAMReturn a constructed WebSocket URL, authentication token, and requested ticker and ISIN filters for the real-time earnings calendar stream. A separate WebSocket client is needed to connect and receive events.

Input Parameters

string
Comma-separated list of ISIN codes to filter (e.g., ‘US0378331005,US5949181045’).
string
Comma-separated list of ticker symbols to filter (e.g., ‘AAPL,MSFT’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BENZINGA_GET_CONFERENCE_CALLS_V21Retrieve conference call calendar data for a selected period or securities, including available call details. Filter by date, ticker symbols, or update time and paginate through results; up to 50 tickers can be specified.

Input Parameters

string
Date to query for calendar data (YYYY-MM-DD). Shorthand for date_from and date_to if they are the same. Defaults for latest
integer
Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 to 100000. Limit the query results by other parameters such as date
string
Date to query to point in time (YYYY-MM-DD)
string
One or more ticker symbols separated by a comma. Maximum 50 tickers
integer
Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated
integer
Number of results returned. Limit 1000
string
Date to query from point in time (YYYY-MM-DD)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BENZINGA_GET_CONSENSUS_RATINGSGet aggregated consensus analyst ratings and price targets for a stock ticker. Returns analyst sentiment distribution (strong_buy, buy, hold, sell counts or percentages), consensus rating, price target range (low, high, average), and analyst counts. Specify a ticker symbol to get results - not all tickers have consensus data available. Use this when you need to understand the overall analyst sentiment and price expectations for a stock to inform investment decisions.

Input Parameters

integer
Maximum number of results to return. Range: 1-1000. Note: Consensus ratings typically return a single aggregated result per ticker.
boolean
Whether to simplify rating categories. Note: Currently returns standard categories (strong_buy, buy, hold, sell) regardless of this setting.
object
Parameters for consensus ratings query: date range and ticker.
string ("number" | "percentage")
How to aggregate ratings: ‘number’ returns actual counts of each rating type, ‘percentage’ returns percentages. Default is ‘number’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BENZINGA_GET_EARNINGS_V21Retrieve earnings calendar data, including dates, estimates, and actuals, using the configured v2 API endpoint.

Input Parameters

string
Specific date (YYYY-MM-DD) for calendar data. Shorthand for date_from and date_to when identical
integer
Page offset (>=0)
string
End date (YYYY-MM-DD) to query to point in time
array
List of ticker symbols (max 50). Will be joined by commas
integer
Unix timestamp (UTC) to filter records updated since this timestamp
integer
Number of results to return, max 1000
string
Start date (YYYY-MM-DD) to query from point in time
string ("date:asc" | "date:desc")
Sort by date ascending or descending
integer
Importance level filter (0-5 inclusive)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BENZINGA_GET_ECONOMICS_V21Retrieve economic calendar data for indicators and releases across countries, including actual, consensus, and prior values. Filter by date, country, event category, minimum importance, or update time, and paginate through results.

Input Parameters

string
Specific date (YYYY-MM-DD) for calendar data. Shorthand for date_from and date_to if they are the same. Defaults to latest
integer
Page offset for pagination (0-100000). For optimization and performance reasons, page offsets are limited
string
3-digit country code to filter events (e.g., ‘USA’, ‘CAN’, ‘GBR’, ‘JPN’, ‘CHN’)
string
End date (YYYY-MM-DD) to query to point in time
integer
Records last updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated
integer
Number of results to return per page (max 1000)
string
Start date (YYYY-MM-DD) to query from point in time
integer
The importance level to filter by (1, 2, or 3). Uses Greater Than or Equal To the importance indicated. Higher values indicate more important economic events
string
One or more event categories separated by a comma (e.g., ‘Employment’, ‘Economic Activity’, ‘Central Banks’, ‘Inflation’, ‘Housing’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BENZINGA_GET_NEWS_CHANNELSTool to retrieve all available news channels that can be used to filter news items. Use when you need to discover available channel categories for news filtering. Channels can have sub-channels (identified by parent field), but all are listed as individual items.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BENZINGA_GET_NEWSFEED_STREAMGet WebSocket connection details for real-time Benzinga newsfeed streaming. Returns the WebSocket URL and authentication token needed to establish a WebSocket connection for receiving real-time news events. Use this when you need immediate updates as news articles are created, updated, or removed. Note: This action returns connection details only. You will need a WebSocket client library to establish the actual streaming connection using the provided URL and token.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BENZINGA_GET_RATINGS_V21Tool to fetch analyst ratings data including upgrades, downgrades, initiations, and price target changes from Wall Street analysts. Returns current and prior ratings, price targets, analyst information, and ratings accuracy metrics when available. Use when querying analyst ratings with advanced filtering options like analyst ID, firm ID, and specific rating actions.

Input Parameters

string
Single calendar date to fetch (YYYY-MM-DD). Shorthand for date_from and date_to if they are the same. Defaults to latest.
string
A comma-separated list of analyst firm IDs to bring back. Omitting will bring back all available firms.
integer
Page offset for pagination (0-100000). Default is 0.
string ("Downgrades" | "Maintains" | "Reinstates" | "Reiterates" | "Upgrades" | "Assumes" | "Initiates Coverage On" | "Terminates Coverage On" | "Removes" | "Suspends" | "Firm Dissolved")
Action types for analyst ratings.
string
Comma-separated list of fields to return. Available fields: id, date, time, ticker, exchange, name, currency, action_pt, action_company, rating_current, pt_current, rating_prior, pt_prior, pt_pct_change, url, url_calendar, url_news, analyst, analyst_id, analyst_name, ratings_accuracy, importance, notes, updated. Use * for all fields including ratings_accuracy.
string
A comma-separated list of analyst (person) IDs to bring back. Omitting will bring back all available analysts.
string
End date for range query (YYYY-MM-DD).
string
One or more firm IDs (firm_id) separated by a comma.
string
One or more ticker symbols separated by a comma. Maximum 50 tickers.
integer
Records last updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.
integer
Number of results per page (1-1000).
boolean
Simplify the ratings to standardized categories. Default is false.
string
Start date for range query (YYYY-MM-DD).
string
One or more analyst IDs (analyst_id) separated by a comma.
integer
Importance level to filter by (0-5). Uses Greater Than or Equal To the importance indicated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BENZINGA_GET_REMOVED_NEWSRetrieves IDs and timestamps of news articles that have been removed from Benzinga’s database. Use this to track deleted/retracted news articles, sync local caches, or identify articles removed after a specific timestamp. Returns removed article IDs with their removal timestamps, supporting pagination up to 100 pages. Note: This endpoint returns only article identifiers and removal times - not the original article content.

Input Parameters

integer
Zero-based page number for pagination (0-100000). Use 0 for the first page, 1 for the second, etc.
integer
Unix UTC timestamp in seconds. When specified, returns only articles removed on or after this time. Useful for incremental syncing.
integer
Number of removed articles to return per page (1-100). Default is 15.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BENZINGA_GET_REMOVED_V21Tool to retrieve removed or cancelled calendar events from Benzinga (v2.1). Use when you need to track calendar events that have been deleted or cancelled from specific event types like earnings, ratings, dividends, splits, IPOs, offerings, economics, guidance, M&A, or conference calls. Supports filtering by event type and update timestamp for change tracking and data synchronization.

Input Parameters

integer
Page offset for pagination. Limited from 0 to 100000 for optimization and performance. Default is 0.
string ("ratings" | "earnings" | "dividends" | "splits" | "ipos" | "offerings" | "economics" | "guidance" | "ma" | "conference calls")
Type of calendar event to filter removed items. Options: ratings, earnings, dividends, splits, ipos, offerings, economics, guidance, ma, conference calls.
integer
Records last updated Unix timestamp (UTC). Filters records with update timestamp greater than or equal to this value. Forces sort order by timestamp.
integer
Number of results returned per page. Maximum limit is 1000. Default is 100.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not