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.

Response
Press "Run request" to see a live response.
Same request with curl

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"

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.

WhereHeaders
Direct (latestnewsapi)X-API-Key: YOUR_KEY
RapidAPIX-RapidAPI-Key: YOUR_RAPIDAPI_KEY and X-RapidAPI-Host: <host shown on the listing>

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 with lang. They are separate plans. meta.edition tells you which one answered. See Türkiye News API.

Concepts

TermMeaning
storyOne 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.
factsAtomic fact lines in our wording. facts=none|top3|all controls how many come back (default top3 on lists, all on /stories/{id}).
importanceInteger 0-100 ranking score. Use min_importance or sort=-importance.
outlet_countNumber of outlets covering the story. A count only. Use min_outlets or sort=-coverage.
numbersList 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_dateWhen the event happened (YYYY-MM-DD), or null when it is not known. Filter with event_from / event_to.
first_publishedWhen 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_atWhen the story last changed (new facts, new coverage). sort=-updated, updated_since and monitors use it.
source_languagesLanguages 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:

SyntaxExampleMeaning
wordscentral bankboth words
"phrase""data breach"exact phrase
ORransomware OR phishingeither
-wordapple -fruitexclude

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).

ParamTypeDefaultDescription
qstring (max 500 chars)Full-text search over titles and facts. Supports "quoted phrase", OR, -exclude.
categorystringComma-separated category slugs (see /categories).
exclude_categorystringComma-separated category slugs to drop.
topicstringComma-separated topics (any).
personstringComma-separated people (any).
organizationstringComma-separated organizations (any).
placestringComma-separated places (any).
langstringSource language(s) of the coverage, e.g. tr,en.
fromstringFirst-seen after: 2026-11-18, ISO datetime or 24h / 7d.
tostringFirst-seen before (same formats as from).
event_fromstringEvent date (YYYY-MM-DD) on or after.
event_tostringEvent date (YYYY-MM-DD) on or before.
min_importanceinteger (0–100)Minimum importance score, 0-100.
min_outletsinteger (1–)Minimum number of outlets covering the story.
has_numbersbooleanfalseOnly stories with numbers.

Result controls (/stories)

ParamTypeDefaultDescription
updated_sincestringOnly stories updated after this time: ISO date or datetime, or relative 24h / 30m. Use with sort=-updated to sync.
sortstringrelevance if q is set, else -first_publishedrelevance (needs q; best match first) | -first_published | -updated | -importance | -coverage
limitinteger (1–100)20Stories 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.
cursorstringOpaque cursor from meta.next_cursor.
factsstring ((none|top3|all))top3Fact lines per story: none, top3 or all. BASIC plan: none or top3 only (all returns 403 plan_restriction).
fieldsstringComma-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"

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

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.

ParamTypeDefaultDescription
updated_sincestringOnly stories updated after this time: ISO date or datetime, or relative 24h / 30m. Use with sort=-updated to sync.
sortstringrelevance if q is set, else -first_publishedrelevance (needs q; best match first) | -first_published | -updated | -importance | -coverage
limitinteger (1–100)20Stories 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.
cursorstringOpaque cursor from meta.next_cursor.
factsstring ((none|top3|all))top3Fact lines per story: none, top3 or all. BASIC plan: none or top3 only (all returns 403 plan_restriction).
fieldsstringComma-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"

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.

ParamTypeDefaultDescription
story_id *integerStory ID.

Example request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.latestnewsapi.com/v1/stories/5480"

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"
  }
}
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.

ParamTypeDefaultDescription
story_id *integerStory ID.
limitinteger (1–50)10Stories per page.
factsstring ((none|top3|all))noneFact 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"

Response

Response
{
  "data": [
    {
      "id": 0,
      "title": "<related story 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.

ParamTypeDefaultDescription
story_id *integerStory ID.
langstringenArticle 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"

Response

Response
{
  "data": {
    "story_id": 5480,
    "headline": "...",
    "body": "...",
    "words": 0,
    "language": "en",
    "generated_from": "facts"
  },
  "meta": {
    "request_id": "req_...",
    "cost_requests": 25
  }
}
1 creditAll plans
GET /v1/stories/trending

The most-covered stories in a recent window.

ParamTypeDefaultDescription
windowstring (0-9+[hd])24hLook-back window such as 24h or 7d.
limitinteger (1–100)20Stories 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.
categorystring
factsstring ((none|top3|all))top3Fact 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"

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.

ParamTypeDefaultDescription
group_bystring ((hour|day|week|category|topic|language))dayhour, 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"

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.

ParamTypeDefaultDescription
whatstringText the number describes, e.g. 'inflation' (substring).
unitstringUnit code, e.g. percent, USD, EUR, TRY, people, years. Matches unit_code (case-insensitive).
min_valuenumberMinimum value_normalized.
max_valuenumberMaximum value_normalized.
limitinteger (1–200)50Stories per page.

Example request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.latestnewsapi.com/v1/facts?what=stolen&unit=USD&min_value=100000000"

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.

ParamTypeDefaultDescription
typestring ((person|organization|place|topic))personperson, organization, place or topic.
qstring (max 100 chars)Prefix/substring match for autocomplete.
fromstring7dFirst seen after: 2026-11-18, an ISO datetime, or 24h / 7d.
limitinteger (1–100)20Stories 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"

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"

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"

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 fieldTypeDescription
name *string, 1-100Monitor name.
filtersobjectKeys: 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

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.

ParamTypeDefaultDescription
mid *integerMonitor ID.
sincestring24hOnly stories updated after this time: ISO date or datetime, or relative 24h / 30m.
limitinteger (1-100)20Stories per page.
factsstringtop3Fact 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"

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.

ToolDoes
search_storiesSearch and filter stories (the /stories filters).
get_storyOne story with all fact lines.
trendingMost-covered stories in a recent window.
search_factsSearch numbers by what, unit code and value range.
countStory 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=<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"

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.

CreditsWhat
0 credits/usage, /categories, creating, editing, deleting and listing monitors, MCP connect and list tools.
1 creditSearch or list stories, one story, related stories, trending, count, facts, entities, monitor stories, one MCP tool call.
25 creditsOne article (any of the 45 languages).

Plans

PlanPriceCreditsPer callArchiveFactsMonitorsArticles a dayRate
BASIC$0100 requests a day1048 hourstop3nonenone1 req/s
PRO$19/mo (Türkiye $19)30,000 a month (Türkiye 20,000)5030 daysall3205 req/s
ULTRA$59/mo (Türkiye $49)120,000 a month (Türkiye 100,000)1001 yearall2520010 req/s
MEGA$149/mo (Türkiye $129)500,000 a month (Türkiye 400,000)1001 yearall501,00020 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

HeaderMeaning
X-Request-IdUnique ID of the request. Quote it to support.
X-Quota-LimitYour quota.
X-Quota-RemainingCalls left.
X-Quota-ResetWhen 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"
    ]
  }
}
StatuscodeMeaning
401invalid_api_keyKey missing, unknown or revoked.
403plan_restrictionThe 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.
404not_foundUnknown path or story/monitor ID.
422invalid_parameterA parameter failed validation. param names it; invalid_values and allowed_values are included where relevant.
429quota_exhaustedYour quota is used up. See the quota headers for the reset time.
503generation_unavailableThe article could not be generated right now. Not charged; retry later.
500server_errorUnexpected 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.