Source: https://latestnewsapi.com/docs # 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](/llms.txt), [OpenAPI 3](/openapi.json), [this page as Markdown](/docs.md). ## Try it live Run real requests without a key: https://latestnewsapi.com/docs#try ## 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. [Get free API key](https://rapidapi.com/latestnewsapi/api/global-news)[Türkiye edition](https://rapidapi.com/latestnewsapi/api/turkiye-news) ### 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](#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: ` | A missing or wrong key returns 401: 401 response ``` { "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](#ep-article) with `lang`. They are separate plans. `meta.edition` tells you which one answered. See [Türkiye News API](/turkiye-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](#credits). ### Search stories 1 creditAll plans **GET** /v1/stories Search and list stories. Combine any filter below. Sorted by `-first_published` unless `sort` says otherwise. Also accepts all [story filters](#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** 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 1 creditAll plans **GET** /v1/stories/{story\_id} 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** 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 1 creditAll plans **GET** /v1/stories/{story\_id}/related 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** Response ``` { "data": [ { "id": 0, "title": "", "category": "cybersecurity", "shared_entities": [ "FBI" ], "...": "..." } ], "meta": { "request_id": "req_...", "returned": 1 } } ``` ### Write an article 25 creditsPaid plans **GET** /v1/stories/{story\_id}/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** Response ``` { "data": { "story_id": 5480, "headline": "...", "body": "...", "words": 0, "language": "en", "generated_from": "facts" }, "meta": { "request_id": "req_...", "cost_requests": 25 } } ``` ### Trending stories 1 creditAll plans **GET** /v1/stories/trending 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** 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 1 creditAll plans **GET** /v1/stories/count 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](#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** 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 1 creditAll plans **GET** /v1/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](#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** 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 1 creditAll plans **GET** /v1/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** Response ``` { "data": [ { "name": "FBI", "type": "organization", "story_count": 0 } ], "meta": { "request_id": "req_...", "edition": "global", "returned": 1 } } ``` ### Categories 0 creditsAll plans **GET** /v1/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** Response ``` { "data": [ { "slug": "ai", "stories_7d": 0 }, { "slug": "business", "stories_7d": 0 }, "..." ], "meta": { "request_id": "req_..." } } ``` ### Usage 0 creditsAll plans **GET** /v1/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** 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 0 creditsPRO and up **POST** /v1/monitors 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** 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 1 creditPRO and up **GET** /v1/monitors/{mid}/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](#ep-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 ``` 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=&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](/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. 422 response ``` { "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](#credits). | | 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.