Skip to main content

Article Structure

News articles are delivered with the following data structure based on the official API:

Field Descriptions

Core Fields:
  • _id - Unique article identifier
  • title - Article headline (primary, usually English)
  • koTitle - Korean title (optional)
  • content - Article content or summary (optional; may be absent)
  • koContent - Korean content or summary (optional; may be absent)
  • url - Link to original article
  • date - Article date (ISO 8601 format)
Metadata:
  • source - News source name (always “byul.ai”)
  • timestamp - Unix timestamp
  • symbols - Related stock symbols array (optional)
Classification:
  • importanceScore - Market importance (0-10 integer, higher = more important)
  • category - News category
  • sentiment - Sentiment analysis result (“positive”, “negative”, “neutral”) (optional)

Receiving Data

Listen for incoming news articles:

WebSocket Response Format

The complete WebSocket response structure:

Data Validation

Always validate incoming data structure:

Language Support

Articles include multi-language titles:
  • title - Primary title (usually English)
  • koTitle - Korean version (optional)
Use the appropriate title field based on your application’s language requirements.