LatestNewsAPI documentation
REST + JSON news API. Each story comes with its own title, facts, numbers, people, organizations, places, countries, regions and dates. /article writes a readable article from a story's facts in 45 languages for 25 credits. Facts and our own titles, never copied article text. Base URL https://api.latestnewsapi.com. Every endpoint returns {"data": ..., "meta": {...}}. Machine-readable: llms.txt, OpenAPI 3, this page as Markdown.
Try it live
Run real requests against the API right here: no key, no signup. The demo is deliberately small: 3 stories per call, last 24 hours, top 3 facts, 10 requests an hour. A free key gives you much more.
Press "Run request" to see a live response.
Quickstart
1. Get a key
Subscribe to the free BASIC plan on RapidAPI: 100 requests a day, no credit card. Copy your key from the RapidAPI dashboard.
2. Make your first request
Search stories about a central bank from the last 24 hours, with the top 3 facts per story.
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/stories?q=%22central+bank%22&from=24h&facts=top3&limit=3"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/stories?q=%22central+bank%22&from=24h&facts=top3&limit=3",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/stories?q=%22central+bank%22&from=24h&facts=top3&limit=3", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
3. Read data and meta
The stories are in data; paging info is in meta (total, returned, next_cursor). Use fields=id,title to shrink the response, and see Pagination for the next page.
Authentication
Send your key in the X-API-Key header. When you subscribe through RapidAPI, use the RapidAPI headers instead; RapidAPI enforces plan quotas.
| Where | Headers |
|---|---|
| Direct (latestnewsapi) | X-API-Key: YOUR_KEY |
| RapidAPI | X-RapidAPI-Key: YOUR_RAPIDAPI_KEY and X-RapidAPI-Host: <host shown on the listing> |
A missing or wrong key returns 401:
{
"error": {
"code": "invalid_api_key",
"message": "Missing API key. Send it as the X-API-Key header.",
"status": 401,
"request_id": "req_7d6c58d952dd",
"doc_url": "https://latestnewsapi.com/docs#errors"
}
}Editions: /v1 and /tr/v1
Two editions share one schema and the same endpoints. Global News lives under /v1 and contains all stories. Türkiye News lives under /tr/v1 and contains stories with Turkish-language coverage or set in Türkiye, as English JSON. For readable text in another language, use the article endpoint with lang. They are separate plans. meta.edition tells you which one answered. See Türkiye News API.
Concepts
| Term | Meaning |
|---|---|
| story | One news story with a stable id. Coverage from many outlets is merged, so each story appears once. Our own title; no article text, outlet names, links or image URLs are ever returned. |
| facts | Atomic fact lines in our wording. facts=none|top3|all controls how many come back (default top3 on lists, all on /stories/{id}). |
| importance | Integer 0-100 ranking score. Use min_importance or sort=-importance. |
| outlet_count | Number of outlets covering the story. A count only. Use min_outlets or sort=-coverage. |
| numbers | List of {value, value_normalized, unit, unit_code, what}, e.g. 400.0, 400000000.0, "million dollars", "USD", "stolen cryptocurrency". value_normalized is a float with the scale applied; unit_code is a short code (USD, EUR, TRY, percent, people, years and so on). Search them with /facts. |
| event_date | When the event happened (YYYY-MM-DD), or null when it is not known. Filter with event_from / event_to. |
| first_published | When coverage of the story first appeared. Filter with from / to. Differs from event_date: a story first published today can be about something that happened last week. |
| updated_at | When the story last changed (new facts, new coverage). sort=-updated, updated_since and monitors use it. |
| source_languages | Languages of the coverage, e.g. ["en"] or ["tr","en"]. |
Categories: ai, business, crypto, cybersecurity, entertainment, finance, gaming, general, health, local, marketing, science, sports, technology, world.
Query syntax
q is a full-text search over titles and facts (max 500 chars) using web-search syntax:
| Syntax | Example | Meaning |
|---|---|---|
| words | central bank | both words |
| "phrase" | "data breach" | exact phrase |
| OR | ransomware OR phishing | either |
| -word | apple -fruit | exclude |
Relative dates: from=24h, from=7d, or an ISO date or datetime. List filters take comma-separated values (category=ai,science).
Filters
These filters work on /stories, /stories/count and /facts (generated from openapi.json).
| Param | Type | Default | Description |
|---|---|---|---|
q | string (max 500 chars) | Full-text search over titles and facts. Supports "quoted phrase", OR, -exclude. | |
category | string | Comma-separated category slugs (see /categories). | |
exclude_category | string | Comma-separated category slugs to drop. | |
topic | string | Comma-separated topics (any). | |
person | string | Comma-separated people (any). | |
organization | string | Comma-separated organizations (any). | |
place | string | Comma-separated places (any). | |
lang | string | Source language(s) of the coverage, e.g. tr,en. | |
from | string | First-seen after: 2026-11-18, ISO datetime or 24h / 7d. | |
to | string | First-seen before (same formats as from). | |
event_from | string | Event date (YYYY-MM-DD) on or after. | |
event_to | string | Event date (YYYY-MM-DD) on or before. | |
min_importance | integer (0–100) | Minimum importance score, 0-100. | |
min_outlets | integer (1–) | Minimum number of outlets covering the story. | |
has_numbers | boolean | false | Only stories with numbers. |
Result controls (/stories)
| Param | Type | Default | Description |
|---|---|---|---|
updated_since | string | Only stories updated after this time: ISO date or datetime, or relative 24h / 30m. Use with sort=-updated to sync. | |
sort | string | relevance if q is set, else -first_published | relevance (needs q; best match first) | -first_published | -updated | -importance | -coverage |
limit | integer (1–100) | 20 | Stories per page. Maximum by plan: 10 BASIC, 50 PRO, 100 ULTRA and MEGA (default 20, or your plan maximum if lower). A higher value returns 403 plan_restriction. |
cursor | string | Opaque cursor from meta.next_cursor. | |
facts | string ((none|top3|all)) | top3 | Fact lines per story: none, top3 or all. BASIC plan: none or top3 only (all returns 403 plan_restriction). |
fields | string | Comma-separated fields to return (id always included). |
Pagination
Cursor-based, with no hidden result cap. meta.total is exact. While meta.next_cursor is present, pass it back as cursor with the same filters and sort:
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/stories?q=ransomware&limit=100&cursor=NEXT_CURSOR"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/stories?q=ransomware&limit=100&cursor=NEXT_CURSOR",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/stories?q=ransomware&limit=100&cursor=NEXT_CURSOR", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Cursors are opaque and tied to the sort you used. When there are no more pages, next_cursor is null.
Endpoints
All paths are shown for the Global edition. Prefix with /tr for Türkiye (/tr/v1/stories). Parameters marked * are required. Responses are abridged; counts marked 0 or "..." are placeholders. Credit costs are listed under Credits & plans.
Search stories
Search and list stories. Combine any filter below. Sorted by -first_published unless sort says otherwise.
Also accepts all story filters.
| Param | Type | Default | Description |
|---|---|---|---|
updated_since | string | Only stories updated after this time: ISO date or datetime, or relative 24h / 30m. Use with sort=-updated to sync. | |
sort | string | relevance if q is set, else -first_published | relevance (needs q; best match first) | -first_published | -updated | -importance | -coverage |
limit | integer (1–100) | 20 | Stories per page. Maximum by plan: 10 BASIC, 50 PRO, 100 ULTRA and MEGA (default 20, or your plan maximum if lower). A higher value returns 403 plan_restriction. |
cursor | string | Opaque cursor from meta.next_cursor. | |
facts | string ((none|top3|all)) | top3 | Fact lines per story: none, top3 or all. BASIC plan: none or top3 only (all returns 403 plan_restriction). |
fields | string | Comma-separated fields to return (id always included). |
Example request
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/stories?category=crypto&min_outlets=5&facts=top3&limit=1"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/stories?category=crypto&min_outlets=5&facts=top3&limit=1",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/stories?category=crypto&min_outlets=5&facts=top3&limit=1", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Response
{
"data": [
{
"id": 5480,
"title": "North Korean hackers steal over $400M in crypto",
"language": "en",
"facts": [
"North Korean state-backed hackers have stolen more than $400 million in cryptocurrency over the past 18 months.",
"The hackers used surreptitiously recorded images of people to target their contacts.",
"The FBI refers to this social engineering scheme as FaceStealer."
],
"category": "crypto",
"topics": [
"cybersecurity",
"crime"
],
"people": [],
"organizations": [
"FBI"
],
"places": [],
"countries": [],
"regions": [],
"numbers": [
{
"value": 400.0,
"value_normalized": 400000000.0,
"unit": "million dollars",
"unit_code": "USD",
"what": "stolen cryptocurrency"
}
],
"event_date": null,
"importance": 69,
"outlet_count": 11,
"source_languages": [
"en"
],
"first_published": "2026-11-17T02:28:00Z",
"updated_at": "2026-11-18T20:23:27Z"
}
],
"meta": {
"request_id": "req_7d6c58d952dd",
"edition": "global",
"total": 86,
"returned": 1,
"limit": 1,
"next_cursor": "WzY5LCA1NDgwXQ"
}
}Get a story
One story with all fact lines.
| Param | Type | Default | Description |
|---|---|---|---|
story_id * | integer | Story ID. |
Example request
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/stories/5480"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/stories/5480",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/stories/5480", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Response
{
"data": {
"id": 5480,
"title": "North Korean hackers steal over $400M in crypto",
"language": "en",
"facts": [
"North Korean state-backed hackers have stolen more than $400 million in cryptocurrency over the past 18 months.",
"The hackers used surreptitiously recorded images of people to target their contacts.",
"The FBI refers to this social engineering scheme as FaceStealer.",
"..."
],
"category": "crypto",
"topics": [
"cybersecurity",
"crime"
],
"people": [],
"organizations": [
"FBI"
],
"places": [],
"numbers": [
{
"value": 400.0,
"value_normalized": 400000000.0,
"unit": "million dollars",
"unit_code": "USD",
"what": "stolen cryptocurrency"
}
],
"event_date": null,
"importance": 69,
"outlet_count": 11,
"source_languages": [
"en"
],
"first_published": "2026-11-17T02:28:00Z",
"updated_at": "2026-11-18T20:23:27Z"
},
"meta": {
"request_id": "req_7d6c58d952dd"
}
}Related stories
Stories that share people, organizations or places with the given story. Each item adds shared_entities.
| Param | Type | Default | Description |
|---|---|---|---|
story_id * | integer | Story ID. | |
limit | integer (1–50) | 10 | Stories per page. |
facts | string ((none|top3|all)) | none | Fact lines per story: none, top3 or all. BASIC plan: none or top3 only (all returns 403 plan_restriction). |
Example request
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/stories/5480/related?limit=2"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/stories/5480/related?limit=2",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/stories/5480/related?limit=2", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Response
{
"data": [
{
"id": 0,
"title": "<related story title>",
"category": "cybersecurity",
"shared_entities": [
"FBI"
],
"...": "..."
}
],
"meta": {
"request_id": "req_...",
"returned": 1
}
}Write an article
A short neutral article written from the story's facts, in the language you choose with lang (default English). The text uses only the story's facts and never names outlets. PRO and up only: BASIC gets 403 plan_restriction. Costs 25 credits; daily article cap PRO 20, ULTRA 200, MEGA 1,000 (then 429 article_limit_reached). Also available as /tr/v1/stories/{story_id}/article. May return 503 generation_unavailable, which is not charged.
| Param | Type | Default | Description |
|---|---|---|---|
story_id * | integer | Story ID. | |
lang | string | en | Article language: en, tr, de, fr, es, it, pt, pt-br, nl, da, sv, no, fi, pl, cs, sk, hu, ro, bg, hr, sr, sl, el, et, lv, lt, ca, ru, uk, ar, fa, he, hi, bn, ur, id, ms, tl, vi, th, ja, ko, zh, zh-tw, sw (zh is Simplified Chinese). Any other code returns 422 invalid_parameter with the allowed values. data.language echoes the chosen code. |
Example request
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/stories/5480/article?lang=tr"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/stories/5480/article?lang=tr",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/stories/5480/article?lang=tr", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Response
{
"data": {
"story_id": 5480,
"headline": "...",
"body": "...",
"words": 0,
"language": "en",
"generated_from": "facts"
},
"meta": {
"request_id": "req_...",
"cost_requests": 25
}
}Trending stories
The most-covered stories in a recent window.
| Param | Type | Default | Description |
|---|---|---|---|
window | string (0-9+[hd]) | 24h | Look-back window such as 24h or 7d. |
limit | integer (1–100) | 20 | Stories per page. Maximum by plan: 10 BASIC, 50 PRO, 100 ULTRA and MEGA (default 20, or your plan maximum if lower). A higher value returns 403 plan_restriction. |
category | string | ||
facts | string ((none|top3|all)) | top3 | Fact lines per story: none, top3 or all. BASIC plan: none or top3 only (all returns 403 plan_restriction). |
Example request
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/stories/trending?window=24h&limit=1&facts=none"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/stories/trending?window=24h&limit=1&facts=none",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/stories/trending?window=24h&limit=1&facts=none", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Response
{
"data": [
{
"id": 5480,
"title": "North Korean hackers steal over $400M in crypto",
"facts": null,
"outlet_count": 11,
"...": "..."
}
],
"meta": {
"request_id": "req_...",
"edition": "global",
"window": "24h",
"returned": 1
}
}Count stories
Story counts over time or by facet. Accepts all story filters. Each item is {key, count}; time keys are ISO timestamps.
Also accepts all story filters.
| Param | Type | Default | Description |
|---|---|---|---|
group_by | string ((hour|day|week|category|topic|language)) | day | hour, day, week, category, topic or language. |
Example request
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/stories/count?q=ransomware&group_by=day&from=7d"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/stories/count?q=ransomware&group_by=day&from=7d",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/stories/count?q=ransomware&group_by=day&from=7d", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Response
{
"data": [
{
"key": "2026-11-17T00:00:00Z",
"count": 0
},
{
"key": "2026-11-18T00:00:00Z",
"count": 0
}
],
"meta": {
"request_id": "req_...",
"edition": "global",
"group_by": "day"
}
}Search facts
Search numbers across all stories by what they measure, unit code and normalized value range. Also accepts the story filters.
Also accepts all story filters.
| Param | Type | Default | Description |
|---|---|---|---|
what | string | Text the number describes, e.g. 'inflation' (substring). | |
unit | string | Unit code, e.g. percent, USD, EUR, TRY, people, years. Matches unit_code (case-insensitive). | |
min_value | number | Minimum value_normalized. | |
max_value | number | Maximum value_normalized. | |
limit | integer (1–200) | 50 | Stories per page. |
Example request
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/facts?what=stolen&unit=USD&min_value=100000000"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/facts?what=stolen&unit=USD&min_value=100000000",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/facts?what=stolen&unit=USD&min_value=100000000", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Response
{
"data": [
{
"value": 400.0,
"value_normalized": 400000000.0,
"unit": "million dollars",
"unit_code": "USD",
"what": "stolen cryptocurrency",
"story_id": 5480,
"story_title": "North Korean hackers steal over $400M in crypto",
"category": "crypto",
"first_published": "2026-11-17T02:28:00Z"
}
],
"meta": {
"request_id": "req_...",
"returned": 1
}
}Entities
People, organizations, places or topics with story counts. Use q for autocomplete.
| Param | Type | Default | Description |
|---|---|---|---|
type | string ((person|organization|place|topic)) | person | person, organization, place or topic. |
q | string (max 100 chars) | Prefix/substring match for autocomplete. | |
from | string | 7d | First seen after: 2026-11-18, an ISO datetime, or 24h / 7d. |
limit | integer (1–100) | 20 | Stories per page. Maximum by plan: 10 BASIC, 50 PRO, 100 ULTRA and MEGA (default 20, or your plan maximum if lower). A higher value returns 403 plan_restriction. |
Example request
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/entities?type=organization&q=FB&limit=1"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/entities?type=organization&q=FB&limit=1",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/entities?type=organization&q=FB&limit=1", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Response
{
"data": [
{
"name": "FBI",
"type": "organization",
"story_count": 0
}
],
"meta": {
"request_id": "req_...",
"edition": "global",
"returned": 1
}
}Categories
Valid category slugs with 7-day story counts.
Example request
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/categories"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/categories",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/categories", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Response
{
"data": [
{
"slug": "ai",
"stories_7d": 0
},
{
"slug": "business",
"stories_7d": 0
},
"..."
],
"meta": {
"request_id": "req_..."
}
}Usage
Your calls today and in the last 30 days.
Example request
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/usage"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/usage",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/usage", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Response
{
"data": {
"owner": "...",
"plan": "...",
"daily_limit": 0,
"today": 0,
"days": [
{
"day": "2026-11-18",
"calls": 0
}
]
},
"meta": {
"request_id": "req_..."
}
}Monitors: create, list, edit, delete
Saved filters you poll. GET /v1/monitors lists them, POST /v1/monitors creates (201), PUT /v1/monitors/{mid} replaces, DELETE /v1/monitors/{mid} removes. BASIC has no monitors (403 plan_restriction).
| Body field | Type | Description |
|---|---|---|
name * | string, 1-100 | Monitor name. |
filters | object | Keys: q, category, exclude_category, topic, person, organization, place, lang, min_importance, min_outlets, has_numbers. Unknown keys return 422 with allowed_values. |
Example request
curl -X POST -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \ -d '{"name": "High-importance crypto", "filters": {"category": "crypto", "min_importance": 70}}' \ https://api.latestnewsapi.com/v1/monitors
import requests
r = requests.post(
"https://api.latestnewsapi.com/v1/monitors",
headers={"X-API-Key": "YOUR_KEY"},
json={"name": "High-importance crypto", "filters": {"category": "crypto", "min_importance": 70}},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/monitors", { method: "POST", headers: { "X-API-Key": "YOUR_KEY", "Content-Type": "application/json" }, body: JSON.stringify({"name": "High-importance crypto", "filters": {"category": "crypto", "min_importance": 70}}), }); console.log(await r.json());
Response
{
"data": {
"id": 1,
"name": "High-importance crypto",
"filters": {
"category": "crypto",
"min_importance": 70
},
"created_at": "2026-11-18T20:30:00Z"
},
"meta": {
"request_id": "req_..."
}
}Monitor stories
Stories matching the monitor's filters since a point in time.
| Param | Type | Default | Description |
|---|---|---|---|
mid * | integer | Monitor ID. | |
since | string | 24h | Only stories updated after this time: ISO date or datetime, or relative 24h / 30m. |
limit | integer (1-100) | 20 | Stories per page. |
facts | string | top3 | Fact lines per story: none, top3 or all. |
Example request
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/monitors/1/stories?since=24h&facts=top3&limit=20"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/monitors/1/stories?since=24h&facts=top3&limit=20",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/monitors/1/stories?since=24h&facts=top3&limit=20", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
The response has the same shape as Search stories.
Monitors
A monitor is a saved search. Poll GET /v1/monitors/{mid}/stories?since=... on your own schedule to get the matching stories, or use /v1/stories?updated_since=... with your own filters. Creating, editing, deleting and listing monitors is free; polling costs 1 credit per call.
- Monitor counts by plan: none on BASIC, 3 on PRO, 25 on ULTRA, 50 on MEGA.
MCP server (for AI agents)
An MCP server exposes the API to agents. Endpoint: https://api.latestnewsapi.com/mcp, streamable HTTP, using the same API key header as the REST API. One tool call costs 1 credit; connecting and listing tools is free.
| Tool | Does |
|---|---|
search_stories | Search and filter stories (the /stories filters). |
get_story | One story with all fact lines. |
trending | Most-covered stories in a recent window. |
search_facts | Search numbers by what, unit code and value range. |
count | Story counts over time or by facet. |
List the tools with a plain JSON-RPC request:
curl -X POST -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \ https://api.latestnewsapi.com/mcp
Keeping a local copy
To keep a local copy current, poll /v1/stories?updated_since=<last poll>&sort=-updated on a schedule. updated_since returns stories created or changed after that time, so you also receive new facts on stories you already hold. Store the time you started each poll and pass it next time; page with cursor until next_cursor is null.
curl -H "X-API-Key: YOUR_KEY" \ "https://api.latestnewsapi.com/v1/stories?updated_since=2026-11-18T20:00:00Z&sort=-updated&limit=100"
import requests
r = requests.get(
"https://api.latestnewsapi.com/v1/stories?updated_since=2026-11-18T20:00:00Z&sort=-updated&limit=100",
headers={"X-API-Key": "YOUR_KEY"},
)
print(r.json())const r = await fetch("https://api.latestnewsapi.com/v1/stories?updated_since=2026-11-18T20:00:00Z&sort=-updated&limit=100", { headers: { "X-API-Key": "YOUR_KEY" }, }); console.log(await r.json());
Relative values also work: updated_since=30m.
Credits & plans
Every call spends credits. Failed calls (4xx and 5xx) cost 0. Paid plans bill monthly through RapidAPI; credits beyond your plan are charged at $0.001 each.
| Credits | What |
|---|---|
| 0 credits | /usage, /categories, creating, editing, deleting and listing monitors, MCP connect and list tools. |
| 1 credit | Search or list stories, one story, related stories, trending, count, facts, entities, monitor stories, one MCP tool call. |
| 25 credits | One article (any of the 45 languages). |
Plans
| Plan | Price | Credits | Per call | Archive | Facts | Monitors | Articles a day | Rate |
|---|---|---|---|---|---|---|---|---|
| BASIC | $0 | 100 requests a day | 10 | 48 hours | top3 | none | none | 1 req/s |
| PRO | $19/mo (Türkiye $19) | 30,000 a month (Türkiye 20,000) | 50 | 30 days | all | 3 | 20 | 5 req/s |
| ULTRA | $59/mo (Türkiye $49) | 120,000 a month (Türkiye 100,000) | 100 | 1 year | all | 25 | 200 | 10 req/s |
| MEGA | $149/mo (Türkiye $129) | 500,000 a month (Türkiye 400,000) | 100 | 1 year | all | 50 | 1,000 | 20 req/s |
A request outside your plan returns 403 plan_restriction, with allowed_values listing what your plan allows. The article endpoint is PRO and up and returns 429 article_limit_reached past the daily cap. Details and subscribe links are on Pricing.
Response headers
| Header | Meaning |
|---|---|
X-Request-Id | Unique ID of the request. Quote it to support. |
X-Quota-Limit | Your quota. |
X-Quota-Remaining | Calls left. |
X-Quota-Reset | When the quota resets (ISO 8601). |
When the quota is used up the API answers 429 quota_exhausted.
Errors
Every error has one shape. param, invalid_values and allowed_values appear when they apply.
{
"error": {
"code": "invalid_parameter",
"message": "Unknown category.",
"status": 422,
"request_id": "req_7d6c58d952dd",
"doc_url": "https://latestnewsapi.com/docs#errors",
"param": "category",
"invalid_values": [
"tech"
],
"allowed_values": [
"ai",
"business",
"crypto",
"cybersecurity",
"entertainment",
"finance",
"gaming",
"general",
"health",
"local",
"marketing",
"science",
"sports",
"technology",
"world"
]
}
}| Status | code | Meaning |
|---|---|---|
| 401 | invalid_api_key | Key missing, unknown or revoked. |
| 403 | plan_restriction | The request is outside your plan: page size, history window, facts=all on BASIC, or monitors on a plan without them. allowed_values lists what your plan allows. See plan gates. |
| 404 | not_found | Unknown path or story/monitor ID. |
| 422 | invalid_parameter | A parameter failed validation. param names it; invalid_values and allowed_values are included where relevant. |
| 429 | quota_exhausted | Your quota is used up. See the quota headers for the reset time. |
| 503 | generation_unavailable | The article could not be generated right now. Not charged; retry later. |
| 500 | server_error | Unexpected error. Retry; if it persists, contact support with the request_id. |
Other malformed requests (for example an unsupported method) return a 4xx with the code malformed_request. Failed calls cost 0 credits.
Changelog
v1.3.0, 2026-11. sort=relevance (default when q is set); countries field; groups of people (e.g. "prosecutors") no longer listed as organizations.
v1.2.0, 2026-11. The article endpoint takes lang (45 languages); the old output-language parameter and its error are removed. Titles and facts are always English.
v1.1.0, 2026-11. Added updated_since; numbers now carry value_normalized and unit_code, and /facts filters on them; plan gates (plan_restriction); MCP server; /stories/{story_id}/article.
v1.0.0, 2026-11. First release: Global and Türkiye editions, /stories, /facts, /entities, /categories, /usage, monitors.