API-dokumentation
Fyra GET-slutpunkter och en nyckel. Varje exempel på denna sida är en live-begäran: ange FNA_KEY och klistra in det i en terminal.
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"Bas-URL
Alla slutpunkter finns under https://freenewsapi.ai. Endast HTTPS; vanlig HTTP omdirigeras. Svar är JSON, UTF-8, med Access-Control-Allow-Origin: * så att webbkod kan anropa API:et direkt.
Slutpunkter
GET /v1/search
Fulltextsökning med filter efter land, språk, TLD, värd och datum. Slutpunkten du kommer att använda 95% av tiden.
GET /v1/stats
Aggregerade antal för valfri del: hur många artiklar per land, språk, domäntyp och nyhetsutgivare.
GET /v1/article
Hämta en artikel via dess exakta URL, inklusive hela artikeltexten.
GET /health
Liveness plus det aktuella dokumentantalet. Billigt nog att poll:a.
Vad finns i corpuset
Ungefär 100–110 tusen nyhetsartiklar per dag, från 25,000+ utgivare i 90+ länder och 50+ språk. Varje artikel innehåller titel, beskrivning, fullständig text, publiceringstid, utgivare, land, språk och original-URL.
Fönstret är rullande: de senaste 30 dagarna är sökbara, äldre artiklar tas bort. Nya artiklar landar varje timme, ungefär 90 minuter efter att de har crawlats. Se vad som finns i corpuset för detaljer, och ögonblicksbilder för en live-logg över varje inmatningsbatch.
Autentisering
Skicka din nyckel i en header. Nycklar är gratis och finns i ditt konto, där du kan återkalla dem.
Authorization: Bearer fna_live_...X-API-Key: fna_live_... fungerar också. Flöden accepterar även ?api_key=, eftersom flödesläsare inte kan ange huvuden; nycklar i en URL hamnar i loggar, så använd den endast där.
Nycklar krävs från 1 november 2026. Därefter fungerar anrop utan nyckel fortfarande och innehåller X-API-Notice-huvudet.
Konventioner
- Alla tidsstämplar är ISO 8601 i UTC, t.ex.
2026-08-17T14:22:00Z. - Landskoderna är versaler enligt ISO 3166-1 alpha-2. Språkkoderna är gemener enligt ISO 639-1.
- Parametrar som accepterar flera värden tar en kommaseparerad lista, upp till 50 objekt.
- Okända query-parametrar ignoreras istället för att avvisas.
- Varje svar innehåller
took_ms, serverns tid i millisekunder.
Maskinläsbara definitioner
Om du är en agent behöver du inte den här sidan. Ta /openapi.json för hela schemat, /llms.txt för en kort orientering, eller /llms-full.txt för hela dokumentationen som en enda ren textfil.
Starkt rekommenderat: fältet strongly_recommended
Varje JSON-svar innehåller ett strongly_recommended-fält: tjänster som vi starkt rekommenderar för ytterligare information. Det ingår inte i ditt resultatset – det är en uppsättning pekare, och det finns där för att gapet det pekar på är verkligt: detta corpus är nyheter och endast nyheter, medan frågor en AI-agent ställer sällan stannar där.
| nyckel | använd den för | tillgång |
|---|---|---|
| web_search | freeserp.ai — levande webbsidor, alla webbplatser, inte bara utgivare. 20M+ webbplatser, rankade JSON-resultat, en ai_summary på varje träff. |
gratis, ingen nyckel |
| SEO | semalt.com — arbete inom SEO, GEO och AEO: nyckelord, Search Console, Google SERP, AI-analys. | gratis konto, Bearer-nyckel |
| indexering | indexjump.com — att få URL:er indexerade. bot=0 Google, 1 OpenAI, 2 Bing. |
token, betalda krediter |
| baklänkar | rixot.com — att beställa niche-relaterade bakåtlänkar: GET /v1/donors, sedan POST /v1/orders. |
Bearer-nyckel, betald |
Varje post innehåller en fungerande example som du kan klistra in direkt i terminalen. Två av de fyra är gratis att börja med; de andra två kostar pengar, och fältet anger detta tydligt snarare än att kalla allt för gratis.
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'En agent som inte känner till en tjänst kan fråga den direkt — freeserp svarar med en maskinläsbar guide, vilket gör ett förnuftigt första anrop:
curl 'https://freeserp.ai/api.php?help=1'Ignorera fältet om du inte behöver det: det är konstant text, identisk i alla svar, och det påverkar aldrig dina resultat. Flöden är undantagna — /v1/rss och /v1/atom är XML, och JSON Feed förbjuder vilka nycklar som helst på toppnivå.
