Sign in

v1

latestOpenAPI 3.0.02026-07-266091181.5 KB
News

Get the news items

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

Query parameters

pageinteger

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.

pageSizeinteger

Number of results returned. Maximum 100.

displayOutput'full' | 'abstract' | 'headline'

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

datestring

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

dateFromstring

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

dateTostring

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

updatedSinceinteger

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

publishedSinceinteger

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

sort'id:asc' | 'id:desc' | 'created:asc' | 'created:desc' | 'updated:asc' | 'updated:desc'

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

isinstring

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

cusipsstring

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

tickersstring

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

primaryTickersstring

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

channelsstring

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

topicsstring

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

topic_group_by'and' | 'or'

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

authorsstring

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

content_typesstring

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

format'text'

Specify the desired format for the api response

importancestring

Filter by importance level

importanceRankinteger

Filter by importance rank (1-5)

regionstring

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

Headers

accept'application/json' | 'application/xml' required

Specify return format

Response

success

authorstring
bodystring
createdstring
idinteger
importance_rankinteger
original_idinteger
teaserstring
titlestring
updatedstring
urlstring

Example response

[
  {
    "author": "Benzinga Newsdesk",
    "channels": [
      {
        "name": "Technology"
      }
    ],
    "created": "Wed, 17 May 2017 14:20:15 -0400",
    "id": 123456,
    "image": [
      {
        "alt": "Apple logo on a storefront",
        "size": "large",
        "url": "https://cdn.benzinga.com/files/images/story/2024/example.jpg"
      }
    ],
    "importance_rank": 1,
    "stocks": [
      {
        "exchange": "NASDAQ",
        "gics": "Semiconductors & Semiconductor Equipment",
        "gics_code": "45301020",
        "isin": "US0378331005",
        "name": "AAPL",
        "sector": "Equity"
      }
    ],
    "tags": [
      {
        "name": "Technology"
      }
    ],
    "title": "Apple Announces New iPhone",
    "updated": "Wed, 17 May 2017 14:20:15 -0400",
    "url": "https://www.benzinga.com/news/123456"
  }
]