Vifaa vya habari API kwa kawaida vinauzwa kwa kulingana na ombi, vinafungwa kwa mfunguo, na vinakadiriwa kuwa na idhini ya maombi mia moja kwa siku kwenye daraja la bure. Free News API si moja ya mamayo hayo: makala milioni 21.5 kwenye dirisha la siku 90 linalosonga mbele, wachapishaji 25,000+, bila mfunguo, bila usajili, bila kikomo, matumizi ya biashara yanaruhusiwa. Hapa kuna uso wote — utafutaji, takwimu, mwenendo, masoko, vifaa na MCP — na ukweli wa kile ambacho data hii inapotosha.

Muundo wa Tatizo

Uliza kwenye AI ni nini ulimwengu unachoandika sasa na utapata chaguo mbili mbaya. Inaweza kuvuta habari kutoka kwa wachapishaji moja kwa moja, ambayo ni dhaifu, polepole na yenye matatizo ya kisheria. Inaweza kutumia kifaa cha habari API cha biashara, ambayo inamaanisha akaunti, mfunguo, bili ya kila mwezi na — kwenye kila daraja la bure katika soko — maombi mia moja kwa siku na makala yanayochelewa kwa masaa 24. Au inaweza kutabiri kutoka kwa data ya mafunzo iliyosimama miezi michache iliyopita.

Free News API inaondoa bei na kazi za kadi za chaguo la kati bila kuondoa uwezo wake. Ombi moja la GET, bila vyeti, kwenye mkusanyiko ambao wakati wa kuandika una makala 21,557,044 kutoka kwa wachapishaji zaidi ya elfu 25, yaliyoshikiliwa kwenye dirisha la siku 90 linalosonga mbele na kusasishwa mara kwa mara — makala mpya zaidi kwenye indexi ni ya kawaida chini ya dakika 2.

21.5M
makala zilizowekwa indexi
25,000+
wachapishaji
100
nchi
~100
lugha
siku 90
dira inayobadilika
0
fomu za API zilizopo
Kanuni: Hakuna fomu ya API iliyopo na haitakuwepo. Hakuna parameter yake, hakuna kichwa cha maombi cha kutuma, hakuna akaunti ya kuunda, na hakuna kikomo cha maombi — kuna tu kikomo cha kasi kulingana na IP ya 20 maombi kwa sekunde ili mmoja asishughulikie huduma kwa wote.

Makao Makuu Manne, na Zaidi

Kiini cha huduma ni makao manne ya GET, yote chini ya https://freenewsapi.ai, yote yakirudisha JSON ya UTF-8 na Access-Control-Allow-Origin: * ili msimbo wa kivinjari uweze kuwaandikia moja kwa moja, na yote yakiripoti wakati wa seva katika took_ms.

MakaoInajibu nini
GET /v1/searchUtafutaji wa maandishi yote pamoja na vichujio. Makao unayotumia 95% ya wakati.
GET /v1/statsIdadi iliyokusanywa kwa sehemu yoyote — kwa nchi, lugha, TLD, mchapishaji na siku.
GET /v1/articleMakala moja kwa URL yake kamili, ikiwa ni pamoja na maandishi yote ya mwili.
GET /healthUhai pamoja na idadi ya sasa ya hati. Ni ya bei nafuu ya kutosha kuangaliwa mara kwa mara.

Karibu na kiini hiki, kuna familia nyingine nne, kila moja ambayo ingekuwa bidhaa peke yake mahali pengine: trendi (kukusanyika kwa hadithi za moja kwa moja kulingana na nchi), soko (mfululizo wa bei ulio sawia na kiasi cha ukaguzi), hisia za crypto (block ya Bitcoin yenye viwango vitano) na usambazaji (utafutaji huo huo unaotolewa kama RSS, Atom au JSON Feed). Zote zinazungumziwa hapa chini.

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

Sehemu tatu katika hiyo majibu zinastahili makini ya haraka, kwa sababu zinazoeza uaminifu wa data yote. total_is_lower_bound inakuambia wakati idadi ya matokeo ilipofikia kizingiti cha 10,000 na kusimama kuhesabu. country_source inakuambia jinsi nchi ilivyobainishwa — kwa sababu katika data yoyote ya habari, sehemu kubwa ya maadili ya nchi ni makadirio, si ukweli. Na crawled_at ni wakati wa kuaminika: wachapishaji mara nyingi huweka tarehe ya nyuma published_at, lakini wakati wa kukusanya unatolewa na mtiririko na hauendi nyuma.

Tafuta: Kila Parameter inayostahili

Vigezo vyote ni hiari. Kuita bila vigezo hutoa makala mpya zaidi kwenye index.

Hoja

Tafuta kama injini ya utafutaji, si kama chatbot: Hii ndio makosa yanayotokea mara nyingi zaidi. Utafutaji ni AND kwa maneno yote, kwa hivyoandika maneno 2–5 ya ufungaji, si sentensi. opec production cut inafanya kazi. what did OPEC decide about oil haitoi matokeo yoyote.

Vichujio

Vichujio vinachanganya AND kote vigezo na OR ndani ya moja. Kwa hivyo country=DE,AT&lang=de inasoma "makala kwa lugha ya Kikiwa kutoka Ujerumani au Austria". Kila moja inakubali orodha ya thamani hadi sabini.

ChujaFomatiMaelezo
countryISO 3166-1 alpha-2, herufi kubwaNchi ya mchapishaji. Imepatikana, si iliyotangazwa — angalia country_source na strict_country.
langISO 639-1, herufi ndogoImegunduliwa kutoka kwa hati yenyewe. Inafikia asilimia 99.9.
tldbila nuktaEneo la domeni la mchapishaji. tld=ua ni ukweli; country=UA ni hitimisho.
hostmajina kamili ya hostKama zinavyoonekana katika URL — jumuisha www. ikiwa mchapishaji anatumia.
dateleo · jana · masaa 24 · masaa 48 · siku 7 · siku 30Kipindi kilichowekwa, kinapimwa dhidi ya published_at.
from / toTarehe za ISODira maalum ambapo vipimo vya awali havifai.
strict_countrykweli/hasiHesabu tu makala ambazo nchi yake ni ukweli thabiti badala ya hitilafu.

Udhibiti wa matokeo

KigezoThamaniAthari
sorttarehe · tarehe_asc · crawled · crawled_asc · relevancePanga kwa kutumia crawled unapovuta makala mpya — wachapishaji hushusha tarehe ya chapisho; wakati wa kusafiri kwenye tovuti huenda mbele tu.
size1–100Matokeo kwa kila ukurasa.
offset0–9900Uhamisho wa kurasa.
full_texttrue/falseJumuisha mwili wa makala. Imefungwa kwa chaguo-msingi.
highlighttrue/falseRudisha sehemu zilizolingana.
fieldsCSVPunguza mrejesho uwe na sehemu ambazo unazotumia tu.
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"

Kuhesabu Kabla ya Kutafuta

Ncha iliyotumika chini zaidi katika huduma ni /v1/stats. Mara nyingi swali la muhimu si "ni makala gani" bali "kuna kitu hapa yoyote, na kiko wapi?" Kuhesabu kunatoa jibu kwa sehemu ndogo ya gharama — takriban alama mia mbili badala ya maelfu kadhaa kwa ukurasa wa matokeo — jambo linalolifanya kuwa simu ya kwanza sahihi kwa ajili ya agentu inayotafuta kama kutafuta kunastahili kufanywa.

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

Inarudisha hesabu kulingana na nchi, lugha, TLD, mtoaji na siku, iliyohesabiwa kwa kuzingatia seti yote inayolingana badala ya ukurasa wa sasa. Hii ndiyo jinsi unavyopima ufunikaji kabla ya kuitambua. Picha isiyo na chujio wakati wa kuandika:

Nchi bora

NchiMakala
India2,286,014
Marekani2,180,797
Uturuki1,499,897
Urusi1,436,556
Italia1,057,479
Argentina826,947
Hispania812,347
Ukrainia662,041
Brazil551,013
Ujerumani543,132
Ufaransa502,846
Ugiriki460,372
Japani437,209
Vietnam408,934
Meksiko402,320
Korea Kusini362,945
Romania354,229
Uingereza334,379
Iran291,782
Poland255,599

Lugha kuu

Kihispania 2,699,457 · Kirusi 1,785,796 · Kituruki 1,501,004 · Kiitaliano 992,200 · Kijerumani 733,677 · Kifaransa 689,136 · Kiarabu 664,016 · Kireno 637,607 · Kihindi 560,840 · Kigiriki 466,504 · Kijapani 427,085 · Kivietnam 385,719 · Kiromania 358,766 · Kichina 352,720 · Kiukreni 345,809 · Kikorea 335,079 · Kipershia 268,126 · Kipoland 238,904 · Kibulgaria 183,204 · Kiingereza 5,513,650.

