# LatestNewsAPI > LatestNewsAPI is a latest-news API. Each story comes as JSON with our own neutral title, short fact lines, people/organizations/places/countries/regions/topics, numbers with units, the date it happened, category, importance (0-100) and outlet_count. Coverage from many outlets is merged, so each story appears once. On paid plans, `/v1/stories/{id}/article?lang=xx` writes a readable article from a story's facts in 45 languages. Original article text, URLs and outlet names are never returned, so output is safe to display and to feed to an LLM. Base URL: https://api.latestnewsapi.com. Get a key on the RapidAPI listing (https://rapidapi.com/latestnewsapi/api/global-news). Auth: header `X-API-Key: YOUR_KEY` (RapidAPI: `X-RapidAPI-Key` + `X-RapidAPI-Host`). All responses are `{"data": ..., "meta": {...}}`. Two editions, same schema and endpoints: - Global News: `/v1` (all stories, English output) - Türkiye News: `/tr/v1` (stories with Turkish-language coverage or set in Türkiye; English output; `meta.edition` is `turkiye`) Freshness: close to live. Archive: one year. Free plan: 100 requests a day (no card). Credits: most calls 1; article 25; usage, categories and monitor create/edit/delete/list 0; failed calls (4xx/5xx) are never charged. Plan gates: BASIC page size 10, last 48h, facts top3, no monitors; PRO 50, 30 days, all facts, 3 monitors; ULTRA 100, full archive, all facts, 25 monitors; MEGA 100, full archive, all facts, 50 monitors. Out-of-plan requests return 403 `plan_restriction`. ## Key endpoints - `GET /v1/stories`: search + filters + cursor pagination. Params: q (supports "phrase", OR, -word), category, exclude_category, topic, person, organization, place, lang, from, to (ISO date/datetime or 24h/7d), event_from, event_to, updated_since (ISO or 24h/30m; stories updated after), min_importance, min_outlets, has_numbers, sort (relevance = default with q | -first_published | -updated | -importance | -coverage), limit (max 100), cursor, facts (none|top3|all), fields. - `GET /v1/stories/{id}`: one story with all facts. - `GET /v1/stories/{id}/related`: stories sharing entities. - `GET /v1/stories/{id}/article`: A short neutral article written from the story's facts. Param `lang` (default en; 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 = Simplified Chinese; unknown code returns 422 invalid_parameter). PRO and up (BASIC: 403 plan_restriction), costs 25 credits (daily article cap: PRO 20, ULTRA 200, MEGA 1,000; then 429 article_limit_reached); 503 generation_unavailable is not charged. - `GET /v1/stories/trending?window=24h`: most-covered recent stories. - `GET /v1/stories/count?group_by=hour|day|week|category|topic|language`: counts with the same filters. - `GET /v1/facts?what=inflation&unit=percent&min_value=40`: search numbers across news. numbers are `{value, value_normalized, unit, unit_code, what}`; `unit` matches unit_code (USD, EUR, TRY, percent, people, years...), min_value/max_value use value_normalized. - `GET /v1/entities?type=person|organization|place|topic&q=`: trending and autocomplete. - `GET /v1/categories`, `GET /v1/usage`. - `/v1/monitors` (GET, POST, PUT/DELETE by id) and `GET /v1/monitors/{id}/stories`: saved filters; poll `GET /v1/monitors/{id}/stories` for matching stories on your own schedule. Categories: ai, business, crypto, cybersecurity, entertainment, finance, gaming, general, health, local, marketing, science, sports, technology, world. ## MCP server (for AI agents) Endpoint: https://api.latestnewsapi.com/mcp (streamable HTTP, same API key header). Tools: search_stories, get_story, trending, search_facts, count. ## Sync recipe Poll `/v1/stories?updated_since=&sort=-updated` on a schedule. ## Tips for agents - Use `fields=id,title,facts` and `facts=top3` to keep responses small; facts are short, our own wording. - Pass relative dates (`from=24h`) and `min_importance=60` for "what matters now". - Follow `meta.next_cursor` unchanged for the next page; `meta.total` is exact. - Errors have one shape: {"error": {code, message, status, request_id, param, invalid_values, allowed_values, doc_url}}. Codes: 401 invalid_api_key, 404 not_found, 422 invalid_parameter (read allowed_values and retry), 403 plan_restriction, 429 quota_exhausted, 500 server_error. - Rate limits: 1 req/s BASIC, 5 PRO, 10 ULTRA, 20 MEGA. Headers: X-Request-Id, X-Quota-Limit, X-Quota-Remaining, X-Quota-Reset. ## Docs - [Latest News API](https://latestnewsapi.com/): overview, fields, pricing - [Articles in any language](https://latestnewsapi.com/news-to-articles-api): the article endpoint, 45 languages, samples - [API documentation](https://latestnewsapi.com/docs): quickstart, auth, filters, endpoints, credits, errors, monitors, MCP - [Docs as Markdown](https://latestnewsapi.com/docs.md) - [Pricing](https://latestnewsapi.com/pricing): plans, credits, FAQ - [News API for AI agents](https://latestnewsapi.com/news-api-for-ai-agents): MCP server and RAG tips - [Türkiye News API](https://latestnewsapi.com/turkiye-news-api): Türkiye edition (data in English; Turkish text via article lang=tr) - [Haber API (Türkçe)](https://latestnewsapi.com/haber-api) - [OpenAPI spec](https://latestnewsapi.com/openapi.json)