Get Started
From zero to your first labeled-news call in two minutes.
1. Create an API key
Sign in to your dashboard and create a key. The secret is shown once -
copy it. Keys look like flk_....
2. Make your first call
Pass the key in the X-API-Key header:
curl -H "X-API-Key: flk_your_key" \
"https://api.financelab.ai/api/v1/news?limit=5"You'll get back recent labeled articles:
{
"articles": [
{
"recordId": "20260623-1a2b3c",
"date": "2026-06-23",
"url": "https://example.com/fed-holds-rates",
"title": "Fed holds rates steady amid cooling inflation",
"source": "reuters.com",
"domains": ["monetary_rates", "macro_growth"],
"impact": "high",
"region": "US",
"sentiment": 0.42,
"sentimentLabel": "positive",
"relevance": 0.91,
"tone": 1.8
}
],
"count": 1,
"range": { "start": "2026-06-16", "end": "2026-06-23" },
"tier": "free",
"note": null
}3. Filter
# High-impact crypto news over a date range
curl -H "X-API-Key: flk_your_key" \
"https://api.financelab.ai/api/v1/news?domain=crypto&impact_min=high&start=2026-01-01&end=2026-06-01"Parameters
| Param | Type | Description |
|---|---|---|
start, end | date (YYYY-MM-DD) | Window to query. Default: the last 7 days. |
domain | string | One of the 12 domains. |
impact_min | low | medium | high | Minimum impact (medium returns medium + high). |
region | string | e.g. US, EM_Asia, Global. |
sentiment | positive | negative | neutral | Filter by sentiment. |
limit | int | Default 100, max 500. |
offset | int | Pagination offset. |
See the label vocabulary in Concepts and keys/limits in Authentication.