Usambazaji huu ni wa kuzingatia kwa sekunde moja, kwa sababu ni kinyume cha kile ambacho wachapishaji wengi wa habari API wanakupa. Maktaba ya kawaida ya Kihispania kwanza, Marekani kwanza siyo hii: India inafika juu ya Marekani, Kituruki kinafika juu ya Kijerumani, na Kigiriki, Kivietnam, Kipershia na Kibulgaria vyote vina uwakilishi wa tarakimu sita. Ikiwa swali lako ni kuhusu vyombo vya habari visivyo kwa Kihispania, hii ni seti ya data tofauti kabisa.

Kiasi

Mteremko wa kila siku katika by_day unafunika muda wa siku tisini kamili. Siku za hivi karibuni ziko katika masafa ya takriban makala 400,000 hadi 700,000 kwa siku; mapema zaidi katika muda huo, kabla ya tabaka la RSS kuongezwa pamoja na kuingizwa kwa maktaba, kiasi cha kila siku kilikuwa 130,000–230,000. Takwimu zote mbili zinaonekana katika jibu lile lile, ambalo ndilo lengo — huduma inakuonyesha mteremko wake mwenyewe badala ya kutoa wastani wa masoko.

Mienendo: Kile ambacho Vyombo vya Habari Vinachukua Sasa Kwa Kweli

Matunzo yanajibu swali la "kilichowriandwa kuhusu X". Mienendo inajibu swali tofauti na mara nyingi bora zaidi: "kuna nini kinatokea" — bila X inayohitajika.

Roboti huunganisha makala hadi hadithi kulingana na nchi na kuizisaidia zisibaki zama. Kila dakika tano makala mpya huambatana na hadithi zinazojulikana kwa maneno yake ya utambulisho, bila mlio wa modeli yoyote; kila baada ya masaa machache nchi hupitia kipimo kamili ambapo modeli ya lugha husoma vichwa vya habari na kuita hadithi kuanzia mwanzo. Wakati wa kuandika tabaka la mienendo linafunika nchi 115, kila moja inarekebishwa ndani ya dakika chache zilizopita.

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": [ … ]
    }
  ]
}

Takwili mbili huja pamoja na kila hadithi na zina maana tofauti. makala ni nguvu; vyombo vya habari ni upana. Hadithi yenye makala 200 kutoka kwa vyombo 2 ni shauku ya vyombo vya habari moja. Hadithi yenye makala 60 kutoka kwa vyombo 40 ni tukio. Mpangilio wa kawaida ni kulingana na vyombo vya habari, na min_publishers / min_articles hukuruhusu kuweka kigezo chako mwenyewe.

Hadithi huzamishwa kwa kategoria kutoka kwenye mkusanyiko uliowekwa: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.

Dirisha ni chaguo la msomaji, si la roboti

Hii ni uamuzi muhimu wa kubuni wenye ubora wa hali ya juu. Kila makala huhifadhiwa pamoja na wakati wa ukuchapishwa na kuunganishwa na hadithi yake, kwa hiyo dirisha lolote — dakika kumi na tano, saa moja, siku moja, au tarehe maalum ya kalenda — ni tu uhuaji wa masafa juu ya data ileile iliyohifadhiwa. Hesabu moja inatumika kwa kila dirisha kwa wakati mmoja. window=15m, window=1h, window=24h, date=2026-09-01, au jozi ya since/until inayoelezwa kwa uwazi zote hufanya kazi dhidi ya index ileile bila upangaji upya.

Maneno muhimu: maneno ambayo habari imejengwa juu yake

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

Kila neno muhimu hurejeshwa pamoja na idadi ya hadithi tofauti zinazozamishwa neno hilo, idadi ya makala ambazo hadithi hizo zina, na — kitu cha kuvutia — idadi ya vyombo vya habari vya kitaifa vinavyotumia neno hilo. Namba ya mwisho ndiyo tofauti kati ya tukio la kimataifa na la ndani. Neno linaloonekana katika nchi sabini ni habari ya ulimwengu; neno linalotawala vyombo vya habari vya nchi moja ni habari ya ndani, ingawa linaweza kuwa na nguvu sana pale.

Nchi zinazofanya kazi kwa wakati halisi

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

Hurudisha kila nchi inayofuatiliwa pamoja na idadi ya hadithi zake za wakati halisi na dakika ngapi zilizopita tangu upangaji upya — Turkey, Russia, Iran, Greece, India, Italy, Ukraine, Romania, Argentina, Germany na Brazil zote kwa sasa zina maelfu ya hadithi za wakati halisi kila moja, zilizopangwa upya ndani ya dakika kumi zilizopita. Na /v1/trends/{cc}/{slug} inafungua hadithi yoyote pekee pamoja na orodha yake kamili ya makala.

Masoko dhidi ya Ufunuo: Bei kwenyo Mhimili Mmoja, Makosa kwenyo Mwingine

Hii ndiyo kitu cha ajabu zaidi katika huduma, na ipo kwa sababu mkusanyiko unafanya kuwa rahisi karibu bila gharama kuujenga. Weka safu ya bei pamoja na jinsi ulimwengu ulivyozungumzia jambo hilo kwa masaa yale yale, kwenye mstari wa wakati mmoja.

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

Vifaa kumi na nne vinafuatiliwa, katika makundi manne ya mali:

KundiVifaaMipimoChanzo
CryptoBitcoin, Ethereum, Solana, XRP, BNB, DogecoinsaaBinance
MetaliDahabu (USD/oz)saaBinance
FXEUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLNsikuECB
NishatiBei ya umeme Ujerumani (EUR/MWh)saaEnergy-Charts
curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"

Mwitaji huo mmoja unakupa bei ya lira dhidi ya dola na kiasi cha ripoti za vyombo vya habari vya Uturuki katika kipindi hicho hicho, zikilinganishwa saa kwa saa. Vyombo vya habari vya Uturuki ni sehemu ya tatu kubwa zaidi ya mkusanyo huu wa data, na ndiyo sababu muunganiko huo huo hutoa matokeo yenye maana badala ya kelele.

Na bloku kamili ya hisia za Bitcoin

Bitcoin ina familia yake ya ncha saba, kwa sababu ndio chombo pekee ambacho mwelekeo wa habari na mwendo wa bei yanajadiliwa kwa mshono na mara chache hupimwa:

NchaMatokeo
/v1/btc/summaryBei ya hivi karibuni, harakati za hivi karibuni, na mwelekeo wa ukurasa wa leo.
/v1/btc/priceMabano ya BTC/USDT kwa kipindi.
/v1/btc/sentimentMwelekeo wa habari kwa kila kipindi.
/v1/btc/seriesBei na mwelekeo yameunganishwa kwenye mstari mmoja wa muda.
/v1/btc/correlationUhusiano kati ya mwelekeo na mwendo wa bei kwa kubadilisha muda — je, ukurasa unaweka kasi kwa bei, au unafuata?
/v1/btc/newsMakala za crypto zenye lebo yao ya hisia, zinazoweza kuchaguliwa kwa lebo, eneo la wavuti, lugha na utafutaji.
/v1/btc/sourcesNi vyombo vipi vinachangia ripoti za sarafu za kielektroniki, na kila kimoja kinaelekea upande gani.

Lebo za hisia zinatokana na mfumo wa lugha unaochunguza makala mpya za sarafu za kielektroniki kila dakika tano, kwa kulinganisha na orodha ya sarafu iliyopimwa. /v1/btc/correlation na parameter ya max_shift ndio kitu unachotaka kufikia ikiwa unataka kujaribu udai wa "habari husababisha mabadiliko" badala ya kuzirudia.

Utafutaji Uleule, kama Chanzo

Viungo viwili zaidi vinafanya kazi kwa vigezo vya utafutaji vinavyofanana na kuonyesha matokeo kama miundo ya ushiriki badala ya JSON:

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

Hii inamaanisha kwamba kila utafutaji uliohifadhiwa unakuwa chanzo unachoweza kuweka kwenye msomaji, node ya n8n, muunganisho wa Slack, kichocheo cha Zapier au kizalishaji cha tovuti thabiti — bila msimbo na bila muhtasari. Ni kipengele kidogo kinachoondoa kwa utulivu safu nzima ya muunganisho kwa wasio programu.

MCP: Zana Robini na Nusu, Tabaka Mbili

Seva ya MCP inakaa kwenye URL moja, inazungumza Streamable HTTP (JSON-RPC 2.0 kupitia POST, toleo la protokoli 2025-06-18), inasaidia kufanya kazi kwa pamoja, na — kama kila kitu kingine hapa — haina hatua ya idhini na haina kitambulisho cha kipindi.

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

