DocumentationNews API
News API
Get categorized news headlines, defaults to finance
Overview
GET /v1/info/news returns categorized news articles, defaulting to finance news.
When to Use
- Quick category headlines: User asks "Any finance news today?" or "What's new in tech?" → pull by
category - AI Agent daily briefing: Schedule a daily fetch of
category=financeas your news source - vs
/v1/info/search:newsreturns pre-categorized headlines (fast);searchdoes keyword-based real-time web search (precise but slower). Use search for specific topics, news for category roundup. - No params needed:
category=financeis the default — simplest call isGET /v1/info/news
Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
category | string | No | finance | Category: general/finance/tech/sports/entertainment/health/science/world |
limit | int | No | 20 | Number of articles (1-50) |
Request Example
curl -H "X-API-Key: sk_gapi_xxxxx" \
"https://api.groundapi.net/v1/info/news?category=finance&limit=10"Response Fields
| Field | Description |
|---|---|
category | News category |
total | Total articles |
articles[].title | Article title |
articles[].source | Source media |
articles[].published_at | Published time |
articles[].url | Article URL |
articles[].description | Article summary |
Pricing
$0.01/call. First 500 calls/month are free.
Updated 1 month ago