Skip to main content
GET
/
api
/
v2
/
news
ニュースを取得
curl --request GET \
  --url 'https://api.benzinga.com/api/v2/news?token=' \
  --header 'accept: <accept>'
[
  {
    "author": "Benzinga Newsdesk",
    "body": "<string>",
    "channels": [
      {
        "name": "Technology"
      }
    ],
    "created": "Wed, 17 May 2017 14:20:15 -0400",
    "id": 123456,
    "image": [
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/images/story/2024/example.jpg"
      }
    ],
    "original_id": 123,
    "stocks": [
      {
        "cusip": "037833100",
        "exchange": "NASDAQ",
        "isin": "US0378331005",
        "name": "AAPL"
      }
    ],
    "tags": [
      {
        "name": "Technology"
      }
    ],
    "teaser": "<string>",
    "title": "Apple Announces New iPhone",
    "updated": "Wed, 17 May 2017 14:20:15 -0400",
    "url": "https://www.benzinga.com/news/123456"
  }
]

Authorizations

token
string
query
required

APIキーによる認証。APIキーをクエリパラメータとして指定してください。

Headers

accept
enum<string>
default:application/json
required

レスポンス形式を指定します

Available options:
application/json,
application/xml

Query Parameters

page
integer
default:0

ページオフセット。最適化、パフォーマンス、および技術的な理由から、ページオフセットは 0 ~ 100000 の範囲に制限されています。日付などの他のパラメータでクエリ結果を絞り込んでください。

pageSize
integer
default:15

返される結果数。最大100件。

Required range: x <= 100
displayOutput
enum<string>
default:headline

ヘッドラインのみ(headline)、ヘッドライン+要約(abstract)、またはヘッドライン+全文(full)のいずれかを指定します

Available options:
full,
abstract,
headline
date
string

ニュース取得対象の日付。dateFromdateTo が同一の場合の省略形です。形式:yyyy-mm-dd

dateFrom
string

ある時点以降をクエリするための基準日。公開日でソートされます。形式: yyyy-mm-dd

dateTo
string

特定時点を指定してクエリするための日付。公開日順にソートされます。形式: yyyy-mm-dd

updatedSince
integer

取得および並べ替えの基準とする最新の更新日時(UTC)の Unix タイムスタンプ

publishedSince
integer

取得およびソートの基準とする最後に公開された Unix タイムスタンプ(UTC)

sort
enum<string>

結果のソート順を制御します。デフォルトは created の降順 (DESC) です。形式: field:direction。ソート可能なフィールド: id, created, updated。ソート順: asc (昇順), desc (降順)。

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

カンマ区切りのISIN(国際証券識別番号)を1件以上指定します。最大50件。形式: csv

cusips
string

1つ以上のCUSIPをカンマ区切りで指定します。最大50件まで。ライセンス契約が必要です。形式: CSV

tickers
string

カンマ区切りのtickerシンボルを1件以上指定します。最大50件。形式: CSV

primaryTickers
string

1つ以上の主要tickerシンボルをカンマ区切りで指定します。主要tickerの関連付けに対してのみフィルターされます。形式: csv

channels
string

カンマ区切りの1つ以上のチャンネル名またはID。形式: CSV

topics
string

カンマ区切りの1つ以上の単語またはフレーズ。Title、Tags、Body の順に優先して検索します。形式: CSV

topic_group_by
enum<string>
default:or

トピッククエリの論理演算子です。すべてのトピックを条件とする場合は and、いずれかのトピックが一致すればよい場合は or を使用します。

Available options:
and,
or
authors
string

カンマ区切りの1人以上の著者名。形式:CSV

content_types
string

カンマ区切りの 1 つ以上のコンテンツタイプ。フォーマット: csv

format
enum<string>

API レスポンスの出力形式を指定します

Available options:
text
importance
enum<string>

重要度で絞り込む

Available options:
low,
medium,
high
region
string

地域でフィルタリングします(例:カナダ向けコンテンツの場合は 'ca' または 'canada')。

Response

OK

author
string
Example:

"Benzinga Newsdesk"

body
string
channels
object[]
created
string
Example:

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

id
integer
Example:

123456

image
object[]
original_id
integer
stocks
object[]
tags
object[]
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"