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`, 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:

• 🧪 API Playground
• 📦 `finlight-client` npm package