News - Benzinga API Documentation

Get the news items

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

import requests

url = "https://api.benzinga.com/api/v2/news?token="

headers = {"accept": "<accept>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {accept: '<accept>'}};

fetch('https://api.benzinga.com/api/v2/news?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.benzinga.com/api/v2/news?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: <accept>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.benzinga.com/api/v2/news?token="

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accept", "<accept>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.benzinga.com/api/v2/news?token=")
  .header("accept", "<accept>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v2/news?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'

response = http.request(request)
puts response.read_body

[
  {
    "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",
        "alt": "Applied optoelectronics website"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/options_image_2.jpeg",
        "alt": "Applied optoelectronics website"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/options_image_2.jpeg",
        "alt": "Applied optoelectronics website"
      }
    ],
    "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"
      }
    ]
  }
]

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}

GET

api

news

Get the news items

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

import requests

url = "https://api.benzinga.com/api/v2/news?token="

headers = {"accept": "<accept>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {accept: '<accept>'}};

fetch('https://api.benzinga.com/api/v2/news?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.benzinga.com/api/v2/news?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: <accept>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.benzinga.com/api/v2/news?token="

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accept", "<accept>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.benzinga.com/api/v2/news?token=")
  .header("accept", "<accept>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v2/news?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'

response = http.request(request)
puts response.read_body

[
  {
    "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",
        "alt": "Applied optoelectronics website"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/options_image_2.jpeg",
        "alt": "Applied optoelectronics website"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/options_image_2.jpeg",
        "alt": "Applied optoelectronics website"
      }
    ],
    "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"
      }
    ]
  }
]

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}

[
  {
    "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",
        "alt": "Applied optoelectronics website"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/options_image_2.jpeg",
        "alt": "Applied optoelectronics website"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/options_image_2.jpeg",
        "alt": "Applied optoelectronics website"
      }
    ],
    "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"
      }
    ]
  }
]

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}

Authorizations

token

string

query

required

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

Headers

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

string

Filter by importance level

importanceRank

integer

Filter by importance rank (1-5)

region

string

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

Response

success

author

string

Example:

"Benzinga Newsdesk"

body

string

channels

object[]

Show child attributes

created

string

Example:

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

integer

Example:

123456

image

object[]

Show child attributes

importance_rank

integer

Example:

1

original_id

integer

stocks

object[]

Show child attributes