finlight Logo

Monday, July 21, 2025

Precision at Scale: Mastering Advanced Queries with finlight API v2

Finlight - Content Manager

We at finlight spend a lot of time exploring how we can make financial news more actionable — not just accessible.

With the launch of finlight API v2, we’ve introduced a major upgrade: advanced querying with field:value filters and full Boolean logic.

If you’re a developer, data engineer, or fintech builder who needs to filter just the right market news — this feature is for you.

Let’s dive into how it works, how to use it, and why it matters for anyone working with financial data, market intelligence, or real-time alerts.

What Are Advanced Queries?

In finlight API v2, you can now use the query parameter in a structured way, thanks to our new field:value syntax.

This means you can search directly within specific fields — like tickers, ISINs, exchanges, and sources — for pinpoint-accurate results.

For example:

{
"query": "ticker:NVDA AND source:
www.cnbc.com"
}

This fetches all articles that mention NVIDIA and were published by cnbc.

✅ Supported Fields

You can use the following fields inside the query parameter:

FieldDescription
tickerCompany ticker (e.g., AAPL, NVDA)
isinInternational Securities ID Number
openfigiFinancial Instrument Global Identifier
exchangeMarket/exchange name
sourceArticle source domain
💡 Full list of exchanges includes:
NASDAQ, NYSE, LONDON_STOCK_EXCHANGE, FRANKFURT_STOCK_EXCHANGE, EURONEXT_STOCK_EXCHANGE, TOKYO_STOCK_EXCHANGE, SHANGHAI_STOCK_EXCHANGE, and more.

You can find all supported field values and examples in our official docs here:
👉 https://docs.finlight.me


Combine with Boolean Logic

Just like you’d expect from a modern search API, finlight v2 supports:

  • AND – Require multiple conditions
  • OR – Match any of several conditions
  • NOT – Exclude something
  • () – Group complex expressions
  • -field:value – Shortcut for NOT

🧪 Example 1: Use AND and OR

{
"query": "(ticker:AAPL OR ticker:MSFT) AND source:
www.cnbc.com"
}
Returns articles from cnbc about either Apple or Microsoft.

🧪 Example 2: Exclude with NOT or -

{
"query": "ticker:TSLA AND NOT source:yahoo.com"
}

Or just:
{
"query": "ticker:TSLA -source:yahoo.com"
}

Both queries remove Yahoo Finance content from Tesla-related results. Clean and simple.


Why Advanced Querying Matters

Whether you're building a trading platform, market sentiment engine, portfolio tracker, or just trying to monitor relevant events — granular control over your news stream is a competitive advantage.

With finlight’s field:value and Boolean support, you can:

  • 🎯 Target specific tickers or sectors
  • 🌍 Filter news exchange
  • 🧹 Exclude noisy or duplicate sources
  • 📊 Focus your models on high-quality inputs

It’s fast, clean, and designed for scale.


Start Using Advanced Queries Today

You can test everything in our fully updated API playground, or implement it directly via:


Final Thoughts

Advanced querying isn’t just for data scientists — it’s for every developer who wants to build smarter, more relevant products in finance.

We built this to give you speed, flexibility, and control, without the complexity.

Go ahead, test it out — and let us know what you're building. We're here to help.

See you in the next post! 👋

Advanced News Filtering with finlight API v2: Ticker, Source & Boolean Queries - finlight.me