# Benzinga

Benzinga provides real-time financial news and data APIs, offering comprehensive coverage of market-moving information for developers and financial professionals.

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `BENZINGA`
- **Version:** 20260312_00

## Tools

### Get Calendar Earnings Stream

**Slug:** `BENZINGA_GET_CALENDAR_EARNINGS_STREAM`

Tool to subscribe to real-time earnings calendar events via WebSocket. Use when you need immediate updates as reports are announced.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `isins` | string | No | Comma-separated list of ISIN codes to filter (e.g., 'US0378331005,US5949181045'). |
| `tickers` | string | No | Comma-separated list of ticker symbols to filter (e.g., 'AAPL,MSFT'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Conference Calls V2.1

**Slug:** `BENZINGA_GET_CONFERENCE_CALLS_V21`

Tool to retrieve conference call data for a selected period and/or security using v2.1 API. Conference calls are scheduled calls where company management discusses quarterly or annual financial results, business updates, and answers questions from analysts and investors.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Date to query for calendar data (YYYY-MM-DD). Shorthand for date_from and date_to if they are the same. Defaults for latest |
| `page` | integer | No | 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 |
| `date_to` | string | No | Date to query to point in time (YYYY-MM-DD) |
| `tickers` | string | No | One or more ticker symbols separated by a comma. Maximum 50 tickers |
| `updated` | integer | No | Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated |
| `pagesize` | integer | No | Number of results returned. Limit 1000 |
| `date_from` | string | No | Date to query from point in time (YYYY-MM-DD) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Consensus Ratings

**Slug:** `BENZINGA_GET_CONSENSUS_RATINGS`

Get 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Earnings Calendar V2.1

**Slug:** `BENZINGA_GET_EARNINGS_V21`

Tool to retrieve earnings calendar data (v2.1). Use when you need dates, estimates, and actuals for upcoming earnings events.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Economics Calendar V2.1

**Slug:** `BENZINGA_GET_ECONOMICS_V21`

Tool to retrieve economic calendar data including indicators, releases, and reports from various countries. Returns actual values, consensus estimates, and prior values for economic events such as GDP, employment data, inflation metrics, and more.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Specific date (YYYY-MM-DD) for calendar data. Shorthand for date_from and date_to if they are the same. Defaults to latest |
| `page` | integer | No | Page offset for pagination (0-100000). For optimization and performance reasons, page offsets are limited |
| `country` | string | No | 3-digit country code to filter events (e.g., 'USA', 'CAN', 'GBR', 'JPN', 'CHN') |
| `date_to` | string | No | End date (YYYY-MM-DD) to query to point in time |
| `updated` | integer | No | Records last updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated |
| `pagesize` | integer | No | Number of results to return per page (max 1000) |
| `date_from` | string | No | Start date (YYYY-MM-DD) to query from point in time |
| `importance` | integer | No | 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 |
| `event_category` | string | No | One or more event categories separated by a comma (e.g., 'Employment', 'Economic Activity', 'Central Banks', 'Inflation', 'Housing') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get News Channels

**Slug:** `BENZINGA_GET_NEWS_CHANNELS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Newsfeed Stream

**Slug:** `BENZINGA_GET_NEWSFEED_STREAM`

Get 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Analyst Ratings V2.1

**Slug:** `BENZINGA_GET_RATINGS_V21`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Single calendar date to fetch (YYYY-MM-DD). Shorthand for date_from and date_to if they are the same. Defaults to latest. |
| `firm` | string | No | A comma-separated list of analyst firm IDs to bring back. Omitting will bring back all available firms. |
| `page` | integer | No | Page offset for pagination (0-100000). Default is 0. |
| `action` | string ("Downgrades" | "Maintains" | "Reinstates" | "Reiterates" | "Upgrades" | "Assumes" | "Initiates Coverage On" | "Terminates Coverage On" | "Removes" | "Suspends" | "Firm Dissolved") | No | Action types for analyst ratings. |
| `fields` | string | No | 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. |
| `analyst` | string | No | A comma-separated list of analyst (person) IDs to bring back. Omitting will bring back all available analysts. |
| `date_to` | string | No | End date for range query (YYYY-MM-DD). |
| `firm_id` | string | No | One or more firm IDs (firm_id) separated by a comma. |
| `tickers` | string | No | One or more ticker symbols separated by a comma. Maximum 50 tickers. |
| `updated` | integer | No | Records last updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. |
| `pagesize` | integer | No | Number of results per page (1-1000). |
| `simplify` | boolean | No | Simplify the ratings to standardized categories. Default is false. |
| `date_from` | string | No | Start date for range query (YYYY-MM-DD). |
| `analyst_id` | string | No | One or more analyst IDs (analyst_id) separated by a comma. |
| `importance` | integer | No | Importance level to filter by (0-5). Uses Greater Than or Equal To the importance indicated. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Removed News

**Slug:** `BENZINGA_GET_REMOVED_NEWS`

Retrieves 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Removed Calendar Events V2.1

**Slug:** `BENZINGA_GET_REMOVED_V21`

Tool 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |