News

Retrieve a paginated feed of news items. You can filter by ISINs, news group IDs, publication date range, categories, and a literal search term (q: headlines in all languages, asset names, ISINs and active secondary identifiers of any type, including tickers, WKNs and FIGIs). When multiple categories are selected, articles matching any selected category are returned. Omit categories or pass an empty array to include all categories.

post/news

Request

  • Base URL
    https://api.elbstream.com
  • URL
    https://api.elbstream.com/news
  • Auth
    HTTP bearer

Request body

lang'en' | 'de'

Language for headlines and summaries: English (en, default) or German (de)

isinsstring[]

Filter news by specific ISINs

news_group_idsstring[]

Filter news by specific news group IDs

categoriesstring[]

Return articles matching any selected category. Omit or pass an empty array to include all categories.

Supported categories:

  • analyst_rating — Analyst ratings of a company
  • challenge — Challenges or difficulties faced by a company
  • company_announcement — Corporate announcements excluding earnings
  • cyber_security — Cybersecurity incidents or developments
  • dividend_announcement — Dividend declarations or changes
  • earnings_report — Company quarterly or annual financial results
  • economic — News about economic indicators, policies, or trends
  • esg — Environmental, social, or governance news
  • executive_change — Executive appointments, departures, or other changes
  • failure — Failures or setbacks of a company
  • historical_performance — Historical stock performance of a company
  • industry_trend — Trends affecting specific industries
  • ipo — IPO or public offering information
  • legal — Legal proceedings or settlements
  • market_analysis — Analysis of market trends or conditions
  • merger_acquisition — News about mergers and acquisitions
  • other — Other financial news types
  • product_launch — New product or service announcements
  • regulatory — Regulatory developments or compliance issues
  • restructuring — Company restructuring or workforce reductions
  • stock_movement — Significant stock price changes
  • success — Successes or achievements of a company
  • trade_policy — News about trade policies or tariffs
qstring

Literal search term, case-insensitive. Matches headlines in all languages and asset names by substring, or the ISIN or any active secondary identifier by exact match. All secondary identifier types are supported, including tickers, WKNs and FIGIs. Combined with the other filters.

start_datestring date-time

Only return news published on or after this date and time

end_datestring date-time

Only return news published on or before this date and time

limitinteger

Maximum number of news groups to return

Response

Successfully retrieved news feed

Changes