Inaonyesha zana 28 katika tabaka mbili maalum.

Tabaka la kwanza: viashiria sita vinavyojibu swali lote kwa mlio mmoja

ZanaKwa ajili ya
search_news"Kilicholembwa kuhusu X" — utafutaji wa maandishi yote, matokeo yaliyopunguzwa.
get_trends"Kuna nini" — hadithi zilizopangwa kwa kundi badala ya orodha ya makala.
trend_keywordsManeno ambayo habari zimejengwa nazo sasa hivi, pamoja na idadi ya hadithi na usambazaji wa nchi.
find_publishersTafuta vyombo vya habari: jina, domeni, nchi, lugha, makala kwa siku.
list_countriesNchi zipi zina hadithi za moja kwa moja, ni ngapi, na ni za hivi karibuni kiasi gani.
market_vs_newsMfululizo wa bei pamoja na kiasi cha ukandamizaji. Itumia bila kifaa ili kuona kile kilicho wazi.

Tabaka la pili: kila kiashiria, kilichotolewa kutoka huduma yenyewe

Chini ya njia za haraka, kila kiashiria cha msingi kinachunguzwa kama zana yake mwenyewe yenye kila parameta ambayo API inakubali — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, familia yote ya news_get_btc_*, wavunja wa feed, na news_get_health. Hizi zimetolewa kutoka kwa huduma hai, kwa hivyo hazaweza kutofautiana na kile API kinachokubali kweli.

Zana mbili za meta zinazofunga mzunguko: news_list_endpoints inarudisha katalogu ya kila kitu kilipo, na news_get inafanya GET ya msingi kwenye njia yoyote — kwa hivyo agenti inayokutana na kiashiria ambacho orodha yake ya zana haijani, bado inaweza kufikia.

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

GET moja, bila mkataba, na una katalogu nzima inayosoma kwa mashine: seva, usafiri, itifaki, idadi ya zana, kila zana yenye maelezo yake, na kila kiashiria chenye orodha yake ya parameta.

Imejengwa Ili Kusomwa na Mashine

Nyaraka si mchakato wa nyuma uliofungwa kwenye API — ni matokeo ya daraja la kwanza wa nayo. Tovuti hutoa kurasa 665 za kimu, na kadhaa zipo mahususi ili mfano usihitaji kusoma HTML:

Pamoja na kurasa 168 za nchi, kurasa 121 za lugha na kurasa 275 za TLD — uso mmoja unaoweza kusafiri kwa kila sehemu ya kaulimbiu, kila moja ikiwaonyesha kile kilichopo ndani yake.

Mahali ambapo Makala Yanatoka

Njia mbili za kuingiza zinafedha indexi ileile, na tofauti kati yake ni muhimu.

Njia ya hifadhidata

Kila dakika kumi, kazi inahakikisha hifadhidata ya CC-NEWS ya Common Crawl kwa faili mpya za WARC na kuchakata yoyote ambayo haijawahi kuiona, kwa kutumia wafanyakazi sabini sambamba. Kichujaji kinautoa kila makala kutoka kwenye uchimbaji wa kwanza kwa kutumia mfululizo ulioandikwa kwa kila uga — na mfululizo huo ulipimwa dhidi ya data halisi badala ya kudhani:

UgaMfululizoUfunuo
maelezoJSON-LD → meta → OpenGraph → kadi ya Twitter → articleBody → aya ya kwanza98.1%
lugha<html lang> → JSON-LD inLanguage → og:locale99.9%
nchiccTLD → JSON-LD addressCountry → lugha-mkoa → og:locale79.1%
tareheJSON-LD datePublished → meta → trafilatura → wakati wa uchimbaji100%

Takwimu hiyo ya nchi ndiyo ya kweli, na ndiyo sababu country_source inapatikana kwenye kila makala: takriban asilimia isiyofikia arobaini ya rekodi hazina ishara ya nchi yenye uaminifu kabisa, na takriban asilimia thelathini ya thamani zilizopo ni makadirio badala ya ukweli. API inakuonyesha ni ipi ni ipi badala ya kudanganya.

Njia ya moja kwa moja

