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.
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.
| Makao | Inajibu nini |
|---|---|
GET /v1/search | Utafutaji wa maandishi yote pamoja na vichujio. Makao unayotumia 95% ya wakati. |
GET /v1/stats | Idadi iliyokusanywa kwa sehemu yoyote — kwa nchi, lugha, TLD, mchapishaji na siku. |
GET /v1/article | Makala moja kwa URL yake kamili, ikiwa ni pamoja na maandishi yote ya mwili. |
GET /health | Uhai 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
- q Inalinganishwa na kichwa (uzito 3), maelezo (uzito 2) na mwili wa makala. Semantiki ya AND — kila neno lazima liwepo, kwa hivyo kuongeza neno hupunguza badala ya kupanua. Kiwango cha juu ni herufi 500.
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.
| Chuja | Fomati | Maelezo |
|---|---|---|
country | ISO 3166-1 alpha-2, herufi kubwa | Nchi ya mchapishaji. Imepatikana, si iliyotangazwa — angalia country_source na strict_country. |
lang | ISO 639-1, herufi ndogo | Imegunduliwa kutoka kwa hati yenyewe. Inafikia asilimia 99.9. |
tld | bila nukta | Eneo la domeni la mchapishaji. tld=ua ni ukweli; country=UA ni hitimisho. |
host | majina kamili ya host | Kama zinavyoonekana katika URL — jumuisha www. ikiwa mchapishaji anatumia. |
date | leo · jana · masaa 24 · masaa 48 · siku 7 · siku 30 | Kipindi kilichowekwa, kinapimwa dhidi ya published_at. |
from / to | Tarehe za ISO | Dira maalum ambapo vipimo vya awali havifai. |
strict_country | kweli/hasi | Hesabu tu makala ambazo nchi yake ni ukweli thabiti badala ya hitilafu. |
Udhibiti wa matokeo
| Kigezo | Thamani | Athari |
|---|---|---|
sort | tarehe · tarehe_asc · crawled · crawled_asc · relevance | Panga kwa kutumia crawled unapovuta makala mpya — wachapishaji hushusha tarehe ya chapisho; wakati wa kusafiri kwenye tovuti huenda mbele tu. |
size | 1–100 | Matokeo kwa kila ukurasa. |
offset | 0–9900 | Uhamisho wa kurasa. |
full_text | true/false | Jumuisha mwili wa makala. Imefungwa kwa chaguo-msingi. |
highlight | true/false | Rudisha sehemu zilizolingana. |
fields | CSV | Punguza 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
| Nchi | Makala |
|---|---|
| India | 2,286,014 |
| Marekani | 2,180,797 |
| Uturuki | 1,499,897 |
| Urusi | 1,436,556 |
| Italia | 1,057,479 |
| Argentina | 826,947 |
| Hispania | 812,347 |
| Ukrainia | 662,041 |
| Brazil | 551,013 |
| Ujerumani | 543,132 |
| Ufaransa | 502,846 |
| Ugiriki | 460,372 |
| Japani | 437,209 |
| Vietnam | 408,934 |
| Meksiko | 402,320 |
| Korea Kusini | 362,945 |
| Romania | 354,229 |
| Uingereza | 334,379 |
| Iran | 291,782 |
| Poland | 255,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:
| Kundi | Vifaa | Mipimo | Chanzo |
|---|---|---|---|
| Crypto | Bitcoin, Ethereum, Solana, XRP, BNB, Dogecoin | saa | Binance |
| Metali | Dahabu (USD/oz) | saa | Binance |
| FX | EUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLN | siku | ECB |
| Nishati | Bei ya umeme Ujerumani (EUR/MWh) | saa | Energy-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:
| Ncha | Matokeo |
|---|---|
/v1/btc/summary | Bei ya hivi karibuni, harakati za hivi karibuni, na mwelekeo wa ukurasa wa leo. |
/v1/btc/price | Mabano ya BTC/USDT kwa kipindi. |
/v1/btc/sentiment | Mwelekeo wa habari kwa kila kipindi. |
/v1/btc/series | Bei na mwelekeo yameunganishwa kwenye mstari mmoja wa muda. |
/v1/btc/correlation | Uhusiano kati ya mwelekeo na mwendo wa bei kwa kubadilisha muda — je, ukurasa unaweka kasi kwa bei, au unafuata? |
/v1/btc/news | Makala za crypto zenye lebo yao ya hisia, zinazoweza kuchaguliwa kwa lebo, eneo la wavuti, lugha na utafutaji. |
/v1/btc/sources | Ni 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:
GET /v1/rss— RSS 2.0GET /v1/atom— Atom 1.0GET /v1/feed.json— JSON Chanzo 1.1
https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=dateHii 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/mcpInaonyesha zana 28 katika tabaka mbili maalum.
Tabaka la kwanza: viashiria sita vinavyojibu swali lote kwa mlio mmoja
| Zana | Kwa 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_keywords | Maneno ambayo habari zimejengwa nazo sasa hivi, pamoja na idadi ya hadithi na usambazaji wa nchi. |
find_publishers | Tafuta vyombo vya habari: jina, domeni, nchi, lugha, makala kwa siku. |
list_countries | Nchi zipi zina hadithi za moja kwa moja, ni ngapi, na ni za hivi karibuni kiasi gani. |
market_vs_news | Mfululizo 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:
- /openapi.json Shemamu kamili ya OpenAPI.
- /llms.txt Faili fupi ya uelekezo — huduma ni nini, viwango vya API, jinsi ya kufanya ulainishaji vizuri, na makosa yanayoweza kutokea.
- /llms-full.txt Nyaraka nzima ikiwa ni faili moja ya maandishi safi, yenye zaidi ya kilobyta mia moja, ili agenti iweze kuingiza mwongozo mzima kwa kufanya upakiaji mmoja.
- /agents Machapisho matatu kumi na tisa yaliyolengwa hasa kwa wabunifu wa agenti: ufafanuzi ya vitendo wa OpenAI tayari, ufafanuzi wa zana za Anthropic, maagizo ya mfumo ya utafutaji wa habari, mbinu za RAG, jedwali la gharama za tokeni, na mbinu za agenti.
- /agents/models Msimbo wa kuita zana kwa kila familia ya modeli — 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 Kile kilicho ndani ya mkusanyiko, mbinu, shemamu ya index, na ukurasa unaoitwa Ubora wa data unaorekodi kosa linalotokea kwenye seti ya data.
- /sources Katalogu inayoweza kutazamwa ya wachapishaji 11,668, inayoweza kuchaguliwa kwa nchi, lugha na eneo la domeni.
- /compare Machapisho ya kulinganisha na NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube na FreeNewsAPI.io.
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:
| Uga | Mfululizo | Ufunuo |
|---|---|---|
| maelezo | JSON-LD → meta → OpenGraph → kadi ya Twitter → articleBody → aya ya kwanza | 98.1% |
| lugha | <html lang> → JSON-LD inLanguage → og:locale | 99.9% |
| nchi | ccTLD → JSON-LD addressCountry → lugha-mkoa → og:locale | 79.1% |
| tarehe | JSON-LD datePublished → meta → trafilatura → wakati wa uchimbaji | 100% |
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.
- Nchi imekadirwa Soma
country_sourcekwenye kila makala, na ongezastrict_country=trueunapohesabu kulingana na nchi badala ya kusafiri. - published_at inatolewa na mchapishaji Kurekebisha tarehe ni kawaida. Panga kwa
crawledunapochunguza kile kipya. - total imefungwa kwa 10,000 Kwa kasi.
total_is_lower_boundinakuonyesha unapofikia kilele. - Hakuna hisia au uchambuzi wa vitu Nje ya bloku ya Bitcoin, makala hazina alama ya hisia wala vitu vilivyotambuliwa. Hii si ndani ya mpango.
- Siku tisini na chini ya hivyo Hakuna hifadhidata ya kina zaidi. Ikiwa unahitaji data ya mwaka 2019, huu ni zana isiyo sahihi.
- Hakuna SLA Ni bure. Pia inafuatiliwa na kulindwa, lakini hakuna ahadi ya kuandikwa.
- Maelezo yanamilikiwa na wachapishaji Kila jibu linajumuisha URL asilia, na watumiaji wanatarajiwa kuunganisha tena nayo.
Kutumia kwa Ufanisi: Gharama, Kurasa na Hitilafu
Uadilifu wa tokeni
Kwa ajenti, ukubwa wa jibu ndio gharama halisi. Muundo wake ulioandikwa ni:
| Kuita | Gharama ya takriban ya tokeni | Wakati |
|---|---|---|
/v1/stats | ~200 | Kwanza. Amua kama utafutaji unastahili kufanywa. |
/v1/search metadata pekee | milo chache kwa kila ukurasa | Skani na uchague. |
/v1/search?full_text=true | ~900 kwa kila makala | Kwa 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-4oVifungo 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:
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
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
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
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 eventKufanya 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=50Pata 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 sliceMuhtasari
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.