finlight Logo

Thursday, July 24, 2025

How to Filter: Smarter Company-Based Filtering with finlight API

Finlight - Content Manager

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, or source 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 as NOT 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:

How to Filter Financial News by Ticker Using finlight API - finlight.me