보도자료

이 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>'

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

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"
      }
    ]
  }
]

{
  "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"
    }
  ]
}

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"
      }
    ]
  }
]

{
  "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"
    }
  ]
}

인증

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

쉼표로 구분된 하나 이상의 국제증권식별번호(ISIN)입니다. 최대 50개입니다. 형식: csv

cusips · string

쉼표로 구분된 하나 이상의 CUSIP입니다. 최대 50개입니다. 라이선스 계약이 필요합니다. 형식: csv

tickers · string

쉼표로 구분된 하나 이상의 티커 심볼입니다. 최대 50개입니다. 형식: csv

primaryTickers · string

쉼표로 구분된 하나 이상의 기본 티커 심볼입니다. 기본 티커 연관 항목만 기준으로 필터링합니다. 형식: csv

channels · string

쉼표로 구분된 하나 이상의 채널 이름 또는 ID입니다. 형식: csv

topics · string

쉼표로 구분된 하나 이상의 단어/구문입니다. 우선순위에 따라 제목, 태그, 본문에서 검색합니다. 형식: csv

topic_group_by · enum<string> · 기본값: or

topics 쿼리의 논리 연산자입니다. 모든 topic이 필요하면 'and'를, 하나 이상의 topic이면 되면 'or'를 사용하세요.

사용 가능한 옵션: and, or

authors · string

쉼표로 구분된 하나 이상의 작성자입니다. 형식: 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"