Szybki start
Pobierz klucz, skopiuj linię, uruchom ją, przeczytaj JSON.
0. Pobierz klucz
Utwórz darmowe konto, otwórz Klucze API i wygeneruj jeden. Następnie przechowuj go w zmiennej środowiskowej:
export FNA_KEY=fna_live_...1. Wyszukaj
curl -H "Authorization: Bearer $FNA_KEY" "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"
}
]
}Trzy pola w odpowiedzi warto zauważyć od razu. total to liczba artykułów, które pasują do kryteriów, a nie liczba zwróconych wyników – jest ona ograniczona do 10,000 dla zachowania szybkości, a total_is_lower_bound informuje, kiedy osiągnięto to ograniczenie. country_source wskazuje, jak ustalono kraj, co ma znaczenie, ponieważ około jedna trzecia wartości krajowych w dowolnym zbiorze wiadomości to wnioski, a nie fakty. crawled_at to uczciwy znacznik czasu: wydawcy mogą cofać datę publikacji published_at, ale czas indeksowania jest przypisywany przez potok danych.
2. Zawęź wyniki
Filtry łączą się operatorem AND między parametrami oraz OR w ramach jednego parametru. Zatem country=DE,AT&lang=de oznacza „artykuły w języku niemieckim z Niemiec lub Austrii”. Pytanie o dzisiejsze artykuły w języku ukraińskim z Ukrainy, od najnowszych:
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=date&size=10"3. Pobierz pełny tekst
Wyniki wyszukiwania domyślnie pomijają treść artykułu, aby zmniejszyć rozmiar odpowiedzi. Poproś o nią jawnie, gdy wybierzesz artykuły, które naprawdę chcesz:
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=inflation&full_text=true&size=5"Pełny tekst ma około 2,000–4,000 znaków na artykuł. Dwadzieścia artykułów z full_text=true to około 40,000 tokenów dla modelu językowego. Najpierw wybierz, potem pobieraj treści. Zobacz koszty tokenów.
4. Zliczaj zamiast wypisywać
Często użytecznym pytaniem nie jest "jaki jest artykuł", ale "czy w ogóle jest tu coś, i gdzie to jest". Policz odpowiedzi za ułamek kosztu — około 200 tokenów w przeciwieństwie do kilku tysięcy na stronę wyników — co sprawia, że jest to właściwe pierwsze wywołanie dla agenta decydującego, czy wyszukiwanie jest warte uruchomienia:
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"Odpowiedź zawiera liczniki podzielone według kraju, języka, domeny, wydawcy i dnia, obliczone dla całego zbioru pasujących wyników, a nie tylko dla aktualnej strony.
W Pythonie
import os, requests
HEADERS = {"Authorization": "Bearer " + os.environ["FNA_KEY"]}
r = requests.get("https://freenewsapi.ai/v1/search", headers=HEADERS, params={
"q": "semiconductor export controls",
"date": "7d",
"lang": "en",
"size": 20,
"sort": "relevance",
})
for a in r.json()["results"]:
print(a["published_at"], a["host"], a["title"])W JavaScript
const url = new URL("https://freenewsapi.ai/v1/search");
url.search = new URLSearchParams({ q: "central bank", date: "24h", size: "20" });
const { results } = await (await fetch(url, { headers: { Authorization: `Bearer ${FNA_KEY}` } })).json();
results.forEach(a => console.log(a.published_at, a.host, a.title));