Skip to main content
GET
/
news
Fetch
curl --request GET \
  --url https://api.byul.ai/api/v2/news \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "_id": "67850d7b0123456789abcdef",
      "title": "Tesla Stock Surges After Q4 Earnings Beat",
      "koTitle": "테슬라 4분기 실적 발표 후 주가 급등",
      "content": "Tesla Inc. reported stronger-than-expected Q4 2024 earnings, with revenue beating analyst estimates by 8%. The electric vehicle maker delivered 484,507 vehicles in Q4, up 15% year-over-year, driving shares up 12% in after-hours trading.",
      "koContent": "테슬라가 2024년 4분기 실적에서 애널리스트 예상치를 8% 상회하는 매출을 기록했습니다. 이 전기차 제조업체는 4분기에 484,507대를 인도하며 전년 대비 15% 증가했고, 시간외 거래에서 주가가 12% 상승했습니다.",
      "url": "https://www.byul.ai/news/tesla-earnings-q4-2024",
      "date": "2024-01-15T10:30:00.000Z",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "source": "byul.ai",
      "timestamp": 1705401000,
      "importanceScore": 8,
      "category": "earnings",
      "symbols": [
        "TSLA"
      ],
      "sentiment": "positive"
    }
  ],
  "nextCursor": "67850d7b0123456789abcde0",
  "hasMore": true
}
This endpoint supports date range filtering via startDate and endDate (ISO 8601).

Authorizations

X-API-Key
string
header
required

API key authentication. Get your API key from https://www.byul.ai/api/dashboard

Query Parameters

limit
integer
default:10

Number of articles to return

Required range: 1 <= x <= 100
cursor
string

Pagination cursor for next page

sinceId
string

Fetch articles after this ID

minImportance
integer
default:1

Minimum importance level

Required range: 1 <= x <= 10
q
string

Search query for filtering articles

startDate
string<date-time>

Start of date range (ISO 8601)

endDate
string<date-time>

End of date range (ISO 8601)

symbol
string

Stock symbol filter

Response

Successfully retrieved news articles

items
object[]
required

Array of news articles

hasMore
boolean
required

Whether additional pages are available

Example:

true

nextCursor
string | null

Cursor for next page (only when hasMore is true, can be null)

Example:

"67850d7b0123456789abcde0"