> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# benzinga-news
> Benzinga News
**Server path:** `/benzinga-news` | **Type:** Application | **PCID required:** Yes
## Tools
| Tool | Description |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| [`benzinga_news_get_analyst_insights`](#benzinga_news_get_analyst_insights) | Get analyst insights for a given ticker symbol. |
| [`benzinga_news_get_bulls_bears_say`](#benzinga_news_get_bulls_bears_say) | Get the latest bull and bear cases for a given ticker symbol. |
| [`benzinga_news_get_earnings_call_transcripts`](#benzinga_news_get_earnings_call_transcripts) | Get earnings call transcripts for a given ticker symbol. |
| [`benzinga_news_get_news`](#benzinga_news_get_news) | Get the news items |
| [`benzinga_news_get_removed`](#benzinga_news_get_removed) | Returns the removed news data |
| [`benzinga_news_get_signal_option_activity`](#benzinga_news_get_signal_option_activity) | Returns option activity signals |
| [`benzinga_news_get_wiims`](#benzinga_news_get_wiims) | Returns WIIMs data |
***
## benzinga\_news\_get\_analyst\_insights
Get analyst insights for a given ticker symbol.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------------ | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| `page` | integer | No | — | Page number for pagination. |
| `pageSize` | integer | No | — | Number of items per page. |
| `symbols` | string | No | — | Stock ticker symbols separated by commas to query for analyst insights. |
| `analyst` | string | No | — | One or more analyst ids separated by a comma. |
| `rating_id` | string | No | — | One or more rating ids separated by a comma. |
| `search_keys_type` | string | No | — | If you wanna query by firm Id or firm name, use this parameter and pass the key. Currently supported are \[firm\_id, firm] |
| `search_keys` | string | No | — | If you have selected search\_keys\_type, pass the appropriate identifier here. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"page": {
"type": "integer",
"description": "Page number for pagination."
},
"pageSize": {
"type": "integer",
"description": "Number of items per page."
},
"symbols": {
"type": "string",
"description": "Stock ticker symbols separated by commas to query for analyst insights."
},
"analyst": {
"type": "string",
"description": "One or more analyst ids separated by a comma."
},
"rating_id": {
"type": "string",
"description": "One or more rating ids separated by a comma."
},
"search_keys_type": {
"type": "string",
"description": "If you wanna query by firm Id or firm name, use this parameter and pass the key. Currently supported are [firm_id, firm]",
"enum": [
"firm_id",
"firm"
]
},
"search_keys": {
"type": "string",
"description": "If you have selected search_keys_type, pass the appropriate identifier here."
}
},
"required": [
"PCID"
]
}
```
***
## benzinga\_news\_get\_bulls\_bears\_say
Get the latest bull and bear cases for a given ticker symbol.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `symbols` | string | Yes | — | Stock ticker symbol to query for bull/bear cases. |
| `page` | integer | No | — | Page offset number. |
| `pagesize` | integer | No | — | Number of results to be returned. Limit 200 |
| `parameters[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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"symbols": {
"type": "string",
"description": "Stock ticker symbol to query for bull/bear cases."
},
"page": {
"type": "integer",
"description": "Page offset number."
},
"pagesize": {
"type": "integer",
"description": "Number of results to be returned. Limit 200"
},
"parameters[updated]": {
"type": "integer",
"description": "Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated."
}
},
"required": [
"PCID",
"symbols"
]
}
```
***
## benzinga\_news\_get\_earnings\_call\_transcripts
Get earnings call transcripts for a given ticker symbol.
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
}
},
"required": [
"PCID"
]
}
```
***
## benzinga\_news\_get\_news
Get the news items
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------------- | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `page` | integer | No | — | Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date. |
| `pageSize` | integer | No | — | Number of results returned. |
| `displayOutput` | string | No | — | Specify headline only (headline), headline + teaser (abstract), or headline + full body (full) text |
| `date` | string | No | — | The date to query for news. Shorthand for date\_from and date\_to if they are the same |
| `dateFrom` | string | No | — | Date to query from point in time. Sorted by published date |
| `dateTo` | string | No | — | Date to query to point in time. Sorted by published date |
| `updatedSince` | integer | No | — | The last updated Unix timestamp (UTC) to pull and sort by |
| `publishedSince` | integer | No | — | The last published Unix timestamp (UTC) to pull and sort by |
| `sort` | string | No | — | Allows control of results sorting. Default is created, DESC. Sort Fields \* id \* created \* updated Sort Order Direction \* asc (ascending) \* desc (descending) |
| `isin` | string | No | — | One or more ISINs separated by a comma. Maximum 50. |
| `cusip` | string | No | — | One or more CUSIPs separated by a comma. Maximum 50. License agreement required. |
| `tickers` | string | No | — | One or more ticker symbols separated by a comma. Maximum 50. |
| `channels` | string | No | — | One or more channel names or IDs separated by a comma |
| `topics` | string | No | — | One or more words/phrases separated by a comma; searches Title, Tags, and Body in order of priority. |
| `authors` | string | No | — | One or more authors separated by a comma |
| `content_types` | string | No | — | One or more content types separated by a comma |
| `format` | string | No | — | Specify the desired format for the api response. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"page": {
"type": "integer",
"description": "Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date."
},
"pageSize": {
"type": "integer",
"description": "Number of results returned."
},
"displayOutput": {
"type": "string",
"description": "Specify headline only (headline), headline + teaser (abstract), or headline + full body (full) text",
"enum": [
"full",
"abstract",
"headline"
]
},
"date": {
"type": "string",
"description": "The date to query for news. Shorthand for date_from and date_to if they are the same"
},
"dateFrom": {
"type": "string",
"description": "Date to query from point in time. Sorted by published date"
},
"dateTo": {
"type": "string",
"description": "Date to query to point in time. Sorted by published date"
},
"updatedSince": {
"type": "integer",
"description": "The last updated Unix timestamp (UTC) to pull and sort by"
},
"publishedSince": {
"type": "integer",
"description": "The last published Unix timestamp (UTC) to pull and sort by"
},
"sort": {
"type": "string",
"description": "Allows control of results sorting. Default is created, DESC. Sort Fields * id * created * updated Sort Order Direction * asc (ascending) * desc (descending)",
"enum": [
"id:asc",
"id:desc",
"created:asc",
"created:desc",
"updated:asc",
"updated:desc"
]
},
"isin": {
"type": "string",
"description": "One or more ISINs separated by a comma. Maximum 50."
},
"cusip": {
"type": "string",
"description": "One or more CUSIPs separated by a comma. Maximum 50. License agreement required."
},
"tickers": {
"type": "string",
"description": "One or more ticker symbols separated by a comma. Maximum 50."
},
"channels": {
"type": "string",
"description": "One or more channel names or IDs separated by a comma"
},
"topics": {
"type": "string",
"description": "One or more words/phrases separated by a comma; searches Title, Tags, and Body in order of priority."
},
"authors": {
"type": "string",
"description": "One or more authors separated by a comma"
},
"content_types": {
"type": "string",
"description": "One or more content types separated by a comma"
},
"format": {
"type": "string",
"description": "Specify the desired format for the api response.",
"enum": [
"text"
]
}
},
"required": [
"PCID"
]
}
```
***
## benzinga\_news\_get\_removed
Returns the removed news data
**Parameters:**
| Parameter | Type | Required | Default | Description |
| -------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `page` | integer | No | — | Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date. |
| `pageSize` | integer | No | — | Number of results returned. |
| `updatedSince` | integer | No | — | Filters the results to only include items that have been updated since the specified timestamp. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"page": {
"type": "integer",
"description": "Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date."
},
"pageSize": {
"type": "integer",
"description": "Number of results returned."
},
"updatedSince": {
"type": "integer",
"description": "Filters the results to only include items that have been updated since the specified timestamp."
}
},
"required": [
"PCID"
]
}
```
***
## benzinga\_news\_get\_signal\_option\_activity
Returns option activity signals
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------------------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `page` | integer | No | — | Page offset. |
| `pagesize` | integer | No | — | Number of results returned. Limit 1000 |
| `parameters[date]` | string | No | — | Date to query for data. Shorthand for date\_from and date\_to if they are the same. Defaults for latest. |
| `parameters[date_from]` | string | No | — | Date to query from point in time. |
| `parameters[date_to]` | string | No | — | Date to query to point in time. |
| `parameters[tickers]` | string | No | — | One or more ticker symbols separated by a comma. |
| `parameters[id]` | string | No | — | One or more ids separated by a comma. |
| `parameters[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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"page": {
"type": "integer",
"description": "Page offset."
},
"pagesize": {
"type": "integer",
"description": "Number of results returned. Limit 1000"
},
"parameters[date]": {
"type": "string",
"description": "Date to query for data. Shorthand for date_from and date_to if they are the same. Defaults for latest."
},
"parameters[date_from]": {
"type": "string",
"description": "Date to query from point in time."
},
"parameters[date_to]": {
"type": "string",
"description": "Date to query to point in time."
},
"parameters[tickers]": {
"type": "string",
"description": "One or more ticker symbols separated by a comma."
},
"parameters[id]": {
"type": "string",
"description": "One or more ids separated by a comma."
},
"parameters[updated]": {
"type": "integer",
"description": "Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated."
}
},
"required": [
"PCID"
]
}
```
***
## benzinga\_news\_get\_wiims
Returns WIIMs data
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------------ | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `country` | string | No | — | Country code for the region of coverage. |
| `page` | integer | No | — | Page offset. |
| `pagesize` | integer | No | — | Number of results returned. Limit 500 |
| `search_keys` | string | No | — | One or more security symbols separated by a comma. Maximum 50 securities. Security identifiers must be in the format of ticker symbols, only for US-listed equities. |
| `search_keys_type` | string | No | — | The type of identifier being searched. Supported types are currently a security symbol. |
| `updated_since` | number | No | — | Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. Timestamp may also be in python format to include millisecond updates. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"country": {
"type": "string",
"description": "Country code for the region of coverage."
},
"page": {
"type": "integer",
"description": "Page offset."
},
"pagesize": {
"type": "integer",
"description": "Number of results returned. Limit 500"
},
"search_keys": {
"type": "string",
"description": "One or more security symbols separated by a comma. Maximum 50 securities. Security identifiers must be in the format of ticker symbols, only for US-listed equities."
},
"search_keys_type": {
"type": "string",
"description": "The type of identifier being searched. Supported types are currently a security symbol.",
"enum": [
"symbol"
]
},
"updated_since": {
"type": "number",
"description": "Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. Timestamp may also be in python format to include millisecond updates."
}
},
"required": [
"PCID"
]
}
```