보도자료

이 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

쉼표로 구분된 하나 이상의 국제증권식별번호(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

content_types · string · 기본값: accesswire_story,accesswire_pr,businesswire_story,newswire_pressreleases,newswire_story,globenewswire_story,newsfile_story

쉼표로 구분된 하나 이상의 콘텐츠 유형입니다. 형식: 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"