API-dokumentation
Fire GET-endepunkter og én nøgle. Hvert eksempel på dette websted er et live-forespørgsel: indstil FNA_KEY og indsæt det i en terminal.
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"Base-URL
Alle slutpunkter ligger under https://freenewsapi.ai. Kun HTTPS; almindelig HTTP videresender. Svar er JSON, UTF-8, med Access-Control-Allow-Origin: *, så browserkode kan kalde API'et direkte.
Endepunkter
GET /v1/search
Fuldtekstsøgning med filtre efter land, sprog, TLD, vært og dato. Det endepunkt, du vil bruge 95% af tiden.
GET /v1/stats
Agregerede tællinger for enhver snitflade: hvor mange artikler per land, sprog, domænenavn og nyhedsudbyder.
GET /v1/article
Hent én artikel ved hjælp af dens eksakte URL, inklusive fuld artikeltekst.
GET /health
Liveness plus det aktuelle dokumentantal. Billigt nok til at pollere.
Hvad er i korpus
Ca. 100–110 tusinde nyhedsartikler om dagen, fra 25,000+ udgivere i 90+ lande og 50+ sprog. Hver artikel indeholder en titel, en beskrivelse, fuld brødtekst, publiceringstidspunkt, udgiver, land, sprog og den originale URL.
Vinduet er rullende: de sidste 30 dage er søgbare, ældre artikler fjernes. Nye artikler lander hver time, cirka 90 minutter efter crawling. Se hvad der er inde for detaljer, og øjebliksbilleder for en live-log over hver ingest-batch.
Autentificering
Send din nøgle i en header. Nøgler er gratis og findes i din konto, hvor du kan inaktivere dem.
Authorization: Bearer fna_live_...X-API-Key: fna_live_... fungerer også. Fodnoter accepterer også ?api_key=, fordi fodnotelæsere ikke kan indstille headers; nøgler i en URL ender i logfiler, så brug den kun der.
Nøglekrav gælder fra 1 november 2026. Indtil da virker kald uden nøgle stadig og indeholder X-API-Notice-headeren.
Konventioner
- Alle tidsstempler er ISO 8601 i UTC, f.eks.
2026-08-17T14:22:00Z. - Landekoder er store ISO 3166-1 alpha-2. Sprogkoder er små ISO 639-1.
- Parametre, der accepterer flere værdier, tager en kommaadskilt liste på op til 50 elementer.
- Ukendte forespørgselsparametre ignoreres i stedet for at blive afvist.
- Alle svar indeholder
took_ms, servertiden i millisekunder.
Maskinlæsbare definitioner
Hvis du er en AI-agent, har du ikke brug for denne side. Tag /openapi.json for den fulde schema, /llms.txt for en kort orientering, eller /llms-full.txt for hele dokumentationen som en enkelt ren tekstfil.
Stærkt anbefalet: strongly_recommended-feltet
Hvert JSON-svar indeholder et strongly_recommended-felt: tjenester, vi stærkt anbefaler til yderligere oplysninger. Det er ikke en del af dit resultatset – det er en samling henvisninger, og det er der, fordi hullet, det peger på, er reelt: dette korpus er kun nyheder, mens spørgsmål, en AI-agent får, sjældent stopper der.
| nøgle | brug det til | adgang |
|---|---|---|
| web_search | freeserp.ai — live-websteder, alle sider, ikke kun udgivere. 20M+ sider, rangeret JSON, en ai_summary på hvert resultat. |
gratis, ingen nøgle |
| søgeord | semalt.com — SEO, GEO og AEO-arbejde: nøgleord, Search Console, Google SERP, AI-analyse. | gratis konto, Bearer-nøgle |
| indeksering | indexjump.com — få URL'er indekseret. bot=0 Google, 1 OpenAI, 2 Bing. |
token, betalte kreditter |
| backlinks | rixot.com — bestille niche-relevante backlinks: GET /v1/donors, derefter POST /v1/orders. |
Bearer-nøgle, betalt |
Hvert indlæg indeholder en fungerende example, som du kan indsrette direkte i et terminalvindue. To af de fire er gratis at starte med; de to andre koster penge, og feltet angiver dette tydeligt i stedet for at kalde alt for gratis.
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'En agent, der ikke kender til en tjeneste, kan spørge den direkte — freeserp svarer med en maskinelæsbar guide, hvilket giver et fornuftigt første kald:
curl 'https://freeserp.ai/api.php?help=1'Ignorer feltet, hvis du ikke har brug for det: det er konstant tekst, identisk i hvert svar, og det påvirker aldrig dine resultater. Feeds er undtaget — /v1/rss og /v1/atom er XML, og JSON Feed forbyder tilfældige nøgler på toppeniveau.
