> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Finlight

> Search Finlight's financial news, retrieve articles by link, and list source metadata through its complete v2 REST API surface.

![Finlight logo](https://mintcdn.com/composio-preview/r7CO9m4_UWMVFnU7/images/toolkits/finlight.svg?fit=max\&auto=format\&n=r7CO9m4_UWMVFnU7\&q=85\&s=eda915e0e1427f1b9dff590db4d5c0a9)

* **Category:** news & lifestyle
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 3
* **Triggers:** 0
* **Slug:** `FINLIGHT`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Article by Link
>
> **Slug:** `FINLIGHT_GET_ARTICLE_BY_LINK`
>
> Retrieve one Finlight-indexed article by its original URL. Optional full content and company entities are plan-gated and may be silently absent even when the request succeeds.
>
> #### Input Parameters
>
> **link** `string` *required*
>
> Original article URL, typically copied from a Finlight search result.
>
> **include\_content** `boolean`
>
> Deprecated provider flag requesting full content. A successful response may still omit content when the connected plan does not provide it.
>
> **include\_entities** `boolean`
>
> Request mentioned-company entities. A successful response may still omit companies when the connected plan lacks entity enrichment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sources
>
> **Slug:** `FINLIGHT_LIST_SOURCES`
>
> List all news source domains visible to the connected Finlight account, including default-source status, origin country, and supported languages.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Articles
>
> **Slug:** `FINLIGHT_SEARCH_ARTICLES`
>
> Search Finlight's indexed financial news using text, market, source, geography, category, language, and date filters, returning one page at a time; continuation can stop at the 10,000-result pagination boundary. Availability, recency, content, and entity enrichment depend on the connected plan and may be silently omitted.
>
> #### Input Parameters
>
> **order** `string ("ASC" | "DESC")`
>
> Sort direction for order\_by.
>
> **query** `string`
>
> Keyword or advanced Finlight query. Searchable fields include ticker, exchange, isin, title, summary, content, openfigi, country, category, and source.
>
> **sources** `array`
>
> Only return articles from these source domains; use '\*' for all sources.
>
> **tickers** `array`
>
> Only return articles associated with these stock tickers; use '\*' for all tickers.
>
> **to\_date** `string`
>
> Inclusive end date as YYYY-MM-DD or an ISO 8601 date-time. Narrow this for deep result sets.
>
> **language** `string`
>
> One ISO 639-1 language code. Run separate searches for multiple languages.
>
> **order\_by** `string ("publishDate" | "createdAt" | "revisedDate")`
>
> Article timestamp used to sort results.
>
> **countries** `array`
>
> Only return articles associated with these ISO 3166-1 alpha-2 country codes.
>
> **from\_date** `string`
>
> Inclusive start date as YYYY-MM-DD or an ISO 8601 date-time. Narrow this for deep result sets.
>
> **page\_size** `integer`
>
> Maximum articles requested for this page (1-100).
>
> **categories** `array`
>
> Filter by Finlight categories: markets, economy, business, politics, geopolitics, regulation, technology, energy, commodities, crypto, health, climate, or security.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call. Pass it unchanged; it restores the original filters and requests the next provider page.
>
> **opt\_in\_sources** `array`
>
> Add these source domains to the account's default source set.
>
> **exclude\_sources** `array`
>
> Exclude these source domains from the results.
>
> **include\_content** `boolean`
>
> Request full article content. This is plan-gated, so a successful response may omit content.
>
> **include\_entities** `boolean`
>
> Request mentioned-company entities. This is plan-gated, so a successful response may omit companies.
>
> **exclude\_empty\_content** `boolean`
>
> Request exclusion of articles without full content. This may be silently ignored when the connected plan lacks content access.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
