News

This REST API returns structured data for news. For optimal performance, limit the scope of the query using parameters such as tickers, date, and channels, or use updatedSince for deltas. Page offsets are limited from 0 - 100000.

GET /api/v2/news

Get the news items

cURL

curl --request GET \
  --url 'https://api.benzinga.com/api/v2/news?token=' \
  --header 'accept: <accept>'

Response (200 OK)

[
  {
    "id": 36444586,
    "author": "Benzinga Insights",
    "created": "Mon, 01 Jan 2024 13:35:14 -0400",
    "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
    "title": "10 Information Technology Stocks With Whale Alerts In Today's Session",
    "teaser": "",
    "body": "",
    "url": "https://www.benzinga.com/markets/options/24/01/36444586/10-information-technology-stocks-with-whale-alerts-in-todays-session",
    "image": [
      {
        "size": "thumb",
        "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/options_image_2.jpeg"
      }
    ],
    "channels": [
      {
        "name": "Options"
      }
    ],
    "stocks": [
      {
        "name": "AAPL",
        "cusip": "037833100",
        "isin": "US0378331005",
        "exchange": "NASDAQ"
      },
      {
        "name": "CLSK",
        "cusip": "18452B209",
        "isin": "US18452B2097",
        "exchange": "NASDAQ"
      },
      {
        "name": "NVDA",
        "cusip": "67066G104",
        "isin": "US67066G1040",
        "exchange": "NASDAQ"
      },
      {
        "name": "ORCL",
        "cusip": "68389X105",
        "isin": "US68389X1054",
        "exchange": "NYSE"
      },
      {
        "name": "TSM",
        "cusip": "874039100",
        "isin": "US8740391003",
        "exchange": "NYSE"
      }
    ],
    "tags": [
      {
        "name": "BZI-AUOA"
      }
    ]
  }
]

Response (200 OK)

[
  {
    "id": 36444586,
    "author": "Benzinga Insights",
    "created": "Mon, 01 Jan 2024 13:35:14 -0400",
    "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
    "title": "10 Information Technology Stocks With Whale Alerts In Today's Session",
    "teaser": "",
    "body": "",
    "url": "https://www.benzinga.com/markets/options/24/01/36444586/10-information-technology-stocks-with-whale-alerts-in-todays-session",
    "image": [
      {
        "size": "thumb",
        "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/options_image_2.jpeg"
      }
    ],
    "channels": [
      {
        "name": "Options"
      }
    ],
    "stocks": [
      {
        "name": "AAPL",
        "cusip": "037833100",
        "isin": "US0378331005",
        "exchange": "NASDAQ"
      },
      {
        "name": "CLSK",
        "cusip": "18452B209",
        "isin": "US18452B2097",
        "exchange": "NASDAQ"
      },
      {
        "name": "NVDA",
        "cusip": "67066G104",
        "isin": "US67066G1040",
        "exchange": "NASDAQ"
      },
      {
        "name": "ORCL",
        "cusip": "68389X105",
        "isin": "US68389X1054",
        "exchange": "NYSE"
      },
      {
        "name": "TSM",
        "cusip": "874039100",
        "isin": "US8740391003",
        "exchange": "NYSE"
      }
    ],
    "tags": [
      {
        "name": "BZI-AUOA"
      }
    ]
  }
]

Authorizations

token · string · query · required

API key authentication. Provide your API key as a query parameter.

Headers

accept · enum<string> · default: application/json · required

Specify return format

Available options: application/json, application/xml

Query Parameters

page · integer · default: 0

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 · default: 15

Number of results returned. Maximum 100.

Required range: x <= 100

displayOutput · enum<string> · default: headline

Specify headline only (headline), headline + teaser (abstract), or headline + full body (full) text

Available options: full, abstract, headline

date · string

The date to query for news. Shorthand for dateFrom and dateTo if they are the same. Format: yyyy-mm-dd

dateFrom · string

Date to query from point in time. Sorted by published date. Format: yyyy-mm-dd

dateTo · string

Date to query to point in time. Sorted by published date. Format: yyyy-mm-dd

updatedSince · integer

The last updated Unix timestamp (UTC) to pull and sort by

publishedSince · integer

The last published Unix timestamp (UTC) to pull and sort by

sort · enum<string>

Allows control of results sorting. Default is created, DESC. Format: field:direction. Sort Fields: id, created, updated. Sort Order: asc (ascending), desc (descending)

Available options: id:asc, id:desc, created:asc, created:desc, updated:asc, updated:desc

isin · string

One or more ISINs separated by a comma. Maximum 50. Format: csv

cusips · string

One or more CUSIPs separated by a comma. Maximum 50. License agreement required. Format: csv

tickers · string

One or more ticker symbols separated by a comma. Maximum 50. Format: csv

primaryTickers · string

One or more primary ticker symbols separated by a comma. Filters by primary ticker association only. Format: csv

channels · string

One or more channel names or IDs separated by a comma. Format: csv

topics · string

One or more words/phrases separated by a comma; searches Title, Tags, and Body in order of priority. Format: csv

topic_group_by · enum<string> · default: or

Logical operator for topics query. Use 'and' to require all topics, 'or' to require any topic

Available options: and, or

authors · string

One or more authors separated by a comma. Format: csv

content_types · string

One or more content types separated by a comma. Format: csv

format · enum<string>

Specify the desired format for the api response

Available options: text

importance · enum<string>

Filter by importance level

Available options: low, medium, high

region · string

Filter by region (e.g., 'ca' or 'canada' for Canadian content)

Response

200

application/json

success

author · string

Example:

"Benzinga Newsdesk"

body · string

channels · object[]

Show child attributes

created · string

Example:

"Wed, 17 May 2017 14:20:15 -0400"

id · integer

Example:

123456

image · object[]

Show child attributes

original_id · integer

stocks · object[]

Show child attributes

tags · object[]

Show child attributes

teaser · string

title · string

Example:

"Apple Announces New iPhone"

updated · string

Example:

"Wed, 17 May 2017 14:20:15 -0400"

url · string

Example:

"https://www.benzinga.com/news/123456"