Roboti ya pili inafanya kazi kwa kuchunguza vyanzo vya RSS kila baada ya dakika tano, kwa mzunguko wenye maombi ya hali — chanzo kinachojibu 304 Not Modified kinachotumia takriban gharama ndogo, na muda wa kufanya kazi kwa kila chanzo umepangwa kulingana na mara ngapi kinachochapisha. Kituo kinachochapisha hadi hadithi tano kwa siku hakichunguziwa kila dakika kumi na tano.

Pia inachukua tu kile ambacho mchapishaji kimeweka kwenye chanzo: kichwa, muhtasari, na maandishi kamili ikiwa chanzo kinachotumia. Haingii kwenye tovuti ya mchapishaji ili kupata zaidi. Hii ni mpaka wa makusudi, na ndiyo sababu huduma inaweza kutoa ahadi zake kwenye ukurasa wake wa kisheria kwa wachapishaji.

Na mashine zinazozunguka

Karibu na njia mbili za kuingiza data, roboti zaidi ya kumi ziko kwenye ratiba: ugunduzi wa vyanzo na usawazishaji, kutatua nchi kwa kila domain, kujenga na kuchunguza mienendo, kujaza manufaa ya maneno muhimu, hisia za sarafu za kielektroniki, kuvuta soko, katalogi ya taksonomia, uhifadhi (kipindi cha siku kumi na tisa kinadhibitiwa na swali la usiku kwenye published_at, si kwa umri wa indexi), uthibitishaji wa siku, upya wa makala tupu, na kinga ya afya inayowasha upya kila kitu ambacho kimesimama. Makusanyo ya data yako kwenye klabu maalum ya Elasticsearch.

Kile Seti ya Data Hii Inachukulia Vibaya

Huduma inaonyesha vikwazo vyake, ambayo ni njia ya haraka ya kutathmini ikiwa inafaa kwa tatizo lako.

Kutumia kwa Ufanisi: Gharama, Kurasa na Hitilafu

Uadilifu wa tokeni

Kwa ajenti, ukubwa wa jibu ndio gharama halisi. Muundo wake ulioandikwa ni:

KuitaGharama ya takriban ya tokeniWakati
/v1/stats~200Kwanza. Amua kama utafutaji unastahili kufanywa.
/v1/search metadata pekeemilo chache kwa kila ukurasaSkani na uchague.
/v1/search?full_text=true~900 kwa kila makalaKwa wachache tu uliowachagua.

Makala ishirini yenye full_text=true ni takriban alama 40,000. Mfano unapendekezwa daima ni sawa: hesabu, skani, kisha kuleta maudhui kwa wachache unaohtaji.

Kupita mipaka ya kurasa

offset inasimama kwenye 9,900. Kwa kusafiri seti kubwa, usivumbe mipaka hiyo — badala yake, gawanya kwa wakati. Fungua mzunguko siku kwa siku, au saa kwa saa kwenye ombi lenye shughuli nyingi, kwa kutumia from/to na sort=date. Hati za msaada zina ukurasa maalum kuhusu kusafiri siku nzima.

Hitilafu

Mkataba ni wa moja kwa moja na rahisi kuandika kodi kulingana nayo: 4xx inamaanisha ombi ni la kosa — rekebisha, usirudi tena. 5xx inamaanisha huduma imeanguka — pumzisha. 429 inamaanisha pumzisha na urudi tena. Vigezo vya ombi visivyojulikana vinaachwa kwa kuzindua badala ya kukataa, kwa hivyo kuongeza sehemu haimwahi kuvuruga mteja aliyeipo.

Jitambulisha (Chaguo la Ziada, na Lako Kwa Kweli)

Kwa kutokuwa na ufunguo, hakuna njia ya kufikia mteja. Adabu inayopendekezwa ni kichwa cha kichwa kinachoweka jina la agent yako, mfumo unaoendeshwa nayo na muundo unaoiendesha:

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>)

Thamani hizo zifanana na vigezo vya ombi vya kawaida, ambayo kwa kawaida ni rahisi zaidi:

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

Vifungo visivyojulikana vinaachwa kwa kuzindua, kwa hivyo vifungo vya ziada vinaweza kutumika kwa salama. Hakuna kitu kinachothibitishwa, hakuna kitu kinachozuia kwa kutoa, na maelekezo mmoja ni thabiti: weka data ya kibinafsi ya mwisho katika sehemu hizi.

Kuhusu Habari za Malipo APIs

Kurasa za kulinganisha kwenye tovuti zinachunguza washindani elfu kumi na wachache. Tofauti muhimu zinazobaki zote:

Vipango vya bure vinavyopatikana kwa wengine

Maombi 100 kwa siku, kuchelewa kwa masaa 24

Muundo wa kawaida wa kipango cha habari za bure cha API: chombo cha tokeni kidogo cha kutosha kuwa demo, na makala mpya zimehifadhiwa kwa wateja waliojitolea.

  • Kitambulisho kinachohitajika
  • Kizuizi cha kila siku
  • Makala zilizochelewa
  • Kwa matumizi yasiyo ya biashara pekee
Free News API

Hakuna kizuizi, hakuna kuchelewa, hakuna kitambulisho

Maombi 20 kwa sekunde kwa kila IP ndio kikwazo pekee. Makala mpya zaidi kwa kawaida ni chini ya dakika mbili, na matumizi ya biashara yanaruhusiwa.

  • Hakuna kitambulisho, hakuna kujiandikisha
  • Hakuna kikwazi cha kila siku au cha mwezi
  • Kubadilishaji endelevu
  • Matumizi ya biashara yanaruhusiwa
Ufunuo wa habari kwa wengine

Kiingereza pekee, Marekani pekee

Maktaba mengi yanatengenezwa kutoka kwa orodha ya wachapisho wa lugha ya Kiingereza, kisha dunia nzima inaongezwa.

  • Inatambua Kiingereza
  • Ufunuo mdogo wa lugha zisizo lafaha
Ufunuo hapa

India > Marekani, Kituruki > Kijerumani

Takriban lugha 100 zenye kiasi cha maelfu makubwa katika Kigiriki, Kivietnam, Kiparsi, Kikishini na Kibulgaria.

  • Nchi 100
  • ~Lugha 100
  • Vyanzo 11,668 vilivyorekodiwa

Kile ambacho huduma za kulipia bado zinakupa ambacho hii haitoi: alama za hisia na uchambuzi wa vitu muhimu kama sehemu za kawaida, maktaba zinazorudi nyuma miaka mingi, na mkataba wenya SLA. Hizo ni halisi, na ukizihitaji unapaswa kuzunua.

Mipishi

Kifaa cha kufuatilia nchi kwa wakati halisi

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

Hadithi hii ni ya kimataifa au ya ndani?

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

Kufanya mfano uendelee kufuatilia habari za leo kwa bei nafuu

# 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"

Je, ufunuo unavutia bei?

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

Badilisha utafutaji uliowekwa kuwa chanzo cha habari

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

Pata vyombo vya habari vinavyoleta thamani katika soko

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

Muhtasari

Free News API ni utafutaji wa maandishi yote unaojumuisha makala zaidi ya milioni 21.5 za habari kutoka kwa wachapishaji zaidi ya 25,000 katika nchi 100 na takriban lugha 100, kwenye kipindi cha siku 90 kinachohamia, kinachosasishwa kwa mfululizo, bila ufunguo, bila usajili na bila kikomo cha matumizi zaidi ya kikomo cha kasi kwa kila IP. Kwenye utafutaji huu, kuna ukusanyaji wa hadithi kwa kila nchi katika hali halisi katika nchi 115, uchambuzi wa manafasi unaotenganisha matukio ya kimataifa na ya ndani, zana 14 za soko zilizochorwa dhidi ya kiasi cha ripoti, bloku ya hisia za Bitcoin yenye viwango 7, usambazaji wa RSS/Atom/JSON kwa ombi lolote, na seva ya MCP yenye zana 28 inayotokana na huduma yenyewe.

Inarekodi viwango vyake vya makosa, inaonyesha jinsi thamani ya kila nchi ilivyotolewa, na inachapisha ukurasa kuhusu makosa yanayoweza kutokea kwenye data. Kwa ajensi inayohitaji kujua kile ulimwengu unachosema — kwa Kituruki, kwa Kigiriki, kwa Kihindi, sasa hivi — mchanganyiko huo ni ngumu kupatikana kwa bei yoyote, na hii ni bure.

Utafutaji hutumia kanuni ya AND kwa maneno yote yote. Tumia manafasi 2–5, sio swali la lugha ya kawaida.

Free News API, jinsi ya kuomba vizuri

Anza hapa: freenewsapi.ai · MCP kwenye freenewsapi.ai/mcp · mwongozo mzima kama faili moja kwenye /llms-full.txt.