GET
/
news
/
{symbol}
Get news data
curl --request GET \
  --url https://api.financialcontext.com/news/{symbol} \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "id": "news_123456",
    "title": "Apple Reports Record Q4 Earnings",
    "summary": "Apple Inc. reported record quarterly earnings...",
    "content": "<string>",
    "url": "https://example.com/news/apple-earnings",
    "source": "reuters",
    "author": "John Smith",
    "published_at": "<string>",
    "symbols": [
      "AAPL",
      "MSFT"
    ],
    "category": "earnings",
    "market_type": "STOCK",
    "sentiment": "positive",
    "sentiment_score": 0.75,
    "importance": "high",
    "impact_score": 85,
    "tags": [
      "earnings",
      "technology",
      "quarterly-results"
    ],
    "image_url": "https://example.com/images/news.jpg",
    "language": "en",
    "status": "published",
    "is_featured": false,
    "view_count": 1250,
    "external_id": "<string>",
    "metadata": {},
    "createdAt": "<string>",
    "updatedAt": "<string>"
  },
  "message": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "meta": {
    "pagination": {
      "currentPage": 1,
      "pageSize": 20,
      "totalItems": 150,
      "totalPages": 8,
      "hasMore": true,
      "hasPrevious": false
    }
  }
}

Authorizations

X-API-Key
string
header
required

Path Parameters

symbol
string
required

Stock symbol (e.g., AAPL, NASDAQ:AAPL)

Required string length: 1 - 20
Example:

"AAPL"

Query Parameters

symbols
string[]

Filter by stock symbols

Example:
["AAPL", "MSFT"]
from
string | null

Start date, format YYYY-MM-DD

Example:

"2023-01-01"

to
string | null

End date, format YYYY-MM-DD

Example:

"2023-12-31"

page
integer
default:1

Page number, starting from 1

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

1

page_size
integer
default:10

Number of items per page, range 1-100

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

10

Response

News data retrieved successfully

Single news article response

success
boolean
required

Indicates successful API response

data
object | null
required

News article data News article data structure

timestamp
string<date-time>
required

ISO 8601 timestamp of the response

message
string

Optional success message

meta
object

Optional metadata including pagination, statistics, and additional context