GET
/
news
Fetch News
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분기 실적 발표 후 주가 급등",
      "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
}

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

symbol
string

Stock symbol filter

Response

200
application/json

Successfully retrieved news articles

The response is of type object.