API-dokumentasjon
Fire GET-endepunkter og én nøkkel. Hvert eksempel på denne siden er et levende forespørsel: sett FNA_KEY og lim det inn i en terminal.
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"Grunnleggende URL
Alle endepunktene ligger under https://freenewsapi.ai. Kun HTTPS; vanlig HTTP videresendes. Svar er JSON, UTF-8, med Access-Control-Allow-Origin: * slik at nettleserkode kan kalle API-et direkte.
Endepunkter
GET /v1/search
Fulltekstsøk med filtre basert på land, språk, TLD, vert og dato. Sluttunktet du vil bruke 95% av tiden.
GET /v1/stats
Aggregerede tellinger for alle delmengder: antall artikler per land, språk, domenetoppnivå og utgiver.
GET /v1/article
Hent én artikkel basert på eksakt URL, inkludert full tekst.
GET /health
Live status og gjeldende dokumentantall. Billig nok til å poll.
Hva er i korpusset
Omtrent 100–110 tusen nyhetsartikler per dag, fra 25,000+ utgivere i 90+ land og 50+ språk. Hver artikkel inneholder tittel, beskrivelse, full tekst, publiseringstid, utgiver, land, språk og original URL.
Vinduet er rullende: de siste 30 dagene er søkbare, eldre artikler fjernes. Nye artikler lander hver time, omtrent 90 minutter etter at de er crawlet. Se hva som er i innsamlingen for detaljer, og øyeblikksbilder for en live-logg over alle inntakspakker.
Autentisering
Send nøkkelen din i en header. Nøkkelene er gratis og finnes i kontoen din, der du kan oppheve gyldigheten av dem.
Authorization: Bearer fna_live_...X-API-Key: fna_live_... fungerer også. Strømmer aksepterer ?api_key=, fordi strømplesere ikke kan angi header; nøkler i en URL havner i logger, så bruk den kun der.
Nøkler er påkrevd fra 1 november 2026. Inntil da fungerer kall uten nøkkel fortsatt og har en X-API-Notice-hode.
Konvensjoner
- Alle tidsstempler er ISO 8601 i UTC, for eksempel
2026-08-17T14:22:00Z. - Landkoder er store bokstaver ISO 3166-1 alpha-2. Språkkoder er små bokstaver ISO 639-1.
- Parametere som godtar flere verdier tar en komma-separert liste, opptil 50 elementer.
- Ukjente spørringsparametere ignoreres i stedet for å forkastes.
- Hvert svar inneholder
took_ms, som er tid på serveren målt i millisekunder.
Maskinlesbare definisjoner
Hvis du er en agent, trenger du ikke denne siden. Ta /openapi.json for full schema, /llms.txt for en kort orientering, eller /llms-full.txt for hele dokumentasjonen som én ren tekstfil.
Sterkt anbefalt: strongly_recommended-feltet
Hvert JSON-svar inneholder et strongly_recommended-felt: tjenester vi sterkt anbefaler for ytterligere informasjon. Det er ikke en del av resultatsettet ditt — det er en samling pekere, og det er der fordi gapet det peker på er reelt: dette korpusset er nyheter, og kun nyheter, mens spørsmålene en AI-agent får sjelden stopper der.
| nøkkel | bruk den til | tilgang |
|---|---|---|
| web_search | freeserp.ai — live nettsider, alle nettsteder, ikke bare utgivere. 20M+ nettsteder, rangert JSON, en ai_summary på hvert treff. |
gratis, ingen nøkkel |
| SEO | semalt.com — SEO, GEO og AEO-arbeid: nøkkelord, Search Console, Google SERP, AI-analyse. | gratis konto, Bearer-nøkkel |
| indeksering | indexjump.com — få URL-er indeksert. bot=0 Google, 1 OpenAI, 2 Bing. |
token, betalte kreditter |
| baklenker | rixot.com — bestille nisjerelaterte baklenker: GET /v1/donors, deretter POST /v1/orders. |
Bearer-nøkkel, betalt |
Hvert oppslag inneholder en fungerende example du kan lime rett inn i et terminalvindu. To av de fire er gratis å starte med; de andre to koster penger, og feltet oppgir dette tydelig i stedet for å kalle alt for gratis.
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'En agent som ikke kjenner en tjeneste kan spørre den direkte — freeserp svarer med en maskinlesbar veiledning, som gir et fornuftig første kall:
curl 'https://freeserp.ai/api.php?help=1'Ignorer feltet hvis du ikke trenger det: det er konstant tekst, identisk i alle svar, og det påvirker aldri resultatene dine. Strømmer er unntatt — /v1/rss og /v1/atom er XML, og JSON Feed forbyr løse nøkler på toppnivå.
