News-APIs werden normalerweise pro Anfrage verkauft, hinter einem Schlüssel versteckt und auf der kostenlosen Stufe auf hundert Aufrufe pro Tag begrenzt. Free News API ist keines davon: 21,5 Millionen Artikel in einem laufenden 90-Tage-Fenster, über 25.000 Publisher, kein Schlüssel, kein Login, keine Kontingentbegrenzung, kommerzielle Nutzung erlaubt. Hier ist die gesamte Oberfläche – Suche, Statistiken, Trends, Märkte, Feeds und MCP – und ein ehrlicher Bericht darüber, wo die Daten Fehler machen.
Die Struktur des Problems
Fragen Sie einen KI-Agenten, worüber die Welt gerade schreibt, und er hat drei schlechte Optionen. Er kann Publisher direkt scrapen, was fragil, langsam und rechtlich unscharf ist. Er kann ein kommerzielles News-API aufrufen, was ein Konto, einen Schlüssel, eine monatliche Rechnung und – auf jeder kostenlosen Stufe auf dem Markt – hundert Anfragen pro Tag und um 24 Stunden verzögerte Artikel bedeutet. Oder er kann aus Trainingsdaten raten, die vor Monaten aktualisiert wurden.
Free News API entfernt die Kosten und den Verwaltungsaufwand der mittleren Option, ohne ihre Leistungsfähigkeit zu beeinträchtigen. Eine einzige GET-Anfrage, keine Anmeldeinformationen, über einen Korpus, der zum Zeitpunkt des Schreibens 21.557.044 Artikel von mehr als fünfundzwanzigtausend Publishern enthält, die in einem laufenden Neunzig-Tage-Fenster gespeichert und kontinuierlich aktualisiert werden – der neueste Artikel im Index ist in der Regel weniger als zwei Minuten alt.
Vier Kernendpunkte und noch mehr
Der Kern des Dienstes sind vier GET-Endpunkte, alle unter https://freenewsapi.ai, die alle UTF-8 JSON mit Access-Control-Allow-Origin: * zurückgeben, sodass Browser-Code sie direkt aufrufen kann, und die alle die Serverzeit in took_ms melden.
| Endpunkt | Welche Frage beantwortet er |
|---|---|
GET /v1/search | Volltextsuche mit Filtern. Der Endpunkt, den Sie 95 % der Zeit verwenden. |
GET /v1/stats | Aggregierte Zählwerte für beliebige Ausschnitte — nach Land, Sprache, TLD, Verlag und Tag. |
GET /v1/article | Ein Artikel mit seiner exakten URL, einschließlich des vollständigen Textes. |
GET /health | Liveness plus die aktuelle Anzahl der Dokumente. Günstig genug für regelmäßige Abfragen. |
Um diesen Kern herum gruppieren sich vier weitere Kategorien, die jeweils an anderer Stelle eigenständige Produkte wären: Trends (Live-Clustering von Nachrichten nach Ländern), Märkte (Preisverläufe im Verhältnis zum Berichterstattungs volumen), Krypto-Sentiment (ein Bitcoin-Block mit sieben Endpunkten) und Syndizierung (dieselbe Suche als RSS, Atom oder JSON-Feed). Alle diese Bereiche werden im Folgenden behandelt.
curl "https://freenewsapi.ai/v1/search?q=climate+summit&size=2"{
"took_ms": 41,
"total": 1284,
"total_is_lower_bound": false,
"size": 2,
"offset": 0,
"results": [
{
"id": "9c1f8a4b2d3e5f6071829304a5b6c7d8",
"url": "https://example-news.com/world/climate-summit-opens",
"title": "Climate summit opens with a call for binding targets",
"description": "Delegates from 190 countries gathered on Monday ...",
"published_at": "2026-08-17T09:12:00Z",
"crawled_at": "2026-08-17T10:48:31Z",
"host": "example-news.com",
"sitename": "Example News",
"country": "GB",
"country_source": "cctld",
"lang": "en",
"tld": "com"
}
]
}Drei Felder in dieser Antwort verdienen sofortige Aufmerksamkeit, da sie die Ehrlichkeit des gesamten Datensatzes widerspiegeln. total_is_lower_bound zeigt an, wenn die Trefferzahl die Obergrenze von 10.000 erreicht hat und die Zählung stoppt. country_source zeigt wie das Land ermittelt wurde — denn in jedem Nachrichten-Datensatz sind viele Länderangaben Schlussfolgerungen und keine Fakten. Und crawled_at ist der vertrauenswürdige Zeitstempel: Verlage datieren published_at regelmäßig rückwirkend, aber die Crawling-Zeit wird von der Pipeline festgelegt und schreitet nur vorwärts.
Suche: Jeder relevante Parameter
Alle Parameter sind optional. Ein Aufruf ohne Parameter gibt die neuesten Artikel im Index zurück.
Die Suchanfrage
- q Abgeglichen mit Titel (Gewichtung 3), Beschreibung (Gewichtung 2) und dem Artikeltext. UND-Logik — jeder Begriff muss vorhanden sein, daher schränkt das Hinzufügen eines Wortes das Ergebnis ein, statt es zu erweitern. Maximale Länge: 500 Zeichen.
opec production cut funktioniert. what did OPEC decide about oil liefert nichts zurück.Die Filter
Filter kombinieren sich mit UND über Parameter hinweg und ODER innerhalb eines Parameters. country=DE,AT&lang=de liest sich also als „Artikel in deutscher Sprache aus Deutschland oder Österreich“. Jeder Filter akzeptiert eine durch Komma getrennte Liste mit bis zu fünfzig Werten.
| Filter | Format | Hinweise |
|---|---|---|
country | ISO 3166-1 alpha-2, Großbuchstaben | Herkunftsland des Publishers. Abgeleitet, nicht deklariert — siehe country_source und strict_country. |
lang | ISO 639-1, Kleinbuchstaben | Aus dem Dokument selbst erkannt. 99,9 % Abdeckung. |
tld | kein Punkt | Domain-Endung des Publishers. tld=ua ist eine Tatsache; country=UA ist eine Schlussfolgerung. |
host | exakte Hostnamen | So, wie sie in URL erscheinen — www. einschließen, wenn der Publisher dies verwendet. |
date | heute · gestern · 24h · 48h · 7d · 30d | Voreingestellter Zeitraum, ausgewertet anhand von published_at. |
from / to | ISO-Daten | Expliziter Zeitraum, in dem die Voreinstellungen nicht passen. |
strict_country | true/false | Nur Artikel zählen, bei denen das Land eine gesicherte Tatsache und keine Schlussfolgerung ist. |
Ausgabe-Steuerung
| Parameter | Werte | Auswirkung |
|---|---|---|
sort | date · date_asc · crawled · crawled_asc · relevance | Sortieren nach crawled beim Abfragen nach neuen Artikeln — Verlage datieren Veröffentlichungszeiten zurück; die Crawl-Zeit schreitet nur vorwärts. |
size | 1–100 | Ergebnisse pro Seite. |
offset | 0–9900 | Seitenversatz (Paging Offset). |
full_text | true/false | Artikeltext einschließen. Standardmäßig deaktiviert. |
highlight | true/false | Übereinstimmende Textfragmente zurückgeben. |
fields | CSV | Die Antwort auf die tatsächlich verwendeten Felder beschränken. |
curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=date&size=10"curl "https://freenewsapi.ai/v1/search?q=merger&country=DE&date=48h&sort=date&size=20"Zählen vor der Suche
Der am seltensten genutzte Endpunkt des Dienstes ist /v1/stats. Oft ist die nützliche Frage nicht „Was sind die Artikel“, sondern „Gibt es hier überhaupt etwas, und wenn ja, wo?“ Das Zählen von Ergebnissen kostet nur einen Bruchteil — etwa zweihundert Token im Vergleich zu mehreren Tausend für eine Ergebnisseite — und macht es zum richtigen ersten Aufruf für einen Agenten, der entscheidet, ob sich eine Suche lohnt.
curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"Es gibt Zählungen nach Land, Sprache, TLD, Herausgeber und Tag zurück, berechnet für die gesamte Treffermenge und nicht nur für die aktuelle Seite. So können Sie auch die Abdeckung messen, bevor Sie ihr vertrauen. Die unfilterierte Momentaufnahme zum Zeitpunkt der Erstellung:
Führende Länder
| Land | Artikel |
|---|---|
| Indien | 2,286,014 |
| Vereinigte Staaten | 2,180,797 |
| Türkei | 1,499,897 |
| Russland | 1,436,556 |
| Italien | 1,057,479 |
| Argentinien | 826,947 |
| Spanien | 812,347 |
| Ukraine | 662,041 |
| Brasilien | 551,013 |
| Deutschland | 543,132 |
| Frankreich | 502,846 |
| Griechenland | 460,372 |
| Japan | 437,209 |
| Vietnam | 408,934 |
| Mexiko | 402,320 |
| Südkorea | 362,945 |
| Rumänien | 354,229 |
| Vereinigtes Königreich | 334,379 |
| Iran | 291,782 |
| Polen | 255,599 |
Hauptsprachen
Englisch 5.513.650 · Spanisch 2.699.457 · Russisch 1.785.796 · Türkisch 1.501.004 · Italienisch 992.200 · Deutsch 733.677 · Französisch 689.136 · Arabisch 664.016 · Portugiesisch 637.607 · Hindi 560.840 · Griechisch 466.504 · Japanisch 427.085 · Vietnamesisch 385.719 · Rumänisch 358.766 · Chinesisch 352.720 · Ukrainisch 345.809 · Koreanisch 335.079 · Persisch 268.126 · Polnisch 238.904 · Bulgarisch 183.204.
Diese Verteilung lohnt einen genaueren Blick, denn sie steht im Gegensatz zu dem, was die meisten Nachrichten-APIs liefern. Der übliche, englisch- und US-zentrierte Korpus ist hier nicht vorherrschend: Indien liegt vor den Vereinigten Staaten, Türkisch vor Deutsch, und Griechisch, Vietnamesisch, Persisch und Bulgarisch weisen alle sechsstelligen Vertreter auf. Wenn Ihre Frage eine nicht-englische Presse betrifft, handelt es sich um einen deutlich anderen Datensatz.
Volumen
Die tagesbezogene Kurve in by_day deckt den gesamten Zeitraum von neunzig Tagen ab. Die letzten Tage liegen im Bereich von etwa 400.000 bis 700.000 Artikeln pro Tag; früher im Zeitraum, bevor die RSS-Schicht zusammen mit der Archiv-Einspeisung hinzugefügt wurde, lag das tägliche Volumen bei 130.000 bis 230.000. Beide Werte sind in derselben Antwort sichtbar, was den Punkt verdeutlicht: Der Dienst zeigt Ihnen seine eigene Steigerung an, statt einen Marketing-Durchschnitt zu zitieren.
Trends: Was die Presse gerade tatsächlich behandelt
Die Suche beantwortet die Frage „was wurde über X geschrieben“. Trends beantwortet eine andere und oft bessere Frage: „was gerade passiert“ — ohne dass ein X erforderlich ist.
Ein Roboter gruppiert Artikel nach Ländern zu Geschichten und hält sie aktuell. Alle fünf Minuten werden neue Artikel durch ihre identifizierenden Wörter bekannten Geschichten zugeordnet, ganz ohne Aufruf eines Modells; alle paar Stunden durchläuft ein Land eine vollständige Überprüfung, bei der ein Sprachmodell die Schlagzeilen liest und die Geschichten von Grund auf neu benennt. Zum Zeitpunkt der Abfassung deckt die Trend-Schicht 115 Länder ab, die jeweils innerhalb der letzten Minuten neu berechnet wurden.
curl "https://freenewsapi.ai/v1/trends?country=US&window=24h&size=5"{
"window": "24h",
"filters": { "country": ["US"], "min_publishers": 1 },
"trends": [
{
"title": "Hurricane Marie threatens Labor Day weather",
"slug": "hurricane-marie-threatens-labor-day-weather",
"country": "US",
"category": "weather",
"articles": 57,
"publishers": 24,
"first_seen": "2026-09-05T19:24:36Z",
"latest": "2026-09-06T19:00:04Z",
"url": "https://freenewsapi.ai/trends/us/hurricane-marie-…",
"headlines": [ … ]
}
]
}Jeder Geschichte sind zwei Zählwerte zugeordnet, die unterschiedliche Bedeutungen haben. articles (Artikel) ist die Lautstärke; publishers (Verlage) ist die Breite. Eine Geschichte mit 200 Artikeln aus 4 Redaktionen ist die Obsession einer einzelnen Nachrichtenredaktion. Eine Geschichte mit 60 Artikeln aus 40 Verlagen ist ein Ereignis. Die Standardsortierung erfolgt nach Verlagen, und min_publishers / min_articles ermöglichen es Ihnen, die Grenze selbst festzulegen.
Den Stories wird eine Kategorie aus einem festen Satz von Kategorien zugeordnet: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.
Das Fenster ist eine Wahl des Lesers, nicht des Roboters.
Dies ist eine wirklich elegante Designentscheidung. Jeder Artikel wird zusammen mit seiner Veröffentlichungszeit gespeichert und einer Story zugeordnet, sodass jedes Fenster – ob fünfzehn Minuten, eine Stunde, ein Tag oder ein bestimmtes Kalenderdatum – einfach eine Bereichsabfrage über dieselben gespeicherten Daten ist. Eine einzige Berechnung bedient jedes Fenster gleichzeitig. window=15m, window=1h, window=24h, date=2026-09-01 oder ein explizites since/until-Paar funktionieren alle gegen denselben Index ohne Neukomputation.
Schlüsselwörter: Die Wörter, auf denen die Nachrichten basieren
curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"Jedes Schlüsselwort wird zusammen mit der Anzahl der verschiedenen Stories zurückgegeben, die es enthalten, der Anzahl der Artikel, die diese Stories beinhalten, und – das Interessante daran – wie viele nationale Presseorgane es verwenden. Diese letzte Zahl ist der Unterschied zwischen einem globalen Ereignis und einem nationalen. Ein Wort, das in siebzig Ländern auftaucht, ist eine Weltgeschichte; ein Wort, das die Presse eines einzigen Landes dominiert, ist eine nationale Geschichte, egal wie laut es dort ist.
Welche Länder sind live
curl "https://freenewsapi.ai/v1/trends/countries"Gibt jedes verfolgte Land mit seiner aktuellen Story-Anzahl und der Anzahl der Minuten zurück, seit der letzten Neuberechnung – die Türkei, Russland, Iran, Griechenland, Indien, Italien, Ukraine, Rumänien, Argentinien, Deutschland und Brasilien führen derzeit jeweils Tausende von Live-Stories, die innerhalb der letzten zehn Minuten neu berechnet wurden. Und /v1/trends/{cc}/{slug} öffnet eine einzelne Story mit ihrer vollständigen Artikel-Liste.
Märkte vs. Berichterstattung: Preis auf einer Achse, Aufmerksamkeit auf der anderen
Dies ist das Ungewöhnlichste an diesem Dienst, und es existiert, weil der Korpus es nahezu kostenlos macht, es zu bauen. Legen Sie eine Preisreihe neben die Menge an Text, die die Welt in denselben Stunden über dieses Thema geschrieben hat, in einer einzigen Zeitleiste.
curl "https://freenewsapi.ai/v1/markets"Vierzehn Instrumente werden über vier Anlageklassen hinweg verfolgt:
| Klasse | Instrumente | Granularität | Quelle |
|---|---|---|---|
| Krypto | Bitcoin, Ethereum, Solana, XRP, BNB, Dogecoin | Stunde | Binance |
| Edelmetalle | Gold (USD/oz) | Stunde | Binance |
| FX | EUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLN | Tag | EZB |
| Energie | Deutscher Strompreis (EUR/MWh) | Stunde | Energy-Charts |
curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"Dieser einzelne Aufruf liefert dir den Kurs der türkischen Lira gegenüber dem US-Dollar sowie das Volumen der türkischen Presseberichterstattung im selben Zeitraum, stundengenau abgeglichen. Die türkische Presse macht den drittgrößten Anteil dieses Korpus aus, weshalb genau diese Kombination etwas Sinnvolles und nicht nur Rauschen erzeugt.
Und ein vollständiger Bitcoin-Sentiment-Block
Bitcoin erhält eine eigene Familie mit sieben Endpunkten, da es das einzige Instrument ist, bei dem der Zusammenhang zwischen Nachrichtenstimmung und Kursbewegung ständig diskutiert, aber selten gemessen wird:
| Endpunkt | Renditen |
|---|---|
/v1/btc/summary | Aktueller Kurs, jüngste Bewegungen und die Stimmung der heutigen Berichterstattung. |
/v1/btc/price | BTC/USDT-Kerzen nach Intervall. |
/v1/btc/sentiment | Nachrichtenstimmung pro Zeitraum. |
/v1/btc/series | Kurs und Stimmung auf einer einzigen Zeitleiste abgeglichen. |
/v1/btc/correlation | Korrelation zwischen Stimmung und Kursbewegung mit Zeitverschiebung — führt die Berichterstattung dem Kurs voraus oder folgt sie ihm? |
/v1/btc/news | Krypto-Artikel mit ihrem Sentiment-Label, filterbar nach Label, Host, Sprache und Suchanfrage. |
/v1/btc/sources | Welche Medien berichten über Kryptowährungen und wie sich jede einzelne Quelle positioniert. |
Die Sentiment-Bewertungen stammen von einem Sprachmodell, das alle fünf Minuten frische Krypto-Artikel durchläuft, abgeglichen mit einer kalibrierten Münzliste. /v1/btc/correlation mit einem max_shift-Parameter ist der richtige Ansatz, wenn Sie die Behauptung „Die Nachrichten verursachen die Kursbewegung“ testen möchten, anstatt sie nur zu wiederholen.
Die gleiche Suche als Feed
Drei weitere Endstellen übernehmen dieselben Suchparameter und geben die Ergebnisse als Syndikationsformate anstelle von JSON aus:
GET /v1/rss— RSS 2.0GET /v1/atom— Atom 1.0GET /v1/feed.json— JSON Feed 1.1
https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=dateDas bedeutet, dass jede gespeicherte Suche zu einem Feed wird, den Sie in einen Reader, einen n8n-Knoten, eine Slack-Integration, einen Zapier-Trigger oder einen Static-Site-Generator einfügen können — ganz ohne Code und ohne API-Schlüssel. Es ist eine kleine Funktion, die für Nicht-Entwickler still und unauffällig eine gesamte Integrationsschicht eliminiert.
MCP: Achtundzwanzig Tools, zwei Ebenen
Der MCP-Server befindet sich an einer einzigen URL, spricht Streamable HTTP (JSON-RPC 2.0 über POST, Protokollversion 2025-06-18), unterstützt Batching und hat — wie alles andere hier auch — keinen Autorisierungsschritt und keine Session-ID.
claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcpEs stellt 28 Tools in zwei bewussten Ebenen bereit.
Ebene eins: sechs Shortcuts, die eine ganze Frage in einem einzigen Aufruf beantworten
| Tool | Dafür |
|---|---|
search_news | „Was wurde über X geschrieben“ — Volltextsuche, gekürztes Ergebnis. |
get_trends | "Was passiert" — gruppierte Geschichten statt einer Liste von Artikeln. |
trend_keywords | Die Wörter, auf denen die Nachrichten aktuell aufbauen, mit Story-Anzahlen und Länderverteilung. |
find_publishers | Nachschauen von Medien: Name, Domain, Land, Sprache, Artikel pro Tag. |
list_countries | Welche Länder haben Live-Geschichten, wie viele und wie aktuell. |
market_vs_news | Eine Preiskurve neben dem Berichterstattungs-Volumen. Aufrufen ohne Instrument, um zu sehen, was verfügbar ist. |
Ebene zwei: Jeder Endpunkt, generiert aus dem Dienst selbst
Unter den Shortcuts wird jeder rohe Endpunkt als eigenständiges Tool mit allen Parametern freigegeben, die API akzeptiert — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, die gesamte news_get_btc_*-Familie, die Feed-Renderer und news_get_health. Diese werden vom Live-Dienst generiert, daher können sie nicht von dem abweichen, was API tatsächlich akzeptiert.
Zwei Meta-Tools schließen den Kreis: news_list_endpoints gibt den Katalog von allem zurück, was verfügbar ist, und news_get führt eine rohe GET auf jedem Pfad aus — sodass ein Agent, der auf einen Endpunkt trifft, der nicht von seiner Tool-Liste abgedeckt wird, diesen dennoch erreichen kann.
curl "https://freenewsapi.ai/mcp?format=json"Eine GET, kein Handshake, und Sie haben den gesamten maschinenlesbaren Katalog: Server, Transport, Protokoll, Tool-Anzahl, jedes Tool mit seiner Beschreibung und jeden Endpunkt mit seiner Parameterliste.
Für Maschinen lesbar konzipiert
Die Dokumentation ist kein nachträglich an API angehängter Zusatz — sie ist eine erstklassige Ausgabe desselben. Die Seite liefert 665 statische Seiten aus, und einige davon existieren speziell dafür, dass ein Modell kein HTML lesen muss:
- /openapi.json Das vollständige OpenAPI-Schema.
- /llms.txt Eine kurze Orientierungshilfe — was der Dienst ist, die Endpunkte, wie man ihn effektiv abfragt und welche Fehler auftreten können.
- /llms-full.txt Die gesamte Dokumentation als eine einzige Textdatei, mit weit über hundert Kilobyte an Inhalt, damit ein Agent das gesamte Handbuch bei einem einzigen Abruf erfassen kann.
- /agents Neununddreißig Seiten, die sich gezielt an Agent-Entwickler richten: vorgefertigte OpenAI-Funktionsdefinitionen, Anthropic-Toolnutzungsdefinitionen, System-Prompts für die Nachrichtenabfrage, RAG-Rezepte, Tabellen zu Token-Kosten und Agenten-Rezepte.
- /agents/models Code für Tool-Aufrufe pro Modelfamilie — Qwen, DeepSeek, MiniMax, Kimi, GLM, Doubao, Hunyuan, ERNIE, Yi, Step, GPT, Claude, Gemini, Grok, Mistral, Llama, Command, Nova, Phi, Jamba, Sonar, OpenRouter, Ollama, vLLM.
- /data Was sich im Korpus befindet, die Methodik, das Index-Schema und eine Seite mit dem Titel Datenqualität, die dokumentiert, wo der Datensatz Fehler aufweist.
- /sources Ein durchsuchbarer Katalog mit 11.668 Verlagen, der nach Land, Sprache und Domain-Endung gefiltert werden kann.
- /compare Seiten zum direkten Vergleich mit NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube und FreeNewsAPI.io.
Plus 168 Länderseiten, 121 Sprachseiten und 275 TLD-Seiten — eine durchsuchbare Oberfläche für jeden Ausschnitt des Korpus, die jeweils zeigt, was sich tatsächlich darin befindet.
Woher die Artikel stammen
Zwei Ingest-Pfade speisen denselben Index, und der Unterschied zwischen ihnen ist relevant.
Der Archiv-Pfad
Alle zehn Minuten prüft ein Job das CC-NEWS-Archiv von Common Crawl auf neue WARC-Dateien und verarbeitet alles, was ihm noch nicht bekannt ist, unter Verwendung von vierzig parallelen Workern. Der Extraktor zieht jeden Artikel aus dem Rohcrawl mit einer dokumentierten Kaskade pro Feld heraus — und die Kaskaden wurden an echten Daten gemessen, anstatt sie einfach anzunehmen:
| Feld | Kaskade | Abdeckung |
|---|---|---|
| description | JSON-LD → meta → OpenGraph → Twitter-Karte → articleBody → Einleitung | 98.1% |
| language | <html lang> → JSON-LD inLanguage → og:locale | 99.9% |
| country | ccTLD → JSON-LD addressCountry → Sprache-Region → og:locale | 79.1% |
| date | JSON-LD datePublished → meta → trafilatura → Crawl-Zeit | 100% |
Diese Länderzuordnung ist die ehrliche Variante, und genau deshalb wird country_source in jedem Artikel ausgegeben: Bei etwa einem Fünftel der Datensätze gibt es überhaupt kein zuverlässiges Ländersignal, und bei etwa einem Drittel der vorhandenen Werte handelt es sich um Schätzungen statt um Fakten. Der API zeigt Ihnen an, was jeweils zutrifft, anstatt es zu verschleiern.
Der Live-Pfad
Ein zweiter Roboter ruft die Feed-Daten von RSS alle fünf Minuten ab, im Wechsel mit bedingten Anfragen. Ein Feed, der die Antwort 304 Not Modified liefert, verursacht fast keine Kosten, und die Abfrageintervalle jedes Feeds werden so eingestellt, dass sie der tatsächlichen Veröffentlichungshäufigkeit entsprechen. Ein Verlag, der fünf Artikel pro Tag veröffentlicht, wird nicht alle fünfzehn Minuten abgerufen.
Er übernimmt zudem nur das, was der Verlag in den Feed aufgenommen hat: Titel, Einleitung und den Volltext, sofern der Feed diesen enthält. Er ruft nicht auf der Website des Verlags ab, um mehr Inhalte zu erhalten. Dies ist eine bewusste Grenze, und genau das ist der Grund, warum der Dienst die Zusagen auf seiner verlagsspezifischen rechtlichen Seite einhalten kann.
Und die Infrastruktur rundum
Um die beiden Erfassungspfade herum stehen weitere zwölf Roboter mit festen Zeitplänen: Quellenermittlung und Synchronisation, Länderzuordnung pro Domain, Trendbildung und Prüfung, Keyword-Auffüllung, Krypto-Sentiment, Marktabfragen, ein Taxonomie-Katalog, Retention (das 90-Tage-Fenster wird durch eine nächtliche Abfrage von published_at erzwungen, nicht durch das Alter im Index), Tagesprüfung, Nachprüfung leerer Artikel und eine Gesundheitsüberwachung, die alles neu startet, was stehen geblieben ist. Die Datensammlung befindet sich auf einem dedizierten Elasticsearch-Cluster.
Was dieser Datensatz nicht richtig abbildet
Der Dienst gibt seine eigenen Einschränkungen bekannt, was der schnellste Weg ist, um zu beurteilen, ob er zu Ihrem Anwendungsfall passt.
- Das Land wird geschätzt Lesen Sie
country_sourcein jedem Artikel, und fügen Siestrict_country=truehinzu, wenn Sie nach Ländern zählen, statt zu browsen. - published_at wird vom Verlag bereitgestellt Das Zurückdatieren ist üblich. Sortieren Sie nach
crawled, wenn Sie nach neuen Inhalten suchen. - total ist auf 10.000 begrenzt Wegen der Geschwindigkeit.
total_is_lower_boundteilt Ihnen mit, wenn Sie die Obergrenze erreichen. - Kein Sentiment oder Entity-Extraktion Außerhalb des Bitcoin-Blocks enthalten die Artikel weder einen Sentiment-Wert noch benannte Entitäten. Das liegt nicht im Leistungsumfang.
- Neunzig Tage und nicht mehr Es gibt kein tieferes Archiv. Wenn Sie Daten aus 2019 benötigen, ist dies das falsche Werkzeug.
- Kein SLA Es ist kostenlos. Es wird zwar überwacht und geschützt, aber es gibt keine schriftlichen Zusagen.
- Der Text gehört den Verlagen Jede Antwort enthält den Original-URL, und von den Aufrufern wird erwartet, dass sie darauf verlinken.
Gute Nutzung: Kosten, Paginierung und Fehler
Token-Disziplin
Für einen Agenten ist die Antwortgröße die eigentliche Kostenkomponente. Die dokumentierte Struktur sieht so aus:
| Aufruf | Ungefähre Token-Kosten | Wann |
|---|---|---|
/v1/stats | ~200 | Zuerst: Entscheiden Sie, ob sich die Suche überhaupt lohnt. |
/v1/search nur Metadaten | ein paar Tausend pro Seite | Scannen und auswählen. |
/v1/search?full_text=true | ~900 pro Artikel | Nur für die wenigen, die Sie tatsächlich ausgewählt haben. |
Zwanzig Artikel mit full_text=true ergeben etwa 40.000 Tokens. Das empfohlene Muster ist immer dasselbe: zählen, scannen und dann die Texte nur für die wenigen Artikel abrufen, die Sie benötigen.
Seitenzahlen jenseits der Obergrenze
offset stoppt bei 9.900. Um eine große Menge zu durchlaufen, sollten Sie nicht gegen die Obergrenze kämpfen, sondern stattdessen nach Zeit filtern. Schleifen Sie tageweise oder bei einer stark frequentierten Abfrage stundenweise mit from/to und sort=date. Die Dokumentation enthält eine eigene Seite zum Durchlaufen eines gesamten Tages.
Fehler
Der Vertrag ist klar und einfach zu implementieren: 4xx bedeutet, dass die Anfrage fehlerhaft ist — beheben Sie sie, versuchen Sie keinen erneuten Aufruf. 5xx bedeutet, dass der Dienst nicht verfügbar ist — warten Sie ab. 429 bedeutet, verlangsamen Sie sich und versuchen Sie es erneut. Unbekannte Abfrageparameter werden ignoriert, anstatt abgelehnt zu werden, sodass das Hinzufügen eines Feldes einen bestehenden Aufrufer niemals beschädigen kann.
Identifizieren Sie sich (Optional, und wirklich optional)
Ohne einen Schlüssel gibt es keine Möglichkeit, den Aufrufer zu erreichen. Die empfohlene Höflichkeit besteht darin, einen Header zu verwenden, der Ihren Agenten, das Framework, durch das er läuft, und das Modell, das ihn antreibt, benennt:
X-Agent: agent_name=<agent>; software=<langchain|llamaindex|n8n|claude-desktop|cursor|openai-assistants|crewai|custom>; model=<model>; version=<v>; purpose=<rag|monitoring|research|digest>; contact=<url or mailto>
User-Agent: <agent>/<version> (+<contact url>)Die gleichen Werte können auch als einfache Abfrageparameter verwendet werden, was meist einfacher ist:
https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4oUnbekannte Schlüssel werden ignoriert, sodass zusätzliche Schlüssel immer sicher gesendet werden können. Es findet keine Validierung statt, und das Auslassen führt nicht zu einer Drosselung. Die eine feste Anweisung lautet: Geben Sie niemals personenbezogene Daten von Endnutzern in diesen Feldern an.
Gegen die bezahlten Nachrichten API
Die Vergleichsseiten auf der Website behandeln elf Wettbewerber einzeln. Die strukturellen Unterschiede, die bei allen bestehen:
100 Anfragen/Tag, 24-Stunden-Verzögerung
Das Standardmodell eines kostenlosen News-API-Tarifs: ein Token-Bucket, der klein genug für eine Demo ist, wobei frische Artikel für zahlende Kunden zurückgehalten werden.
- Schlüssel erforderlich
- Tägliches Limit
- Verzögerte Artikel
- Nur nicht-kommerzielle Nutzung
Kein Limit, keine Verzögerung, kein Schlüssel
Das einzige Limit sind 20 Anfragen pro Sekunde pro IP. Der neueste Artikel ist in der Regel weniger als zwei Minuten alt, und die kommerzielle Nutzung ist gestattet.
- Kein Schlüssel, kein Registrierungsprozess
- Kein tägliches oder monatliches Limit
- Kontinuierliche Aktualisierung
- Kommerzielle Nutzung gestattet
Englisch im Fokus, USA im Fokus
Die meisten Korpora basieren auf einer englischsprachigen Verzeichnisliste, an die sich der Rest der Welt anhängt.
- Englisch dominiert
- Dünne Abdeckung nicht-lateinischer Sprachen
Indien > USA, Türkisch > Deutsch
Rund 100 Sprachen mit sechsstelligen Volumina in Griechisch, Vietnamesisch, Persisch, Ukrainisch und Bulgarisch.
- 100 Länder
- ~100 Sprachen
- 11.668 katalogisierte Quellen
Was die kostenpflichtigen Dienste im Gegensatz dazu noch bieten: Standaardfelder für Stimmungsanalysen und Entitätserkennung, Archive, die Jahre zurückreichen, und ein Vertrag mit einer SLA. Das sind echte Vorteile, und wenn Sie diese benötigen, sollten Sie sie kaufen.
Rezepte
Ein Live-Ländermonitor
curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"Ist diese Geschichte global oder national?
curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world eventEin Modell günstig auf die aktuelle Berichterstattung stützen
# 1. count first
curl "https://freenewsapi.ai/v1/stats?q=semiconductor+export+controls&date=7d"
# 2. scan metadata
curl "https://freenewsapi.ai/v1/search?q=semiconductor+export+controls&date=7d&lang=en&size=20&sort=relevance"
# 3. fetch bodies for the three you picked
curl "https://freenewsapi.ai/v1/article?url=<exact-url>&full_text=true"Führt die Berichterstattung den Preis?
curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"Eine gespeicherte Suche in einen Feed umwandeln
https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50Finden Sie die für Ihren Markt relevanten Medien
curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that sliceDie Kurzversion
Free News API ist eine Volltextsuche über 21,5 Millionen Nachrichtenartikel von mehr als 25.000 Verlagen in 100 Ländern und rund 100 Sprachen, mit einem fortlaufenden 90-Tage-Fenster, kontinuierlich aktualisiert, ohne API-Schlüssel, ohne Registrierung und ohne Kontingentbeschränkung außer einem pro-IP-Ratenlimit. Obenauf liegen Live-Clustering von Nachrichten nach Ländern für 115 Länder, Keyword-Analyse, die Weltgeschehen von inneren Angelegenheiten trennt, vier Marktindikatoren im Vergleich zur Berichterstattungsintensität, ein Bitcoin-Sentiment-Block mit sieben Endpunkten, RSS/Atom/JSON-Syndikation für jede beliebige Abfrage sowie ein 28-Tool-MCP-Server, der aus dem Dienst selbst generiert wird.
Es dokumentiert seine eigenen Fehlerquoten, zeigt auf, wie jeder Länderwert ermittelt wurde, und veröffentlicht eine Seite mit Informationen zu den Ungenauigkeiten der Daten. Für einen Agenten, der wissen muss, was die Welt gerade sagt – auf Türkisch, auf Griechisch, auf Hindi – ist diese Kombination zu jedem Preis schwer zu finden, und diese hier ist kostenlos.
Die Suche funktioniert AND über alle Begriffe. Verwenden Sie 2–5 Schlüsselwörter, keine natürlichen Fragen.
Free News API, wie man es gut abfragt
Starten Sie hier: freenewsapi.ai · MCP unter freenewsapi.ai/mcp · das gesamte Handbuch als eine Datei unter /llms-full.txt.