finlight Logo

REST APIFinancial News

Access real-time financial news through simple HTTP requests. Perfect for web applications, batch processing, and on-demand data retrieval.

Part of finlight's complete news API suite

Quick Start

Get started in minutes

Our REST API is designed for simplicity. Make your first request in under 5 minutes.

Basic Request

Get the latest financial news articles

curl -X POST https://api.finlight.me/v2/articles \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -d '{
    "query": "ticker:AAPL AND sentiment:positive",
    "tickers": ["AAPL", "MSFT"],
    "sources": ["www.bloomberg.com", "www.reuters.com"],
    "from": "2024-01-01",
    "to": "2024-12-31",
    "includeContent": true,
    "includeEntities": true,
    "language": "en",
    "order": "DESC",
    "pageSize": 10,
    "page": 1
  }'

Response Example

JSON response with article data

{
  "articles": [
    {
      "link": "https://www.reuters.com/markets/apple-q4-earnings-2024-01-15",
      "source": "www.reuters.com",
      "title": "Apple Reports Strong Q4 Earnings Beat",
      "summary": "Apple Inc. exceeded analyst expectations with quarterly revenue growth driven by iPhone sales and services.",
      "publishDate": "2024-01-15T14:30:00Z",
      "language": "en",
      "sentiment": "positive",
      "confidence": 0.85,
      "images": [
        "https://cdn.reuters.com/apple-hq-2024.jpg",
        "https://cdn.reuters.com/tim-cook-earnings.jpg"
      ],
      "content": "Apple Inc. (NASDAQ: AAPL) reported quarterly earnings that exceeded analyst expectations with revenue of $119.6 billion...",
      "companies": [
        {
          "companyId": 38245,
          "confidence": "0.9840928316116333",
          "country": "United States",
          "exchange": "NASDAQ",
          "industry": "Computer Manufacturing",
          "name": "Apple Inc. Common Stock",
          "sector": "Technology",
          "ticker": "AAPL",
          "isin": null,
          "openfigi": "BBG000B9XRY4"
        }
      ]
    }
  ],
  "page": 1,
  "pageSize": 10
}

Why Choose Our REST API

Built for developers

Simple HTTP requests, powerful features, and comprehensive data.

Real-Time Updates

Articles indexed within seconds of publication. Get the latest financial news as it happens.

Advanced Filtering

Filter by ticker, exchange, source, sentiment, and more. Use boolean logic for precise queries.

Global Coverage

Access news from thousands of sources worldwide with sub-200ms response times globally.

API Endpoints

Comprehensive REST interface

Access all finlight features through our REST API endpoints.

POST/v2/articles
View Docs

Search and retrieve news articles with advanced filtering. Body parameters allow complex queries.

querysourcesexcludeSourcestickersincludeContentincludeEntitiesexcludeEmptyContentfromtolanguageorderpageSizepage
GET/v2/sources
View Docs

Get list of available news sources for filtering articles

No parameters required

Official Client Libraries

Get started faster with our official SDKs and comprehensive documentation

Quick Start Commands

Node.js/TypeScript
npm install finlight-client
Python
pip install finlight-client

Pricing

Flexible plans for every need

From free tier to enterprise solutions, all plans include full REST API access with varying request limits and features.

REST API Access

Available on all plans with different request limits and features

Compare features, request limits, and pricing options on our dedicated pricing page

Complete Integration Suite

Other ways to access finlight

REST API is just one way to integrate with finlight. Choose the method that best fits your use case.

Need help choosing?Compare all methods

Frequently Asked Questions

REST API Questions & Answers

Get answers about authentication, filtering, data formats, and more for our REST API.

Our REST API typically responds within 200ms globally thanks to our CDN. Response times may vary based on query complexity and your geographic location.