プレスリリース

このREST APIは、プレスリリースの構造化データを返します。最適なパフォーマンスを得るには、ティッカー、日付、チャネルなどのパラメータを使用してクエリ範囲を絞り込むか、差分取得にはupdatedSinceを使用してください。ページオフセットは0～100000に制限されています。

GET /api/v2/news

プレスリリース

cURL

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

Response (200 OK)

[
  {
    "id": 36444586,
    "author": "GlobeNewswire",
    "created": "Mon, 01 Jan 2024 13:35:14 -0400",
    "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
    "title": "Company XYZ Announces Q4 2023 Earnings Results and Strategic Initiatives",
    "teaser": "",
    "body": "",
    "url": "https://www.benzinga.com/pressreleases/24/01/g36444586/company-xyz-announces-q4-2023-earnings-results-and-strategic-initiatives",
    "image": [
      {
        "size": "thumb",
        "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/press_release_image.jpeg"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/press_release_image.jpeg"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/press_release_image.jpeg"
      }
    ],
    "channels": [
      {
        "name": "Press Releases"
      }
    ],
    "stocks": [
      {
        "name": "AAPL",
        "cusip": "037833100",
        "isin": "US0378331005",
        "exchange": "NASDAQ"
      }
    ],
    "tags": [
      {
        "name": "Press Release"
      }
    ]
  }
]

Response (200 OK)

[
  {
    "id": 36444586,
    "author": "GlobeNewswire",
    "created": "Mon, 01 Jan 2024 13:35:14 -0400",
    "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
    "title": "Company XYZ Announces Q4 2023 Earnings Results and Strategic Initiatives",
    "teaser": "",
    "body": "",
    "url": "https://www.benzinga.com/pressreleases/24/01/g36444586/company-xyz-announces-q4-2023-earnings-results-and-strategic-initiatives",
    "image": [
      {
        "size": "thumb",
        "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/press_release_image.jpeg"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/press_release_image.jpeg"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/press_release_image.jpeg"
      }
    ],
    "channels": [
      {
        "name": "Press Releases"
      }
    ],
    "stocks": [
      {
        "name": "AAPL",
        "cusip": "037833100",
        "isin": "US0378331005",
        "exchange": "NASDAQ"
      }
    ],
    "tags": [
      {
        "name": "Press Release"
      }
    ]
  }
]

承認

token · string · query · 必須

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

ヘッダー

accept · enum<string> · デフォルト: application/json · 必須

返却形式を指定

利用可能なオプション: application/json, application/xml

クエリパラメータ

page · integer · デフォルト: 0

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

pageSize · integer · デフォルト: 15

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

必須範囲: x <= 100

displayOutput · enum<string> · デフォルト: headline

見出しのみ（headline）、見出し＋要約（abstract）、または見出し＋本文全文（full）を指定

利用可能なオプション: full, abstract, headline

date · string

ニュースをクエリする日付。dateFromとdateToが同じ場合の省略指定です。形式: yyyy-mm-dd

dateFrom · string

クエリ開始日。公開日でソートされます。形式: yyyy-mm-dd

dateTo · string

クエリ終了日。公開日でソートされます。形式: yyyy-mm-dd

updatedSince · integer

取得およびソートに使用する最終更新のUnixタイムスタンプ（UTC）

publishedSince · integer

取得およびソートに使用する最終公開のUnixタイムスタンプ（UTC）

sort · enum<string>

結果の並べ替えを制御できます。デフォルトはcreated, DESCです。形式: field:direction。ソート項目: id, created, updated。ソート順: asc（昇順）、desc（降順）

利用可能なオプション: id:asc, id:desc, created:asc, created:desc, updated:asc, updated:desc

isin · string

カンマ区切りの1つ以上のISIN（国際証券識別番号）。最大50件。形式: csv

cusips · string

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

tickers · string

カンマ区切りの1つ以上のティッカーシンボル。最大50件。形式: csv

primaryTickers · string

カンマ区切りの1つ以上のプライマリティッカーシンボル。プライマリティッカーへの関連付けのみで絞り込みます。形式: csv

channels · string

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

topics · string

カンマ区切りの1つ以上の単語またはフレーズ。優先順位に従ってタイトル、タグ、本文を検索します。形式: csv

topic_group_by · enum<string> · デフォルト: or

topicsクエリの論理演算子。すべてのtopicsを必須にするには'and'、いずれかのtopicを必須にするには'or'を使用します

利用可能なオプション: and, or

authors · string

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

content_types · string · デフォルト: accesswire_story,accesswire_pr,businesswire_story,newswire_pressreleases,newswire_story,globenewswire_story,newsfile_story

カンマ区切りの1つ以上のコンテンツタイプ。形式: csv

format · enum<string>

APIレスポンスの形式を指定

利用可能なオプション: text

importance · enum<string>

重要度レベルで絞り込み

利用可能なオプション: low, medium, high

region · string

地域で絞り込み（例: カナダ向けコンテンツの場合は'ca'または'canada'）

レスポンス

200

application/json

成功

author · string

例:

"Benzinga Newsdesk"

body · string

channels · object[]

Show child attributes

created · string

例:

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

id · integer

例:

123456

image · object[]

Show child attributes

original_id · integer

stocks · object[]

Show child attributes

tags · object[]

Show child attributes

teaser · string

title · string

例:

"Apple Announces New iPhone"

updated · string

例:

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

url · string

例:

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