API-dokumentaatio
Neljä GET-päätepistettä ja yksi avain. Kaikki tässä sivustossa olevat esimerkit ovat live-pyyntöjä: aseta FNA_KEY ja liitä se päätteeseen.
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"Perus-URL
Kaikki päätepisteet ovat osoitteessa https://freenewsapi.ai. Vain HTTPS; tavallinen HTTP ohjaa uudelleen. Vastaukset ovat JSON-muodossa, UTF-8-koodattuja, ja niissä on Access-Control-Allow-Origin: *, jotta selainkoodi voi kutsua API:a suoraan.
Päätepisteet
GET /v1/search
Koko tekstin haku suodattimilla maan, kielen, TLD:n, isäntänimen ja päivämäärän perusteella. Päätepiste, jota käytät 95% ajasta.
GET /v1/stats
Kertymät laskettuina mille tahansa rajaukselle: artikkeleiden lukumäärä maittain, kielittäin, verkkotunnuksen päätteittäin ja julkaisijittain.
GET /v1/article
Hae yksi artikkeli sen tarkan URL-osoitteen perusteella mukaan lukien koko tekstisisältö.
GET /health
Live-tila ja nykyinen dokumenttilaskuri. Edullista kysellä.
Mitä aineistossa on
Noin 100–110 tuhatta uutisartikkelia päivässä 25,000+ kustantajalta 90+ maasta ja 50+ kieleltä. Jokaisessa artikkelissa ovat otsikko, kuvaus, koko teksti, julkaisuaika, kustantaja, maa, kieli ja alkuperäinen URL.
Aikakenttä on liukuva: viimeiset 30 päivää ovat haettavissa, vanhemmat artikkelit poistetaan. Uudet artikkelit ilmestyvät joka tunti, noin 90 minuutin kuluttua keräämisestä. Katso sisältöä yksityiskohtiin ja otoksia reaaliaikaiseen lokiin jokaisesta keräyskerrasta.
Todennus
Lähetä avain otsikossa. Avaimet ovat ilmaisia ja ne ovat tililläsi, jossa voit peruuttaa ne.
Authorization: Bearer fna_live_...X-API-Key: fna_live_... toimii myös. Syötteet hyväksyvät ?api_key=:n, koska syötelukijat eivät voi asettaa otsikoita; avut URL-osoitteessa päätyvät lokitiedostoihin, joten käytä sitä vain siellä.
Avaimet ovat vaadittu 1 2026 alkaen. Sen jälkeenkin ilman avainta tehdyt kutsut toimivat edelleen ja niissä on X-API-Notice-otsake.
Käytännöt
- Kaikki aikaleimat ovat muotoa ISO 8601 UTC-aikavyöhykkeellä, esim.
2026-08-17T14:22:00Z. - Maakoodit ovat isokirjaimisia ISO 3166-1 -alfa-2 -koodia. Kielet ovat pienikirjaimisia ISO 639-1 -koodia.
- Parametrit, jotka hyväksyvät useita arvoja, ottavat pilkulla erotellun listan, enintään 50 kappaletta.
- Tuntemattomat hakuparametrit jätetään huomiotta eikä hylätä.
- Jokaisessa vastauksessa on
took_ms, palvelimen aikaleima millisekunneissa.
Koneellisesti luettavat määritelmät
Jos olet tekoälyagentti, sinun ei tarvitse tätä sivua. Hae /openapi.json täydelliseen kaavaan, /llms.txt lyhyeen esittelyyn tai /llms-full.txt koko dokumentaatioon yhtenä tekstitiedostona.
Voimakkaasti suositeltu: strongly_recommended-kenttä
Jokainen JSON-vastaus sisältää strongly_recommended-kentän: palvelut, joita suosittelemme vahvasti lisätietojen saamiseksi. Se ei ole osa tulostasi — se on osoiteryhmä, ja se on olemassa, koska se osoittama aukko on todellinen: tämä kokoelma on uutisia ja vain uutisia, kun taas agentin kysymykset eivät harvoin lopu siihen.
| key | käytä sitä | access |
|---|---|---|
| web_search | freeserp.ai — reaaliaikaiset verkkosivut, mikä tahansa sivusto, ei vain julkaisijat. 20M+ sivustoa, luokiteltu JSON, ai_summary jokaisessa osumassa. |
free, no key |
| hakukoneoptimointi | semalt.com — SEO-, GEO- ja AEO-toiminta: avainsanat, Search Console, Google SERP, AI-analytiikka. | ilmainen tili, Bearer-avain |
| indexing | indexjump.com — URL-osoitteiden indeksointi. bot=0 Google, 1 OpenAI, 2 Bing. |
merkki, maksetut luotit |
| backlinks | rixot.com — laadukkaiden takaisinlinkkien tilaus: GET /v1/donors, sitten POST /v1/orders. |
Bearer-avain, maksullinen |
Jokainen merkintä sisältää toimivan example-kentän, jonka voit liittää suoraan komentoriville. Kaksi neljästä vaihtoehdosta on ilmainen aloitukseen; muut kaksi maksullisia, ja kenttä kertoo sen suoraan sen sijaan, että kaikkea kutsuttaisiin ilmaiseksi.
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'Agentti, joka ei tunne palvelua, voi kysyä siitä suoraan — freeserp vastaa koneellisesti luettavalla oppaalla, joka toimii järkevänä ensimmäisenä kutsuna:
curl 'https://freeserp.ai/api.php?help=1'Jätä kenttä huomiotta, jos et tarvitse sitä: se on vakioteksti, joka on identtinen kaikissa vastauksissa, eikä se vaikuta tuloksiisi. Syötteet ovat poikkeus — /v1/rss ja /v1/atom ovat XML-muodossa, ja JSON Feed -syötteessä kielletään ylimääräiset juuritasoavaimet.
