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.
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äätepiste | Mihin se vastaa |
|---|---|
GET /v1/search | Täydellinen tekstihaku suodattimilla. Päätepiste, jota käytät 95 %:ssa tapauksista. |
GET /v1/stats | Yhdistetyt lukumäärät mille tahansa osajoukolle — maan, kielen, TLD:n, julkaisijan ja päivän mukaan. |
GET /v1/article | Yksi artikkeli sen tarkan URL mukaisesti, mukaan lukien koko runko. |
GET /health | Livelisä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
- q Tehdään yhteensopivuus otsikon (pistepaino 3), kuvauksen (pistepaino 2) ja artikkelin rungon kanssa. AND-logiikka — jokaisen termin on oltava läsnä, joten sanan lisääminen supistaa tuloksia eikä laajenna niitä. Enintään 500 merkkiä.
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.
| Suodatin | Muoto | Huomautukset |
|---|---|---|
country | ISO 3166-1 alpha-2, isoina kirjaimina | Julkaisijan maa. Johtopäätös, ei ilmoitettu — katso country_source ja strict_country. |
lang | ISO 639-1, pieninään kirjaimina | Tunnistettu dokumentista itsestään. 99,9 % kattavuus. |
tld | ei pistettä | Julkaisijan verkkotunnuksen päätteeni. tld=ua on totuus; country=UA on johtopäätös. |
host | tarkat isäntänimet | Sellaisina kuin ne esiintyvät URL — sisällytä www., jos julkaisija käyttää sitä. |
date | tänään · eilen · 24 h · 48 h · 7 pv · 30 pv | Esiasetusten aikaväli, joka arvioidaan published_at-arvon perusteella. |
from / to | ISO-päivämäärät | Selkeä ikkuna, jolloin esiasetukset eivät sovi. |
strict_country | true/false | Laske vain artikkelit, joiden maa on varma tosiasia eikä vain olettamus. |
Lähtötiedoston hallinta
| Parametri | Arvot | Vaikutus |
|---|---|---|
sort | date · date_asc · crawled · crawled_asc · relevance | Lajittele crawled-kriteerin mukaan hakiessa uusia artikkeleita — julkaisijat asettavat julkaisupäiviksi taaksepäin siirtyviä päivämääriä; selausaika etenee vain eteenpäin. |
size | 1–100 | Tuloksia per sivu. |
offset | 0–9900 | Sivutuksen offset-arvo. |
full_text | true/false | Sisällytä artikkelin runko. Oletuksena pois päältä. |
highlight | true/false | Palauta osuvat tekstin osat. |
fields | CSV | Rajaa 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
| Maa | Artikkelit |
|---|---|
| Intia | 2,286,014 |
| Yhdysvallat | 2,180,797 |
| Turkki | 1,499,897 |
| Venäjä | 1,436,556 |
| Italia | 1,057,479 |
| Argentiina | 826,947 |
| Espanja | 812,347 |
| Ukraina | 662,041 |
| Brasilia | 551,013 |
| Saksa | 543,132 |
| Ranska | 502,846 |
| Kreikka | 460,372 |
| Japani | 437,209 |
| Vietnam | 408,934 |
| Meksiko | 402,320 |
| Etelä-Korea | 362,945 |
| Romania | 354,229 |
| Yhdistynyt kuningaskunta | 334,379 |
| Iran | 291,782 |
| Puola | 255,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:
| Luokka | Instrumentit | Jyvä | Lähde |
|---|---|---|---|
| Krypto | Bitcoin, Ethereum, Solana, XRP, BNB, Dogecoin | tunti | Binance |
| Metallit | Kulta (USD/oz) | tunti | Binance |
| Valuutat | EUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLN | päivä | EKP |
| Energia | Saksan sähkön hinta (EUR/MWh) | tunti | Energy-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äätepiste | Palautukset |
|---|---|
/v1/btc/summary | Tuorein hinta, viimeaikaiset liikkeet ja tämän päivän uutisoinnin sävy. |
/v1/btc/price | BTC/USDT-kynttilät välein. |
/v1/btc/sentiment | Uutisten sävy kausittain. |
/v1/btc/series | Hinta ja sävy samassa aikajanassa. |
/v1/btc/correlation | Korrelaatio sävyn ja hinnan liikkeen välillä ajan siirroksen mukaan — johtaako uutisointi hintaa vai seuraaako sitä? |
/v1/btc/news | Kryptoartikkeleita niiden tunnesävymerkinnän kera, suodatettavissa merkinnän, isäntäpalvelimen, kielen ja hakutermin perusteella. |
/v1/btc/sources | Mitkä 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:
GET /v1/rss— RSS 2.0GET /v1/atom— Atom 1.0GET /v1/feed.json— JSON Feed 1.1
https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=dateTä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/mcpSe tarjoaa 28 työkalua kahdessa tarkoituksellisessa kerroksessa.
Kerrosvaihe yksi: kuusi oikotietta, jotka vastaavat kokonaan kysymykseen yhdellä kutsulla
| Työkalu | Varteen |
|---|---|
search_news | "Mitä X:stä on kirjoitettu" — kokotekstihaku, tiivistetyt tulokset. |
get_trends | "Mitä tapahtuu" — ryhmiteltyjä juttuja artikkelilistan sijaan. |
trend_keywords | Sanat, joihin uutisointi perustuu juuri nyt, sisältäen juttilaskelmia ja maiden jakautumaa. |
find_publishers | Hae tiedotustaloja: nimi, verkkotunnus, maa, kieli, artikkeleita päivässä. |
list_countries | Mitkä maat tarjoavat reaaliaikaisia juttuja, kuinka monta ja kuinka tuoreita. |
market_vs_news | Hintasarja 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:
- /openapi.json Koko OpenAPI-kaavio.
- /llms.txt Lyhyt suuntausopas — palvelun luonne, päätepisteet, miten kyselyitä tehdään oikein ja virheet.
- /llms-full.txt Koko dokumentaatio yhtenä tekstitiedostona, yli sadan kilotavun laajuudelta, jotta agentti voi ladata koko oppaan yhdellä haulla.
- /agents Kolmekymmentäyhdeksän sivua, jotka on suunnattu nimenomaan agenttien rakentajille: valmiit OpenAI-funktiomäärittelyt, Anthropic-työkalukäyttömäärittelyt, järjestelmäkehotukset uutishakuun, RAG-ohjeet, token-kustannustaulukot ja agentti-ohjeet.
- /agents/models Työkalukutsukoodi kullekin malliperheelle — Qwen, DeepSeek, MiniMax, Kimi, GLM, Doubao, Hunyuan, ERNIE, Yi, Step, GPT, Claude, Gemini, Grok, Mistral, Llama, Command, Nova, Phi, Jamba, Sonar, OpenRouter, Ollama, vLLM.
- /data Mitä korpuksessa on, menetelmä, indeksointikaavio ja Data quality -otsikkoinen sivu, joka dokumentoi, missä tietojoukko tekee virheitä.
- /sources Selattava luettelo 11 668 kustantajasta, joka on rajattavissa maan, kielen ja verkkotunnusalueen mukaan.
- /compare Sivut rinnakkain NewsAPI.orgin, GNews.io:n, NewsData.io:n, Mediastackin, Currentsin, TheNewsAPIin, NewsCatcherin, WorldNewsAPIin, Perigonin, APITuben ja FreeNewsAPI.ion kanssa.
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ä | Priorisointiketju | Kattavuus |
|---|---|---|
| kuvaus | JSON-LD → meta → OpenGraph → Twitter-kortti → articleBody → johdantokappale | 98.1% |
| kieli | <html lang> → JSON-LD inLanguage → og:locale | 99.9% |
| maa | ccTLD → JSON-LD addressCountry → kieli-maakoodi → og:locale | 79.1% |
| päivämäärä | JSON-LD datePublished → meta → trafilatura → kaappausaika | 100% |
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.
- Maa on johdettu Lue
country_sourcejokaisesta artikkelista ja lisäästrict_country=true, kun lasket maatietojen perusteella etkä selaa. - published_at on julkaisijan toimittama Takaisinajo on yleistä. Järjestä
crawled-kentän mukaan, kun tarkistat, mikä on uutta. - total on rajoitettu 10 000:aan Nopeuden vuoksi.
total_is_lower_boundkertoo, kun olet saavuttanut katon. - Ei mieliala- tai entiteettien erottelua Bitcoin-lokon ulkopuolella artikkelit eivät sisällä mielialapisteyttä eikä nimettyjä entiteettejä. Se ei ole tämän toiminnallisuuden piirissä.
- Yhdeksänkymmenen päivän ajan eikä enempää Syvempää arkistoa ei ole. Jos tarvitset tietoa vuodelta 2019, tämä ei ole oikea työkalu.
- Ei SLA-takuuta Se on ilmainen. Sitä myös valvotaan ja suojataan, mutta mitään ei ole luvattu kirjallisesti.
- Teksti kuuluu julkaisijoille Jokainen vastaus sisältää alkuperäisen URL, ja käyttäjiltä odotetaan linkitystä takaisin siihen.
Hyvän käytön periaatteet: kustannukset, sivutus ja virheet
Tokenien hallinta
Agentille vastauksen koko on todellinen kustannus. Dokumentoitu rakenne on:
| Kutsu | Suuntaa antava token-kustannus | Ajankohta |
|---|---|---|
/v1/stats | ~200 | Ensimmäiseksi. Päätä, onko haku edes kannattava suorittaa. |
/v1/search vain metatiedot | muutama tuhat sivua kohden | Skannaa ja valitse. |
/v1/search?full_text=true | ~900 per artikkeli | Vain 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-4oTuntemattomat 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:
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ö
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
Englanti ensisijainen, Yhdysvallat ensisijainen
Useimmat korpusit on rakennettu englanninkielisestä julkaisijalistasta, johon on liitetty loppu maailma.
- Englanninkielinen valta-asema
- Ohut ei-latinakielinen kattavuus
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 eventMaalaa 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=50Lö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 sliceLyhyt 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.