# Finance News API (https://www.socialcrawl.dev/platforms/finance/news)

> Returns recent news articles for one financial instrument as a unified NewsArticleList: title, absolute publish time (UTC), publisher, source domain, article URL, and the widest available thumbnail. Pass the instrument in `keyword` as a bare ticker (`AAPL`) or in the `TICKER:EXCHANGE` form used by /v1/finance/quote (`AAPL:NASDAQ`) - the exchange suffix is stripped for you. Rows use the same canonical shape as /v1/google_news/search, so finance news and news-search results join on one row type. `published_at` is always an absolute second-precision ISO-8601 UTC instant, never a localized "2 hours ago" string. Prices and instrument data are delayed; see the platform guide for per-exchange delays.

TL;DR: `GET /v1/finance/news` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `keyword` | yes | Instrument ticker. A bare symbol ('AAPL', '005930.KS') or the 'TICKER:EXCHANGE' form from ticker-search ('AAPL:NASDAQ'); the exchange suffix is ignored. |
| `limit` | no | Maximum articles to return, 1 to 50. Defaults to the upstream batch size. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/finance/news?keyword=AAPL" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full Finance API: https://www.socialcrawl.dev/platforms/finance

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing