UutisAPImyyntejä myydään yleensä pyyntökohtaisesti, avaimen taakse piilotettuina, ja ilmaisessa tasossa rajoitetaan sataan pyyntöön päivässä. Free News API ei ole mikään näistä: 21,5 miljoonaa artikkelia 90 päivän liukuvalla ajanjaksolla, yli 25 000 julkaisijaa, ei avainta, ei rekisteröitymistä, ei kiintiöitä, kaupallinen käyttö sallittua. Tässä koko käyttöliittymä — haku, tilastot, trendit, markkinat, syötteet ja MCP — sekä rehellinen kuvaus siitä, missä tiedossa tehtiin virheitä.

Ongelman muoto

Kysy tekoälyagentilta, mitä maailmassa kirjoitetaan juuri nyt, ja sillä on kolme huonoa vaihtoehtoa. Se voi raapia julkaisijoita suoraan, mikä on haurasta, hidasta ja oikeudellisesti ep selkeää. Se voi kutsua kaupallista uutisAPI:ia, mikä tarkoittaa tiliä, avainta, kuukausilaskua ja — markkinoiden kaikissa ilmaisissa tasoissa — sataa pyyntöä päivässä ja artikkelien viivästymistä neljäntoista tunnin päällä. Tai se voi arvailla koulutustiedoista, jotka ovat päättyneet kuukausia sitten.

Free News API poistaa keski vaihtoehdon hinnan ja paperityön sen kyvystä luopumatta. Yksi GET-pyyntö, ei tunnuksia, yli 25 000 julkaisijan yli 21 557 044 artikkelista, jotka on pidetty 90 päivän liukuvalla ajanjaksolla ja päivitetty jatkuvasti — uusimmat artikkelit ovat yleensä alle kaksi minuuttia vanhoja.

21,5 miljoonaa
artikkelia indeksöity
25,000+
julkaisijat
100
maat
~100
kieliä
90 päivää
liukuva ikkuna
0
API avainta olemassa
Sääntö: API-avainta ei ole olemassa eikä tule olemaan. Sille ei ole parametriä, sitä ei lähetetä otsikkona, tiliä ei tarvitse luoda eikä pyyntörajaa ole — ainoastaan IP-kohtainen nopeusrajoitus, joka on 20 pyyntöä sekunnissa, jotta yksi käyttäjä ei voi kaataa palvelua muilta.

Neljää ydinpäätepistettä ja enemmänkin

Palvelun ydin on neljässä GET-päätepisteessä, jotka kaikki sijaitsevat osoitteessa https://freenewsapi.ai, palauttavat UTF-8-muotoisen JSON-datan, sisältävät otsikon Access-Control-Allow-Origin: * (jotta selaimen koodi voi kutsua niitä suoraan) ja raportoivat palvelimen aikaa took_ms-kentässä.

PäätepisteMihin se vastaa
GET /v1/searchTäydellinen tekstihaku suodattimilla. Päätepiste, jota käytät 95 %:ssa tapauksista.
GET /v1/statsYhdistetyt lukumäärät mille tahansa osajoukolle — maan, kielen, TLD:n, julkaisijan ja päivän mukaan.
GET /v1/articleYksi artikkeli sen tarkan URL mukaisesti, mukaan lukien koko runko.
GET /healthLivelisäyksen ja nykyisen asiakirjamäärän tarkistus. Edullista riittävän tiheällä kyselytaajuudella.

Noin tämän ytimen ympärillä on neljä muuta perhettä, joista jokainen voisi olla oma tuote muualla: trendit (live-uutisten ryhmittely maittain), markkinat (hintasarjat suhteessa uutisoinnin määrään), kryptovirkeystila (seitsemän päätepisteen Bitcoin-lohko) ja jakelu (sama hakutulossarja RSS, Atom tai JSON Feed -muodossa). Kaikista niistä kerrotaan alla.

curl "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"
    }
  ]
}

Vastauksessa olevista kolmesta kentästä tulee kiinnittää heti huomiota, koska ne koodaavat koko tietojoukon rehellisyyden. total_is_lower_bound kertoo, kun osumamäärä ylsi 10 000 rajan ja laskenta lakkasi. country_source kertoo, miten maa on määritetty — koska suurin osa maiden arvoista uutistietojoukoissa on johtopäätöksiä, ei faktoja. Ja crawled_at on luotettava aikaleima: julkaisijat päivittävät published_at-kenttää usein taaksepäin, mutta keruuaika on putken määrittämä ja etenee aina vain eteenpäin.

Haku: Jokainen merkittävä parametri

Kaikki parametrit ovat valinnaisia. Pelkkä pyyntö palauttaa uusimmat artikkelit indeksistä.

Kysely

Kysy kuten hakukone, ei kuten chatbot: Tämä on yleisin virhe. Haku on AND-merkkijono kaikille termeille, joten kirjoita 2–5 avainsanaa, ei lause. opec production cut toimii. what did OPEC decide about oil ei palauta tuloksia.

Suodattimet

Suodattimet yhdistyvät AND-merkkijonona parametrien välillä ja OR-merkkijonona yhden sisällä. Joten country=DE,AT&lang=de luetaan "saksankieliset artikkelit Saksasta tai Itävallosta". Kumpikin hyväksyy pilkulla erotetun listan enintään viidestä arvosta.

SuodatinMuotoHuomautukset
countryISO 3166-1 alpha-2, isoina kirjaiminaJulkaisijan maa. Johtopäätös, ei ilmoitettu — katso country_source ja strict_country.
langISO 639-1, pieninään kirjaiminaTunnistettu dokumentista itsestään. 99,9 % kattavuus.
tldei pistettäJulkaisijan verkkotunnuksen päätteeni. tld=ua on totuus; country=UA on johtopäätös.
hosttarkat isäntänimetSellaisina kuin ne esiintyvät URL — sisällytä www., jos julkaisija käyttää sitä.
datetänään · eilen · 24 h · 48 h · 7 pv · 30 pvEsiasetusten aikaväli, joka arvioidaan published_at-arvon perusteella.
from / toISO-päivämäärätSelkeä ikkuna, jolloin esiasetukset eivät sovi.
strict_countrytrue/falseLaske vain artikkelit, joiden maa on varma tosiasia eikä vain olettamus.

Lähtötiedoston hallinta

ParametriArvotVaikutus
sortdate · date_asc · crawled · crawled_asc · relevanceLajittele crawled-kriteerin mukaan hakiessa uusia artikkeleita — julkaisijat asettavat julkaisupäiviksi taaksepäin siirtyviä päivämääriä; selausaika etenee vain eteenpäin.
size1–100Tuloksia per sivu.
offset0–9900Sivutuksen offset-arvo.
full_texttrue/falseSisällytä artikkelin runko. Oletuksena pois päältä.
highlighttrue/falsePalauta osuvat tekstin osat.
fieldsCSVRajaa vastaus niihin kenttiin, joita todella käytät.
curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=date&size=10"
curl "https://freenewsapi.ai/v1/search?q=merger&country=DE&date=48h&sort=date&size=20"

Laskeminen ennen hakua

Palvelun aliarvioituin päätepiste on /v1/stats. Usein hyödyllisin kysymys ei ole ”mitkä artikkelit ovat kyseessä”, vaan ”onko täällä mitään ollenkaan, ja missä ne sijaitsevat”. Tulosten laskeminen maksaa murto-osan kustannuksista — noin sata kymmentä tokenia verrattuna useisiin tuhansiin sivullisille tuloksille — mikä tekee siitä oikean ensimmäisen kutsun agentille, joka päättää, onko haku kannattavaa suorittaa.

curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"

Se palauttaa laskurit maan, kielen, TLD:n, julkaisijan ja päivän mukaan laskettuna koko vastaavasta joukosta nykyisen sivun sijaan. Tämä on myös tapa mitätä kattavuutta ennen kuin luotat siihen. Suodattamaton otos kirjoitushetkellä:

Parhaat maat

MaaArtikkelit
Intia2,286,014
Yhdysvallat2,180,797
Turkki1,499,897
Venäjä1,436,556
Italia1,057,479
Argentiina826,947
Espanja812,347
Ukraina662,041
Brasilia551,013
Saksa543,132
Ranska502,846
Kreikka460,372
Japani437,209
Vietnam408,934
Meksiko402,320
Etelä-Korea362,945
Romania354,229
Yhdistynyt kuningaskunta334,379
Iran291,782
Puola255,599

Yleisimmät kielet

Englanti 5 513 650 · espanja 2 699 457 · venäjä 1 785 796 · turkki 1 501 004 · italia 992 200 · saksa 733 677 · ranska 689 136 · arabia 664 016 · portugali 637 607 · hindi 560 840 · kreikka 466 504 · japani 427 085 · vietnam 385 719 · romanian kieli 358 766 · kiina 352 720 · ukraina 345 809 · korea 335 079 · persia 268 126 · puola 238 904 · bulgaria 183 204.

Tämä jakauma on arvoa katsomalla hetki, koska se on päinvastainen kuin se, mitä useimmat uutisAPIt tarjoavat. Tyypillistä englantilais- ja yhdysvaltalaisvaltainen korpus ei ole tämä: Intia ohittaa Yhdysvallat, turkki ohittaa saksan, ja kreikan, vietnamin, persian ja bulgarian kielten artikkelimäärät ovat kuusinumeroisia. Jos kysymyksesi liittyy ei-englanninkieliseen lehdistöön, tämä on materiaalisesti erilainen datamäärä.

Määrä

Päivittäinen käyrä by_day-kentässä kattaa täydet yhdeksänkymmentä päivää. Viime päivät ovat noin 400 000–700 000 artikkelin päivämäärässä; aikaisemmin ikkunassa, ennen kuin RSS-kerros lisättiin arkiston syötön yhteyteen, päivittäinen määrä oli 130 000–230 000. Molemmat luvut näkyvät samassa vastauksessa, mikä on pointti — palvelu näyttää oman kasvunsa eikä lainaa markkinointikeskiarvoa.

Suuntaukset: Mitä lehdistö todella käsittelee juuri nyt

Haku vastaa kysymykseen "mitä X:stä on kirjoitettu". Suuntaukset vastaavat eri ja usein parempaan kysymykseen: "mitä tapahtuu" — ilman X:n tarvitsemista.

Robotti ryhmittelee artikkelit tarinoiksi maittain ja pitää ne ajan tasalla. Viiden minuutin välein uudet artikkelit liitetään tunnettuihin tarinoihin tunnus sanoilla, ilman mallikutsua; jokaisen muutaman tunnin välin maassa käydään läpi kokonainen kierros, jossa kielimalli lukee otsikot ja nimeää tarinat alusta alkaen. Kirjoitushetkellä trendikerros kattaa 115 maata, jotka on laskettu uudelleen viimeisten minuuttien aikana.

curl "https://freenewsapi.ai/v1/trends?country=US&window=24h&size=5"
{
  "window": "24h",
  "filters": { "country": ["US"], "min_publishers": 1 },
  "trends": [
    {
      "title": "Hurricane Marie threatens Labor Day weather",
      "slug": "hurricane-marie-threatens-labor-day-weather",
      "country": "US",
      "category": "weather",
      "articles": 57,
      "publishers": 24,
      "first_seen": "2026-09-05T19:24:36Z",
      "latest": "2026-09-06T19:00:04Z",
      "url": "https://freenewsapi.ai/trends/us/hurricane-marie-…",
      "headlines": [ … ]
    }
  ]
}

Jokaiseen tarinaan liittyy kaksi lukua, ja ne tarkoittavat eri asioita. articles on äänekkyys; publishers on laajuus. Tarina, jossa on 200 artikkelia neljästä toimistosta, on yhden toimiston harrastus. Tarina, jossa on 60 artikkelia neljästätoista toimistosta, on tapahtuma. Oletusjärjestys on julkaisijoiden mukaan, ja min_publishers / min_articles antavat sinun asettaa rajan itse.

Tarinoissa on luokiteltu kategoria kiinteästä joukosta: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.

Ikkuna on lukijan valinta, ei robottin

Tämä on aidosti hienostunut suunnittelupäätös. Jokainen artikkeli tallennetaan julkaisuaikansa kera ja liitetään tarinaan, joten mikä tahansa ikkuna — viisitoista minuuttia, tunti, vuorokausi tai tietty kalenteripäivä — on vain aluekysely samojen tallennettujen tietojen päällä. Yksi laskenta palvelee kaikkia ikkunoita yhtä aikaa. window=15m, window=1h, window=24h, date=2026-09-01 tai eksplisiittinen since/until-pari toimivat saman indeksin päällä ilman uudelleenlaskentaa.

Avainsanat: uutisten rakentamiset sanavarat

curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"

Jokainen avainsana palautetaan sen kanssa, kuinka monta erillistä tarinaa sitä käyttää, kuinka monta artikkelia näissä tarinoissa on ja — mielenkiintoisin tieto — kuinka monta kansallista lehteä sitä käyttää. Viimeinen luku erottaa globaalin tapahtuman kotimaisesta. Sana, joka esiintyy seitsemässäkymmenessä maassa, on maailmanuutinen; sana, joka dominoi yhden maan lehdistöä, on kotimainen uutinen, vaikka se olisi siellä kuinka äänekkääkin.

Mitkä maat ovat live-tilassa

curl "https://freenewsapi.ai/v1/trends/countries"

Palauttaa kaikki seurattavat maat niiden live-tarinoiden määrän ja sen perusteella, kuinka monta minuuttia sitten ne on laskettu uudelleen — Turkki, Venäjä, Iran, Kreikka, Intia, Italia, Ukraina, Romania, Argentiina, Saksa ja Brasilia sisältävät kaikki tällä hetkellä tuhansia live-tarinoita, jotka on laskettu uudelleen viimeisen kymmenen minuutin aikana. Ja /v1/trends/{cc}/{slug} avaa minkä tahansa yksittäisen tarinan sen täydellä artikkelilistalla.

Markkinat vs. Kattavuus: Hinta yhdellä akselilla, huomio toisella

Tämä on palvelun oudoin piirre, ja se on olemassa, koska korpus tekee sen rakentamisesta lähes ilmaista. Aseta hintasarja viereen sen kanssa, kuinka paljon maailma kirjoitti kyseisestä asiasta samoina tunteina, yhdellä aikajanalla.

curl "https://freenewsapi.ai/v1/markets"

Neljätoista instrumenttia on seurattavissa, neljän varaluokan yli:

LuokkaInstrumentitJyväLähde
KryptoBitcoin, Ethereum, Solana, XRP, BNB, DogecointuntiBinance
MetallitKulta (USD/oz)tuntiBinance
ValuutatEUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLNpäiväEKP
EnergiaSaksan sähkön hinta (EUR/MWh)tuntiEnergy-Charts
curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"

Tuo yksi kutsu antaa sinulle kurssin turkin liraan dollia vastaan sekä turkkilaisen lehdistön käsittelytilavuuden samalta ajanjaksolta tuntitason tarkkuudella. Turkkilainen lehdistö on tämän korpuksen kolmanneksi suurin osatekijä, minkä vuoksi tämä yhdistelmä tuottaa merkityksellistä dataa melun sijaan.

Ja kokonainen bitcoin-tunnepalohjelma

Bitcoinille on luotu oma seitsemänpääinen perhe, koska se on ainoa instrumentti, jossa uutisten sävy ja hinnan liike vaihdetaan jatkuvasti ja harvoin mitataan:

PäätepistePalautukset
/v1/btc/summaryTuorein hinta, viimeaikaiset liikkeet ja tämän päivän uutisoinnin sävy.
/v1/btc/priceBTC/USDT-kynttilät välein.
/v1/btc/sentimentUutisten sävy kausittain.
/v1/btc/seriesHinta ja sävy samassa aikajanassa.
/v1/btc/correlationKorrelaatio sävyn ja hinnan liikkeen välillä ajan siirroksen mukaan — johtaako uutisointi hintaa vai seuraaako sitä?
/v1/btc/newsKryptoartikkeleita niiden tunnesävymerkinnän kera, suodatettavissa merkinnän, isäntäpalvelimen, kielen ja hakutermin perusteella.
/v1/btc/sourcesMitkä julkaisut raportoivat kryptovaluutoista, ja miten kukin niistä suhtautuu aiheeseen.

Tunnetilamerkinnät perustuvat kielimalliin, joka analysoi tuoreita kryptoartikkeleita viiden minuutin välein vakioidun valuuttalistan perusteella. Jos haluat testata väitettä "uutiset aiheuttavat hinnanliikkeen" sen sijaan, että toisit sen toteen, käytä endpointtia /v1/btc/correlation parametrilla max_shift.

Sama haku syötteenä

Kolme muuta päätepistettä ottavat käyttöön samat hakuparametrit ja palauttavat tulokset syndikointimuodoissa JSON sijaan:

https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=date

Tämä tarkoittaa, että mikä tahansa tallennettu haku muuttuu syötteeksi, jonka voit liittää lukijaohjelmaan, n8n-solmuun, Slack-integraatioon, Zapier-käynnistimeen tai staattisen sivuston generointityökaluun — ilman koodia ja ilman avainta. Tämä on pieni ominaisuus, joka hiljaisesti poistaa kokonaan integraatiokerroksen ei-ohjelmoijilta.

MCP: Kaksikymmentäkahdeksan työkalua, kaksi kerrosta

MCP-palvelin toimii yhdessä URL:ssä, käyttää Streamable HTTP -protokollaa (JSON-RPC 2.0 POST-metodilla, protokollan versio 2025-06-18), tukee eräajotapoja ja — kuten kaikki muukin tässä — ei vaadi valtuutusvaihetta eikä istunnon tunnistetta.

claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcp

Se tarjoaa 28 työkalua kahdessa tarkoituksellisessa kerroksessa.

Kerrosvaihe yksi: kuusi oikotietta, jotka vastaavat kokonaan kysymykseen yhdellä kutsulla

TyökaluVarteen
search_news"Mitä X:stä on kirjoitettu" — kokotekstihaku, tiivistetyt tulokset.
get_trends"Mitä tapahtuu" — ryhmiteltyjä juttuja artikkelilistan sijaan.
trend_keywordsSanat, joihin uutisointi perustuu juuri nyt, sisältäen juttilaskelmia ja maiden jakautumaa.
find_publishersHae tiedotustaloja: nimi, verkkotunnus, maa, kieli, artikkeleita päivässä.
list_countriesMitkä maat tarjoavat reaaliaikaisia juttuja, kuinka monta ja kuinka tuoreita.
market_vs_newsHintasarja peittovolumeen rinnalla. Kutsu ilman instrumenttia nähdäksesi, mitä on tarjolla.

Kerros kaksi: jokainen päätepiste, luotu palvelun itsensä kautta

Pikavalintojen alla jokainen raaka päätepiste on altistettu omana työkalunaan, jossa on kaikki API:n hyväksymät parametrit — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, koko news_get_btc_* -perhe, syötteen renderoijat ja news_get_health. Nämä on luotu live-palvelusta, joten ne eivät poikkea siitä, mitä API todellisuudessa hyväksyy.

Kaksi metatyökalua sulkevat kehän: news_list_endpoints palauttaa luettelon kaikesta, mitä on olemassa, ja news_get suorittaa raakan GET:n mihin tahansa polkuun — joten agentti, joka kohtaa päätepisteen, jota sen työkaluluettelo ei kata, voi silti saavuttaa sen.

curl "https://freenewsapi.ai/mcp?format=json"

Yksi GET, ei käsinkoukkuja, ja sinulla on koko koneellisesti luettava luettelo: palvelin, yhteysprotokolla, työkaluprotokolla, työkalujen lukumäärä, jokainen työkalu sen kuvauksen kanssa ja jokainen päätepiste sen paramettiluettelon kanssa.

Rakennettu koneiden luettavaksi

Dokumentointi ei ole API:n varaan liitetty lisäys — se on sen ensisijainen tuotos. Sivusto sisältää 666 staattista sivua, ja useilla niistä on nimenomaan se tarkoitus, että mallin ei tarvitse lukea HTML-koodia:

Lisäksi 168 maakohtaisella sivulla, 121 kielisivulla ja 275 TLD-sivulla — yksi selattava pinta jokaiselle aineiston osalle, joka näyttää sen sisällön.

Mistä artikkelit tulevat

Kaksi syöttöpolkua syöttävät samaan indeksiin, ja niiden ero on merkittävä.

Arkistopolku

Joka kymmenen minuutti tehtävä tarkistaa Common Crawlin CC-NEWS-arkistosta uusia WARC-tiedostoja ja käsittelee kaikki aiemmin tuntemattomat tiedostot käyttäen neljäkymmentä rinnakkaista työntekijää. Poimija irrottaa jokaisen artikkelin raakasta kaappauksesta dokumentoidun kenttäkohtaisen priorisointiketjun avulla — ja priorisointiketjut on mitattu todellisen datan perusteella, ei oletuksilla:

KenttäPriorisointiketjuKattavuus
kuvausJSON-LD → meta → OpenGraph → Twitter-kortti → articleBody → johdantokappale98.1%
kieli<html lang> → JSON-LD inLanguage → og:locale99.9%
maaccTLD → JSON-LD addressCountry → kieli-maakoodi → og:locale79.1%
päivämääräJSON-LD datePublished → meta → trafilatura → kaappausaika100%

Tuo maakohtainen luku on rehellinen, ja siksi country_source on näkyvillä jokaisessa artikkelissa: noin viidesosa merkinnöistä ei sisällä luotettavaa maakohtaista signaalia, ja noin kolmasosa olemassa olevista arvoista on johtopäätöksiä eikä tosiasioita. API kertoo, mikä on mikä, sen sijaan että se esittäisi tietävänsä paremmin.

Live-reitti

Toinen robotti kysyy julkaisijan RSS-syötteistä viiden minuutin välein ehdollisissa pyynnöissä — syöte, joka palauttaa koodin 304 Not Modified, maksaa lähes mitään, ja kunkin syötteen kyselyväli on säätetty sen julkaisutiheyden mukaan. Lehteä, joka julkaisee viisi juttua päivässä, ei kuormiteta jatkuvasti viiden minuutin välein.

Se hakee myös vain sen, mitä julkaisija on sisällyttänyt syötteeseen: otsikon, johdannon ja koko tekstin, jos syöte sisältää sen. Se ei kävele julkaisijan verkkosivustolle hakeakseen lisää tietoa. Tämä on tietoinen raja, ja se on syy siihen, miksi palvelu voi tehdä ne lupaukset, jotka se tekee julkaisijoiden näkökulmasta oikeussivullaan.

Ja koneisto niiden ympärillä

Näiden kahden syöttöreitin ympärillä toimii kymmenen muuta robottia eri aikatauluilla: lähteiden etsintä ja synkronointi, maakohtainen selvitys domainittain, trendien muodostaminen ja tarkistus, avainsanojen täydennys, kryptoalan mieliala, markkinatietojen haku, taksonomialuettelo, säilyvyys (90 päivän ikkinta pakotetaan yöllisellä kyselyllä published_at-kentän perusteella, ei indeksointialan iän perusteella), päivän varmentaminen, tyhjien artikkelien uudelleentarkistus ja terveysvalvonta, joka käynnistää uudelleen kaiken, mikä on lakannut toimimasta. Aineisto sijaitsee omassa Elasticsearch-klastereissa.

Mitä tämä tietojoukko tekee väärin

Palvelu julkaisee omat rajansa, mikä on nopein tapa arvioida, sopiiko se ongelmaasi.

Hyvän käytön periaatteet: kustannukset, sivutus ja virheet

Tokenien hallinta

Agentille vastauksen koko on todellinen kustannus. Dokumentoitu rakenne on:

KutsuSuuntaa antava token-kustannusAjankohta
/v1/stats~200Ensimmäiseksi. Päätä, onko haku edes kannattava suorittaa.
/v1/search vain metatiedotmuutama tuhat sivua kohdenSkannaa ja valitse.
/v1/search?full_text=true~900 per artikkeliVain niille harvoille, jotka todella valitsit.

Kahdeksankymmentä artikkelia parametrit full_text=true käyttäen on noin 40 000 tokenia. Suositeltu käytäntö on aina sama: laske, skannaa ja hae sitten rungot vain niille, joita tarvitset.

Siirtymistä ylärajan yli

offset pysähtyy arvoon 9 900. Suuren aineiston läpikäymisessä ei kannata taistella ylärajaa vastaan, vaan jakaa aineisto ajan perusteella. Toista silmukka päivittäin tai tuntitasolla kiireellisissä kyselyissä käyttäen parametreja from/to ja sort=date. Dokumentaatiossa on omat ohjeensa koko päivän läpikäymiseen.

Virheet

Sopimus on selkeä ja helppo toteuttaa: 4xx tarkoittaa, että pyyntö on virheellinen — korjaa se, älä yritä uudelleen. 5xx tarkoittaa, että palvelu on poissa päältä — hidasta. 429 tarkoittaa hidastamista ja uudelleenyritystä. Tuntemattomat kyselyparametrit jätetään huomiotta eikä hylätä, joten kentän lisääminen ei voi rikkoa olemassa olevaa asiakasohjelmaa.

Tunnista itsesi (Valinnainen ja aidosti valinnainen)

Avaimetta käyttämällä asiakasohjelmaa ei voi tavoittaa. Suositeltu kohteliaisuus on käyttää otsiketta, joka kertoo agentistasi, sen käyttöympäristöstä ja sen käyttämästä mallista:

X-Agent: agent_name=<agent>; software=<langchain|llamaindex|n8n|claude-desktop|cursor|openai-assistants|crewai|custom>; model=<model>; version=<v>; purpose=<rag|monitoring|research|digest>; contact=<url or mailto>
User-Agent: <agent>/<version> (+<contact url>)

Samat arvot toimivat myös suorina kyselyparametreina, mikä on yleensä helpompaa:

https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4o

Tuntemattomat avaimet jätetään huomiotta, joten ylimääräisten avainten lähettäminen on aina turvallista. Mitään ei validoida, mitään ei rajoitettu puuttumisen vuoksi, ja yksi ohje on tiukka: älä koskaan lisää näihin kenttiin pääkäyttäjän henkilökohtaisia tietoja.

Maksullisia uutisia API vastaan

Sivuston vertailusivut käsittelevät yksitellen yhtätoista kilpailijaa. Rakenteelliset erot, jotka selviävät kaikista:

Ilmaiset tasot muualla

100 pyyntöä/päivä, 24 tunnin viive

Ilmaisen news-API-tason tyypillinen muoto: token-astia, joka on niin pieni, että se sopii esittelyyn, ja tuoreet artikkelit pidetään maksaville asiakkaille.

  • Avain vaaditaan
  • Päivittäinen raja
  • Viivästyneet artikkelit
  • Vain ei-kaupallinen käyttö
Free News API

Ei rajoja, ei viivettä, ei avainta

