Thursday, July 24, 2025
How to Filter: Smarter Company-Based Filtering with finlight API
Financial news should be relevant, not overwhelming. That’s why finlight has introduced a major upgrade in API v2 — the ability to extract and filter articles by stock tickers.
With markets moving faster than ever, analysts, developers, and fintech platforms need a better way to surface company-specific information. finlight now enables users to:
- 🏷️ Detect company mentions and ticker symbols in articles
- 🔍 Filter content by
ticker
,ISIN
,openfigi
,exchange
, orsource
using advanced queries - 📊 Tailor feeds, dashboards, or alerts around specific stocks or instruments
Here’s how it works — and how easily it can be implemented in your own stack.
Ticker-Based Querying
finlight now supports field-specific filters inside the main query
parameter. That means you can query using:
ticker:AAPL
isin:US0378331005
exchange:NASDAQ
source:bloomberg.com
- and more ...
Each article in the response can also include enriched company entity metadata when includeEntities: true
is enabled.
Example query:
{
"query": "ticker:MSFT",
"includeEntities": true
}
This returns Microsoft-related articles with company data embedded in the response.
Use Cases: Why Ticker Filtering Matters
📰 1. Build Personalized News Feeds
Filter the API to only return articles that mention a specific watchlist of stocks.
{
"query": "(ticker:AAPL OR ticker:AMZN OR ticker:NFLX)",
"order": "DESC",
"pageSize": 20
}
This creates a clean, focused feed — perfect for news dashboards or portfolio integrations.
🔔 2. Trigger Alerts for Specific Stocks
Set up Slack, email, or in-app alerts only when news for a given stock hits.
// Using axios
axios.post('https://api.finlight.me/v2/articles', {
query: "ticker:NVDA",
includeEntities: true
}, {
headers: { 'X-API-KEY': 'YOUR_API_KEY' }
}).then(res => {
// Notify users
});
📊 3. Track Article Volume or Sentiment Over Time
Combine ticker
queries with date filters to analyze market-moving news patterns.
{
"query": "ticker:TSLA",
"from": "2025-07-01",
"to": "2025-07-10"
}
Perfect for quant teams or analysts tracking media sentiment and news flow.
Advanced Filtering with Boolean Logic
finlight supports advanced logic inside the query
parameter using:
AND
,OR
,NOT
()
to group expressions-
prefix to exclude fields (-source:yahoo.com
is the same asNOT source:yahoo.com
)
Example:
{
"query": "(ticker:AAPL OR ticker:MSFT) AND -source:yahoo.com"
}
This returns Apple or Microsoft news, excluding Yahoo Finance sources.
Combine with Exchanges and Sources
Ticker filtering can be combined with other field-based filters for highly specific results.
Example 1: NASDAQ tickers only
{
"query": "exchange:NASDAQ AND ticker:NVDA"
}
Example 2: European stocks, excluding Yahoo
{
"query": "(exchange:FRANKFURT_STOCK_EXCHANGE OR exchange:EURONEXT_STOCK_EXCHANGE) -source:yahoo.com"
}
📘 Learn More
You can explore all the supported fields and filtering logic in the official documentation:
🔗 finlight API v2 Documentation – Query Filtering
Final thoughts: Start Filtering Smarter
Ticker-based filtering is now live for all paid finlight API users. Whether you're building market dashboards, personal finance tools, or alerting systems — this feature helps you cut through the noise and stay focused on the companies that matter.
Try it now with your API key in: