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

ActionWhat it does
Get articleGet 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 newsGet 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 articlesGet the articles finlight added after a time, oldest first, for a search you describe.
Get news sentimentCount 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 sourcesList 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 articlesSearch 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 linklinktextRequired
The article's web address, as a finlight search returns it in an article's Link.
Include companiesinclude_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 tickerstickerslistRequired
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 afterpublished_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 beforepublished_beforedate and time
Only articles published before this time. Leave blank for up to now.
Languagelanguagetext
The language of the articles. finlight searches one language at a time; leave blank for English.
Maximum articleslimitnumber
The most articles to return, from 1 to 100. Leave blank for 20.From 1 to 100.
Include companiesinclude_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 forquerytext
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 tickerstickerslist
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 sourcessourceslist
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 sourcesexclude_sourceslist
Never return articles from these news sites.
About these countriescountrieslist
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.
Categoriescategorieslist
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.
Languagelanguagetext
The language of the articles. finlight searches one language at a time; leave blank for English.
Added afteradded_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 articleslimitnumber
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 forquerytext
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 tickerstickerslist
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 afterpublished_afterdate and time
The start of the time to measure. Leave blank for 7 days before the end.
Published beforepublished_beforedate and time
The end of the time to measure. Leave blank for now.
Languagelanguagetext
The language of the articles. finlight searches one language at a time; leave blank for English.
Articles to readsample_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

Languagelanguagetext
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 forquerytext
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 tickerstickerslist
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 sourcessourceslist
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 sourcesexclude_sourceslist
Never return articles from these news sites.
About these countriescountrieslist
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.
Categoriescategorieslist
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.
Languagelanguagetext
The language of the articles. finlight searches one language at a time; leave blank for English.
Published afterpublished_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 beforepublished_beforedate and time
Only articles published before this time. Leave blank for up to now.
Ordersorttext
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 articleslimitnumber
The most articles to return, from 1 to 100. Leave blank for 20.From 1 to 100.
Pagepagenumber
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 companiesinclude_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"
}

On this page