뉴스

이 REST API는 뉴스에 대한 구조화된 데이터를 반환합니다. 최적의 성능을 위해 tickers, date, channels와 같은 파라미터를 사용해 쿼리 범위를 제한하거나, 증분 데이터의 경우 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": "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"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/options_image_2.jpeg"
      }
    ],
    "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"
      }
    ]
  }
]

Response (200 OK)

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

인증

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) 1개 이상. 최대 50개. 형식: csv

cusips · string

하나 이상의 CUSIP을 쉼표로 구분하여 입력합니다. 최대 50개까지 입력할 수 있습니다. 라이선스 계약이 필요합니다. 형식: csv

tickers · string

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

primaryTickers · string

하나 이상의 기본 티커 심볼을 쉼표(,)로 구분해 지정합니다. 기본 티커 기준으로만 필터링합니다. 형식: CSV

channels · string

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

topics · string

쉼표로 구분된 하나 이상의 단어나 구; 우선순위에 따라 Title, Tags, Body를 순서대로 검색합니다. 형식: CSV

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

토픽 쿼리에서 사용하는 논리 연산자입니다. 모든 토픽이 모두 만족되어야 할 경우에는 'and', 하나라도 만족하면 되는 경우에는 'or'를 사용하세요

사용 가능한 옵션: and, or

authors · string

쉼표로 구분된 하나 이상의 작성자 이름. 형식: CSV

content_types · 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[]

표시 하위 속성

created · string

예시:

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

id · integer

예시:

123456

image · object[]

표시 하위 속성

original_id · integer

stocks · object[]

표시 하위 속성

tags · object[]

표시 하위 속성

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"