# finlight > 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. App · News · 6 actions. Web page: https://docs.lodol.com/docs/integrations/finlight ## Actions ### 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 (`link`, text, required): The article's web address, as a finlight search returns it in an article's Link. - Include companies (`include_companies`, true/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_at` (text): 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 - `categories` (list): finlight's categories for it, e.g. markets - `companies` (list): The companies it mentions, when Include companies is on - `countries` (list): The countries it is about, as two-letter codes - `image_url` (text): A link to its first picture - `images` (list): Links to its pictures - `language` (text): Its language, as a two-letter code such as en - `link` (text): A link to the article, which Get article takes - `published_at` (text): When it was published, as an ISO 8601 UTC time - `revised_at` (text): When it was last revised, as an ISO 8601 UTC time, when finlight says - `sentiment` (text): positive, neutral or negative. Empty unless your plan includes sentiment (Pro Standard or higher) - `sentiment_confidence` (number): How sure finlight is of that sentiment, from 0 to 1 - `source` (text): The site that published it, e.g. www.reuters.com - `summary` (text): A summary of the article, where finlight has one - `tickers` (list): The tickers of those companies - `title` (text): The headline **Example output** ```json { "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 (`tickers`, list, required): 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_after`, date 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_before`, date and time): Only articles published before this time. Leave blank for up to now. - Language (`language`, text): The language of the articles. finlight searches one language at a time; leave blank for English. - Maximum articles (`limit`, number): The most articles to return, from 1 to 100. Leave blank for 20. From 1 to 100. - Include companies (`include_companies`, true/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_count` (number): How many articles there are - `articles` (list): The articles, newest first - `has_more` (true/false): True when the maximum came back, so there may be more to fetch - `language` (text): The language searched, as a two-letter code - `tickers` (list): The tickers asked about **Example output** ```json { "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 (`query`, text): 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 (`tickers`, list): 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 (`sources`, list): 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_sources`, list): Never return articles from these news sites. - About these countries (`countries`, list): 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 (`categories`, list): 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 (`language`, text): The language of the articles. finlight searches one language at a time; leave blank for English. - Added after (`added_after`, date 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 (`limit`, number): 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_after` (text): The time the articles were added after, when one was given - `article_count` (number): How many articles there are - `articles` (list): The articles finlight added since then, oldest first - `has_more` (true/false): True when more articles were added than came back. The next run, given Latest added at, continues with them - `latest_added_at` (text): 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** ```json { "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 (`query`, text): 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 (`tickers`, list): 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_after`, date and time): The start of the time to measure. Leave blank for 7 days before the end. - Published before (`published_before`, date and time): The end of the time to measure. Leave blank for now. - Language (`language`, text): The language of the articles. finlight searches one language at a time; leave blank for English. - Articles to read (`sample_size`, number): How many of the newest matching articles to measure, from 1 to 100. Leave blank for 100. From 1 to 100. **Outputs** - `article_count` (number): How many articles were read - `average_confidence` (number): How sure finlight is of the sentiments, on average - `language` (text): The language searched, as a two-letter code - `most_negative` (list): The negative articles finlight is surest of, up to 3 - `most_positive` (list): The positive articles finlight is surest of, up to 3 - `negative_count` (number): How many are negative - `negative_percent` (number): The share that is negative, as a percentage - `net_sentiment` (number): Positive less negative, as a share of the articles: from -1 (all negative) to 1 (all positive) - `neutral_count` (number): How many are neutral - `neutral_percent` (number): The share that is neutral, as a percentage - `overall_sentiment` (text): positive or negative when the net sentiment leans past 0.1 either way, neutral otherwise; empty when no articles matched - `positive_count` (number): How many are positive - `positive_percent` (number): The share that is positive, e.g. 40.5 for 40.5% - `published_after` (text): The start of the time measured, ISO 8601 UTC - `published_before` (text): The end of the time measured, ISO 8601 UTC - `query` (text): The words searched for - `tickers` (list): The tickers searched for - `unscored_count` (number): How many of them finlight gave no sentiment **Example output** ```json { "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 (`language`, text): Only sources that publish in this language. Leave blank for all. **Outputs** - `default_source_count` (number): How many of them finlight searches by default - `language` (text): The language the sources were narrowed to, if any - `source_count` (number): How many sources there are - `sources` (list): The sources, in alphabetical order **Example output** ```json { "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 (`query`, text): 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 (`tickers`, list): 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 (`sources`, list): 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_sources`, list): Never return articles from these news sites. - About these countries (`countries`, list): 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 (`categories`, list): 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 (`language`, text): The language of the articles. finlight searches one language at a time; leave blank for English. - Published after (`published_after`, date 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_before`, date and time): Only articles published before this time. Leave blank for up to now. - Order (`sort`, text): 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 (`limit`, number): The most articles to return, from 1 to 100. Leave blank for 20. From 1 to 100. - Page (`page`, number): 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_companies`, true/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_count` (number): How many articles there are - `articles` (list): The articles, in the order asked for - `has_more` (true/false): True when the page came back full, so the next page may hold more - `language` (text): The language searched, as a two-letter code - `page` (number): The page returned - `page_size` (number): The most articles a page holds - `query` (text): The words searched for **Example output** ```json { "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" } ```