Ainoa rajoitus on 20 pyyntöä/sekunti per IP-osoite. Tuorein artikkeli on yleensä alle kaksi minuuttia vanha, ja kaupallinen käyttö on sallittua.

  • Ei avainta, ei rekisteröitymistä
  • Ei päivittäistä tai kuukausittaista rajaa
  • Jatkuva päivitys
  • Kaupallinen käyttö sallittu
Kattavuus muualla

Englanti ensisijainen, Yhdysvallat ensisijainen

Useimmat korpusit on rakennettu englanninkielisestä julkaisijalistasta, johon on liitetty loppu maailma.

  • Englanninkielinen valta-asema
  • Ohut ei-latinakielinen kattavuus
Kattavuus tässä

Intia > Yhdysvallat, turkki > saksa

Noin 100 kieltä kuusinumeroisilla määrillä kreikassa, vietnamissa, persiassa, ukrainassa ja bulgariassa.

  • 100 maata
  • ~100 kieltä
  • 11 668 luokiteltua lähdettä

Mitä maksulliset palvelut tarjoavat edelleen ja mikä tässä puuttuu: tunnetasolaskenta ja entiteettien erottaminen vakio kenttinä, arkistot, jotka ulottuvat vuosien taakse, sekä sopimus, jossa on SLA-takuu. Nämä ovat todellisia ominaisuuksia, ja jos tarvitset niitä, sinun kannattaa ostaa ne.

Reseptit

Maakohtainen reaaliaikainen valvonta

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"

Onko tämä juttu globaali vai kotimainen?

curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world event

Maalaa malli nykypäivän kattavuuteen edullisesti

# 1. count first
curl "https://freenewsapi.ai/v1/stats?q=semiconductor+export+controls&date=7d"
# 2. scan metadata
curl "https://freenewsapi.ai/v1/search?q=semiconductor+export+controls&date=7d&lang=en&size=20&sort=relevance"
# 3. fetch bodies for the three you picked
curl "https://freenewsapi.ai/v1/article?url=<exact-url>&full_text=true"

Johtaako kattavuus hintaa?

curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"

Muunna tallennettu haku syötteeksi

https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50

Löydä markkinoilla merkitykselliset julkaisut

curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that slice

Lyhyt yhteenveto

Free News API on koko tekstin haku yli 21,5 miljoonasta uutisartikkelista, jotka on julkaistu yli 25 000 julkaisijalta 100 maassa ja noin 100 kielellä. Hakutulokset perustuvat jatkuvasti päivittyvään 90 päivän ikkunaan. Palvelu ei vaadi avainta, rekisteröitymistä eikä kuottia, vaan ainoastaan IP-kohtaisen nopeusrajoituksen. Haun päällä toimivat reaaliaikaiset uutisklusterit maatasolla 115 maassa, avainsanatutkimus, joka erottaa maailman tapahtumat kotimaan tapahtumista, neljätoista markkinainstrumenttia kuvattuna suhteessa uutisointimäärään, seitsemän osapisteestä koostuva Bitcoin-tunneanalyysi, RSS/Atom/JSON-syndikointi mille tahansa hakulausekkeelle sekä 28 työkalun MCP-palvelin, joka on luotu itse palvelun sisällöstä.

Palvelu dokumentoi omat virhetasonsa, paljastaa, miten jokainen maa-arvo on johdettu, ja julkistaa sivun siitä, missä tiedoissa on virheitä. Agentille, jonka on tiedettävä, mitä maailmassa tapahtuu — turkiksi, kreikaksi, hindiksi juuri nyt — tämä yhdistelmä on vaikea löytää millään hinnalla, ja tämä palvelu on ilmainen.

Haku toimii AND-logiikalla kaikkien termien välillä. Käytä 2–5 avainsanaa äläkä luonteenomaista kysymystä.

Free News API, ohjeet tehokkaaseen kyselyyn

Aloita täältä: freenewsapi.ai · MCP osoitteessa freenewsapi.ai/mcp · koko opas yhtenä tiedostona osoitteessa /llms-full.txt.