finlight
App · News · 6 actions
Search financial news from finlight, which tags every article with the companies, countries and categories it is about and the sentiment it carries. Find articles by words, stock ticker, source, country or category, get only the articles added since the last run, read an article from its link, and measure how positive or negative the news about a company is. Needs a finlight API key; the free plan sees news 12 hours late.
Actions
| Action | What it does |
|---|---|
| Get article | Get one article finlight holds, from its link: headline, summary, source, publish time, categories, countries and sentiment, and the companies it mentions if you ask. |
| Get company news | Get the latest news articles about one or more companies, by stock ticker such as AAPL, newest first, with each headline, summary, source and link. |
| Get new articles | Get the articles finlight added after a time, oldest first, for a search you describe. |
| Get news sentiment | Count how many recent articles about a company or topic are positive, neutral or negative, with a net score from -1 to 1 and the most positive and negative headlines. |
| List sources | List the news sites finlight reads, with each one's country and languages and whether finlight searches it by default, optionally only those in one language. |
| Search articles | Search finlight's financial news by words, stock ticker, source, country, category, language and publish time, with each article's summary, link, source and categories: up to 100 at a time, newest first unless you choose another order. |
Get article
Get one article finlight holds, from its link: headline, summary, source, publish time, categories, countries and sentiment, and the companies it mentions if you ask.
Inputs
- Article link
linktextRequired - The article's web address, as a finlight search returns it in an article's Link.
- Include companies
include_companiestrue/false - Add the companies each article mentions, with their tickers, exchanges and ISINs. Needs finlight's Pro Light plan or higher.Default:
false.
Outputs
added_attext- When finlight added it, as an ISO 8601 UTC time. finlight sends it only when articles are ordered by it, as Get new articles orders them
categorieslist- finlight's categories for it, e.g. markets
companieslist- The companies it mentions, when Include companies is on
countrieslist- The countries it is about, as two-letter codes
image_urltext- A link to its first picture
imageslist- Links to its pictures
languagetext- Its language, as a two-letter code such as en
linktext- A link to the article, which Get article takes
published_attext- When it was published, as an ISO 8601 UTC time
revised_attext- When it was last revised, as an ISO 8601 UTC time, when finlight says
sentimenttext- positive, neutral or negative. Empty unless your plan includes sentiment (Pro Standard or higher)
sentiment_confidencenumber- How sure finlight is of that sentiment, from 0 to 1
sourcetext- The site that published it, e.g. www.reuters.com
summarytext- A summary of the article, where finlight has one
tickerslist- The tickers of those companies
titletext- The headline
Example output
{
"added_at": null,
"categories": [
"markets",
"economy"
],
"companies": [
{
"company_id": 1834,
"confidence": 0.93,
"country": "US",
"exchange": "XNYS",
"industry": "Banks",
"isin": "US46625H1005",
"isins": [
"US46625H1005"
],
"name": "JPMorgan Chase & Co.",
"openfigi": null,
"other_listings": [],
"primary_listing": {
"country": "US",
"exchange": "XNYS",
"ticker": "JPM"
},
"sector": "Finance",
"ticker": "JPM"
}
],
"countries": [
"US"
],
"image_url": "https://www.reuters.com/resizer/v2/banks-wall-street.jpg",
"images": [
"https://www.reuters.com/resizer/v2/banks-wall-street.jpg"
],
"language": "en",
"link": "https://www.reuters.com/markets/us/fed-signals-pause-banks-rally-2026-09-29/",
"published_at": "2026-09-29T15:20:00Z",
"revised_at": "2026-09-29T19:02:11Z",
"sentiment": "positive",
"sentiment_confidence": 0.86,
"source": "www.reuters.com",
"summary": "Shares of the largest US lenders rose after Federal Reserve officials said rates would likely hold steady for now.",
"tickers": [
"JPM"
],
"title": "Bank stocks rally as the Fed signals a pause"
}Get company news
Get the latest news articles about one or more companies, by stock ticker such as AAPL, newest first, with each headline, summary, source and link.
Inputs
- Stock tickers
tickerslistRequired - The companies to get news about, by stock ticker, such as AAPL for Apple. finlight also reads a ticker with its exchange, such as 7203.T or SAP.DE. An article about any of them counts.
- Published after
published_afterdate and time - Only articles published at or after this time. Leave blank to go as far back as your plan reaches: a month on the free plan.
- Published before
published_beforedate and time - Only articles published before this time. Leave blank for up to now.
- Language
languagetext - The language of the articles. finlight searches one language at a time; leave blank for English.
- Maximum articles
limitnumber - The most articles to return, from 1 to 100. Leave blank for 20.From 1 to 100.
- Include companies
include_companiestrue/false - Add the companies each article mentions, with their tickers, exchanges and ISINs. Needs finlight's Pro Light plan or higher.Default:
false.
Outputs
article_countnumber- How many articles there are
articleslist- The articles, newest first
has_moretrue/false- True when the maximum came back, so there may be more to fetch
languagetext- The language searched, as a two-letter code
tickerslist- The tickers asked about
Example output
{
"article_count": 2,
"articles": [
{
"added_at": null,
"categories": [
"business",
"technology"
],
"companies": [],
"countries": [
"US"
],
"image_url": "https://static.seekingalpha.com/cdn/s3/uploads/apple-park.jpg",
"images": [
"https://static.seekingalpha.com/cdn/s3/uploads/apple-park.jpg"
],
"language": "en",
"link": "https://seekingalpha.com/news/4512345-apple-services-revenue-record",
"published_at": "2026-09-30T07:12:44Z",
"revised_at": null,
"sentiment": "positive",
"sentiment_confidence": 0.89,
"source": "seekingalpha.com",
"summary": "Analysts expect App Store and subscription growth to carry Apple's services business to a new high.",
"tickers": [],
"title": "Apple's services revenue heads for another record quarter"
},
{
"added_at": null,
"categories": [
"business"
],
"companies": [],
"countries": [
"CN",
"US"
],
"image_url": null,
"images": [],
"language": "en",
"link": "https://finance.yahoo.com/news/apple-iphone-demand-china-2026-09-29.html",
"published_at": "2026-09-29T16:40:03Z",
"revised_at": null,
"sentiment": "negative",
"sentiment_confidence": 0.74,
"source": "finance.yahoo.com",
"summary": "Apple's share of China's smartphone market slipped in September as local brands discounted their flagship phones.",
"tickers": [],
"title": "iPhone demand in China cools as rivals cut prices"
}
],
"has_more": false,
"language": "en",
"tickers": [
"AAPL"
]
}Get new articles
Get the articles finlight added after a time, oldest first, for a search you describe. Returns when the newest one was added, so a scheduled workflow can pass it back next time and get only what is new.
Inputs
- Search for
querytext - Words to look for. Put a phrase in double quotes to match it exactly, combine words with AND, OR, NOT and brackets, and name a field to search only it, such as ticker:AAPL, source:www.reuters.com or title:earnings. Leave blank for every article.
- Stock tickers
tickerslist - Only articles about these companies, by stock ticker, such as AAPL or NVDA. finlight also reads a ticker with its exchange, such as 7203.T, SAP.DE or NASDAQ:AAPL. Leave blank for every company.
- Only these sources
sourceslist - Only articles from these news sites. Leave blank for the sources finlight searches by default; the ones marked only when chosen are searched only when picked here.
- Leave out these sources
exclude_sourceslist - Never return articles from these news sites.
- About these countries
countrieslist - Only articles about these countries, as two-letter codes such as US, GB or DE. It is the country a story is about, not where it was published. Leave blank for every country.
- Categories
categorieslist - Only articles in these categories. Choose none for every category.One or more of:
markets,economy,business,politics,geopolitics,regulation,technology,energy,commodities,crypto, and 3 more. - Language
languagetext - The language of the articles. finlight searches one language at a time; leave blank for English.
- Added after
added_afterdate and time - Only articles finlight added after this time. To get only what is new since the last run, pass in the Latest added at an earlier run of this step returned. Leave blank for the latest articles.
- Maximum articles
limitnumber - The most articles to return, from 1 to 100. Leave blank for 20. When more were added, the oldest come back and the rest wait for the next run.From 1 to 100.
Outputs
added_aftertext- The time the articles were added after, when one was given
article_countnumber- How many articles there are
articleslist- The articles finlight added since then, oldest first
has_moretrue/false- True when more articles were added than came back. The next run, given Latest added at, continues with them
latest_added_attext- When the newest of them was added. Pass it as Added after next time to get only newer ones; it is unchanged when nothing new came in
Example output
{
"added_after": "2026-09-30T09:00:00Z",
"article_count": 3,
"articles": [
{
"added_at": "2026-09-30T09:03:51.120Z",
"categories": [
"economy",
"markets"
],
"companies": [],
"countries": [
"US"
],
"image_url": null,
"images": [],
"language": "en",
"link": "https://www.cnbc.com/2026/09/30/treasury-yields-fed-speakers.html",
"published_at": "2026-09-30T09:01:10Z",
"revised_at": null,
"sentiment": "neutral",
"sentiment_confidence": 0.8,
"source": "www.cnbc.com",
"summary": "The 10-year yield dipped as investors waited for comments from Federal Reserve officials.",
"tickers": [],
"title": "Treasury yields edge lower ahead of a busy day of Fed speakers"
},
{
"added_at": "2026-09-30T10:18:44Z",
"categories": [
"economy"
],
"companies": [],
"countries": [
"US"
],
"image_url": "https://www.ft.com/__origami/service/image/fed-building.jpg",
"images": [
"https://www.ft.com/__origami/service/image/fed-building.jpg"
],
"language": "en",
"link": "https://www.ft.com/content/fed-balance-sheet-runoff-2026",
"published_at": "2026-09-30T06:30:00Z",
"revised_at": null,
"sentiment": "neutral",
"sentiment_confidence": 0.66,
"source": "www.ft.com",
"summary": "Minutes show officials discussed stopping the drawdown of Treasury holdings sooner than planned.",
"tickers": [],
"title": "Federal Reserve weighs an early end to balance sheet runoff"
},
{
"added_at": "2026-09-30T11:42:07.315Z",
"categories": [
"economy",
"politics"
],
"companies": [],
"countries": [
"US"
],
"image_url": null,
"images": [],
"language": "en",
"link": "https://www.bloomberg.com/news/articles/2026-09-30/fed-officials-split-on-october-cut",
"published_at": "2026-09-30T11:30:00Z",
"revised_at": null,
"sentiment": "neutral",
"sentiment_confidence": 0.71,
"source": "www.bloomberg.com",
"summary": "Two Federal Reserve governors argued for patience while a third said inflation data leaves room for another cut.",
"tickers": [],
"title": "Fed officials split on whether to cut again in October"
}
],
"has_more": false,
"latest_added_at": "2026-09-30T11:42:07.315Z"
}Get news sentiment
Count how many recent articles about a company or topic are positive, neutral or negative, with a net score from -1 to 1 and the most positive and negative headlines. Reads up to 100 articles from the last 7 days unless you set times. Needs finlight's Pro Standard plan or higher.
Inputs
- Search for
querytext - Words to look for. Put a phrase in double quotes to match it exactly, combine words with AND, OR, NOT and brackets, and name a field to search only it, such as ticker:AAPL, source:www.reuters.com or title:earnings. Leave blank for every article.
- Stock tickers
tickerslist - Only articles about these companies, by stock ticker, such as AAPL or NVDA. finlight also reads a ticker with its exchange, such as 7203.T, SAP.DE or NASDAQ:AAPL. Leave blank for every company.
- Published after
published_afterdate and time - The start of the time to measure. Leave blank for 7 days before the end.
- Published before
published_beforedate and time - The end of the time to measure. Leave blank for now.
- Language
languagetext - The language of the articles. finlight searches one language at a time; leave blank for English.
- Articles to read
sample_sizenumber - How many of the newest matching articles to measure, from 1 to 100. Leave blank for 100.From 1 to 100.
Outputs
article_countnumber- How many articles were read
average_confidencenumber- How sure finlight is of the sentiments, on average
languagetext- The language searched, as a two-letter code
most_negativelist- The negative articles finlight is surest of, up to 3
most_positivelist- The positive articles finlight is surest of, up to 3
negative_countnumber- How many are negative
negative_percentnumber- The share that is negative, as a percentage
net_sentimentnumber- Positive less negative, as a share of the articles: from -1 (all negative) to 1 (all positive)
neutral_countnumber- How many are neutral
neutral_percentnumber- The share that is neutral, as a percentage
overall_sentimenttext- positive or negative when the net sentiment leans past 0.1 either way, neutral otherwise; empty when no articles matched
positive_countnumber- How many are positive
positive_percentnumber- The share that is positive, e.g. 40.5 for 40.5%
published_aftertext- The start of the time measured, ISO 8601 UTC
published_beforetext- The end of the time measured, ISO 8601 UTC
querytext- The words searched for
tickerslist- The tickers searched for
unscored_countnumber- How many of them finlight gave no sentiment
Example output
{
"article_count": 5,
"average_confidence": 0.76,
"language": "en",
"most_negative": [
{
"link": "https://www.reuters.com/business/autos/tesla-recall-2026-09-29/",
"published_at": "2026-09-29T18:20:00Z",
"sentiment_confidence": 0.88,
"source": "www.reuters.com",
"title": "Tesla recalls 120,000 vehicles over a seat belt warning fault"
}
],
"most_positive": [
{
"link": "https://www.cnbc.com/2026/09/30/tesla-deliveries-beat-estimates.html",
"published_at": "2026-09-30T10:02:00Z",
"sentiment_confidence": 0.91,
"source": "www.cnbc.com",
"title": "Tesla deliveries set to beat estimates on strong September"
},
{
"link": "https://seekingalpha.com/news/4512001-tesla-robotaxi-expansion",
"published_at": "2026-09-28T13:45:00Z",
"sentiment_confidence": 0.77,
"source": "seekingalpha.com",
"title": "Tesla widens its robotaxi service to two more cities"
},
{
"link": "https://finance.yahoo.com/news/tesla-energy-storage-growth-2026-09-24.html",
"published_at": "2026-09-24T11:15:00Z",
"sentiment_confidence": 0.58,
"source": "finance.yahoo.com",
"title": "Tesla's energy storage business grows faster than its cars"
}
],
"negative_count": 1,
"negative_percent": 20.0,
"net_sentiment": 0.4,
"neutral_count": 1,
"neutral_percent": 20.0,
"overall_sentiment": "positive",
"positive_count": 3,
"positive_percent": 60.0,
"published_after": "2026-09-23T12:00:00Z",
"published_before": "2026-09-30T12:00:00Z",
"query": null,
"tickers": [
"TSLA"
],
"unscored_count": 0
}List sources
List the news sites finlight reads, with each one's country and languages and whether finlight searches it by default, optionally only those in one language.
Inputs
- Language
languagetext - Only sources that publish in this language. Leave blank for all.
Outputs
default_source_countnumber- How many of them finlight searches by default
languagetext- The language the sources were narrowed to, if any
source_countnumber- How many sources there are
sourceslist- The sources, in alphabetical order
Example output
{
"default_source_count": 4,
"language": null,
"source_count": 7,
"sources": [
{
"domain": "www.cnbc.com",
"is_custom": false,
"is_default": true,
"languages": [
"en"
],
"origin_country": "US"
},
{
"domain": "www.handelsblatt.com",
"is_custom": false,
"is_default": false,
"languages": [
"de",
"en"
],
"origin_country": "DE"
},
{
"domain": "www.nikkei.com",
"is_custom": false,
"is_default": false,
"languages": [
"ja",
"en"
],
"origin_country": "JP"
},
{
"domain": "research.acme-capital.com",
"is_custom": true,
"is_default": false,
"languages": [
"en"
],
"origin_country": null
},
{
"domain": "www.reuters.com",
"is_custom": false,
"is_default": true,
"languages": [
"en"
],
"origin_country": "GB"
},
{
"domain": "seekingalpha.com",
"is_custom": false,
"is_default": true,
"languages": [
"en"
],
"origin_country": "US"
},
{
"domain": "www.yicai.com",
"is_custom": false,
"is_default": true,
"languages": [
"zh"
],
"origin_country": "CN"
}
]
}Search articles
Search finlight's financial news by words, stock ticker, source, country, category, language and publish time, with each article's summary, link, source and categories: up to 100 at a time, newest first unless you choose another order.
Inputs
- Search for
querytext - Words to look for. Put a phrase in double quotes to match it exactly, combine words with AND, OR, NOT and brackets, and name a field to search only it, such as ticker:AAPL, source:www.reuters.com or title:earnings. Leave blank for every article.
- Stock tickers
tickerslist - Only articles about these companies, by stock ticker, such as AAPL or NVDA. finlight also reads a ticker with its exchange, such as 7203.T, SAP.DE or NASDAQ:AAPL. Leave blank for every company.
- Only these sources
sourceslist - Only articles from these news sites. Leave blank for the sources finlight searches by default; the ones marked only when chosen are searched only when picked here.
- Leave out these sources
exclude_sourceslist - Never return articles from these news sites.
- About these countries
countrieslist - Only articles about these countries, as two-letter codes such as US, GB or DE. It is the country a story is about, not where it was published. Leave blank for every country.
- Categories
categorieslist - Only articles in these categories. Choose none for every category.One or more of:
markets,economy,business,politics,geopolitics,regulation,technology,energy,commodities,crypto, and 3 more. - Language
languagetext - The language of the articles. finlight searches one language at a time; leave blank for English.
- Published after
published_afterdate and time - Only articles published at or after this time. Leave blank to go as far back as your plan reaches: a month on the free plan.
- Published before
published_beforedate and time - Only articles published before this time. Leave blank for up to now.
- Order
sorttext - Which articles come first.One of:
newest(Newest first),oldest(Oldest first),recently_added(Most recently added to finlight),recently_revised(Most recently revised). Default:newest. - Maximum articles
limitnumber - The most articles to return, from 1 to 100. Leave blank for 20.From 1 to 100.
- Page
pagenumber - Which page of results to return, 1 for the first. With 20 articles to a page, page 2 holds the 21st to the 40th.At least 1. Default:
1. - Include companies
include_companiestrue/false - Add the companies each article mentions, with their tickers, exchanges and ISINs. Needs finlight's Pro Light plan or higher.Default:
false.
Outputs
article_countnumber- How many articles there are
articleslist- The articles, in the order asked for
has_moretrue/false- True when the page came back full, so the next page may hold more
languagetext- The language searched, as a two-letter code
pagenumber- The page returned
page_sizenumber- The most articles a page holds
querytext- The words searched for
Example output
{
"article_count": 3,
"articles": [
{
"added_at": null,
"categories": [
"markets",
"technology"
],
"companies": [
{
"company_id": 4157,
"confidence": 0.97,
"country": "US",
"exchange": "XNAS",
"industry": "Semiconductors",
"isin": "US67066G1040",
"isins": [
"US67066G1040"
],
"name": "NVIDIA Corporation",
"openfigi": "BBG000BBJQV0",
"other_listings": [
{
"country": "DE",
"exchange": "XETR",
"ticker": "NVD.DE"
}
],
"primary_listing": {
"country": "US",
"exchange": "XNAS",
"ticker": "NVDA"
},
"sector": "Technology",
"ticker": "NVDA"
}
],
"countries": [
"US"
],
"image_url": "https://image.cnbcfm.com/api/v1/image/108214566-nvidia-hq.jpg",
"images": [
"https://image.cnbcfm.com/api/v1/image/108214566-nvidia-hq.jpg"
],
"language": "en",
"link": "https://www.cnbc.com/2026/09/29/nvidia-data-center-demand-lifts-outlook.html",
"published_at": "2026-09-29T14:05:12Z",
"revised_at": null,
"sentiment": "positive",
"sentiment_confidence": 0.94,
"source": "www.cnbc.com",
"summary": "Nvidia raised its outlook for the quarter after orders for its data center chips outran supply, sending the shares higher in early trading.",
"tickers": [
"NVDA"
],
"title": "Nvidia climbs as data center demand lifts its earnings outlook"
},
{
"added_at": null,
"categories": [
"technology"
],
"companies": [
{
"company_id": 4157,
"confidence": 0.91,
"country": "US",
"exchange": "XNAS",
"industry": "Semiconductors",
"isin": "US67066G1040",
"isins": [
"US67066G1040"
],
"name": "NVIDIA Corporation",
"openfigi": "BBG000BBJQV0",
"other_listings": [
{
"country": "DE",
"exchange": "XETR",
"ticker": "NVD.DE"
}
],
"primary_listing": {
"country": "US",
"exchange": "XNAS",
"ticker": "NVDA"
},
"sector": "Technology",
"ticker": "NVDA"
},
{
"company_id": 7721,
"confidence": 0.88,
"country": "TW",
"exchange": "XTAI",
"industry": "Semiconductors",
"isin": "TW0002330008",
"isins": [
"TW0002330008"
],
"name": "Taiwan Semiconductor Manufacturing Company Limited",
"openfigi": null,
"other_listings": [
{
"country": "US",
"exchange": "XNYS",
"ticker": "TSM"
}
],
"primary_listing": {
"country": "TW",
"exchange": "XTAI",
"ticker": "2330"
},
"sector": "Technology",
"ticker": "2330"
}
],
"countries": [
"US",
"TW"
],
"image_url": null,
"images": [],
"language": "en",
"link": "https://www.reuters.com/technology/nvidia-suppliers-brace-earnings-2026-09-29/",
"published_at": "2026-09-29T09:41:00Z",
"revised_at": null,
"sentiment": "neutral",
"sentiment_confidence": 0.81,
"source": "www.reuters.com",
"summary": null,
"tickers": [
"NVDA",
"2330"
],
"title": "Nvidia suppliers brace for earnings as chip orders stretch into 2027"
},
{
"added_at": null,
"categories": [
"markets"
],
"companies": [
{
"company_id": 4157,
"confidence": 0.95,
"country": "US",
"exchange": "XNAS",
"industry": "Semiconductors",
"isin": "US67066G1040",
"isins": [
"US67066G1040"
],
"name": "NVIDIA Corporation",
"openfigi": "BBG000BBJQV0",
"other_listings": [
{
"country": "DE",
"exchange": "XETR",
"ticker": "NVD.DE"
}
],
"primary_listing": {
"country": "US",
"exchange": "XNAS",
"ticker": "NVDA"
},
"sector": "Technology",
"ticker": "NVDA"
}
],
"countries": [
"US",
"CN"
],
"image_url": "https://images.mktw.net/im-nvidia-export.jpg",
"images": [
"https://images.mktw.net/im-nvidia-export.jpg",
"https://images.mktw.net/im-nvidia-chart.jpg"
],
"language": "en",
"link": "https://www.marketwatch.com/story/nvidia-slips-on-export-worries-2026-09-28",
"published_at": "2026-09-28T22:15:30Z",
"revised_at": null,
"sentiment": "negative",
"sentiment_confidence": 0.62,
"source": "www.marketwatch.com",
"summary": "Shares of Nvidia fell after reports that new export rules could cut into sales to China in the coming quarters.",
"tickers": [
"NVDA"
],
"title": "Nvidia slips as investors weigh export limits ahead of earnings"
}
],
"has_more": true,
"language": "en",
"page": 1,
"page_size": 3,
"query": "Nvidia earnings"
}