API Berita biasanya dijual berdasarkan permintaan, dikunci di sebalik kunci, dan dihadkan kepada seribu panggilan sehari pada peringkat percuma. Free News API tidak melakukan perkara tersebut: 21.5 juta artikel merangkumi tetingkap bergerak 90 hari, lebih 25,000 penerbit, tiada kunci, tiada pendaftaran, tiada kuota, penggunaan komersial dibenarkan. Berikut adalah keseluruhan permukaan — carian, statistik, tren, pasaran, suapan dan MCP — serta laporan jujur tentang apa yang data ini lakukan secara salah.
Bentuk Masalah
Tanya agen AI tentang apa yang sedang ditulis di seluruh dunia pada masa ini dan ia mempunyai tiga pilihan yang buruk. Ia boleh mengimbas penerbit secara langsung, yang rapuh, perlahan dan keliru dari segi undang-undang. Ia boleh memanggil API berita komersial, yang bermaksud akaun, kunci, bil bulanan dan — pada setiap peringkat percuma di pasaran — seribu permintaan sehari dan artikel tertangguh selama dua puluh empat jam. Atau ia boleh meneka dari data latihan yang berhenti beberapa bulan lalu.
Free News API membuang harga dan kertas kerja pilihan tengah tanpa membuang keupayaannya. Satu permintaan GET, tanpa kelayakan, ke atas korpus yang pada masa penulisan ini memegang 21,557,044 artikel dari lebih daripada dua puluh lima ribu penerbit, disimpan pada tetingkap bergerak sembilan puluh hari dan disegarkan secara berterusan — artikel terbaru dalam indeks biasanya berusia kurang daripada dua minit.
Empat Endpoint Teras, Dan Lain-Lain
Teras perkhidmatan ini ialah empat endpoint GET, semua di bawah https://freenewsapi.ai, semua mengembalikan JSON UTF-8 dengan Access-Control-Allow-Origin: * supaya kod pelayar boleh memanggilnya secara langsung, dan semua melaporkan masa sisi pelayan dalam took_ms.
| Endpoint | Soalan yang dijawab |
|---|---|
GET /v1/search | Carian teks penuh dengan penapis. Endpoint yang anda gunakan 95% masa. |
GET /v1/stats | Kiraan agregat untuk sebarang bahagian — mengikut negara, bahasa, TLD, penerbit dan hari. |
GET /v1/article | Satu artikel mengikut URL tepat, termasuk keseluruhan teks. |
GET /health | Status kesihatan (liveness) serta jumlah dokumen semasa. Murah cukup untuk diperiksa secara berkala. |
Di sekitar teras ini terdapat empat lagi kumpulan, setiap satunya boleh dianggap sebagai produk tersendiri di tempat lain: trends (pengelompokan cerita secara langsung mengikut negara), markets (siri harga yang diselaraskan dengan jumlah liputan), crypto sentiment (blok Bitcoin tujuh hujung), dan syndication (carian yang sama yang dijana sebagai RSS, Atom atau JSON Feed). Kesemuanya akan dibincangkan di bawah.
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"
}
]
}Tiga medan dalam respons tersebut layak mendapat perhatian segera kerana ia menyandarkan kejujuran keseluruhan set data. total_is_lower_bound memberitahu anda apabila jumlah padanan mencapai had atas 10,000 dan berhenti mengira. country_source memberitahu anda bagaimana negara ditentukan — kerana dalam mana-mana set data berita, sebahagian besar nilai negara adalah inferens, bukan fakta. Dan crawled_at adalah cap masa yang boleh dipercayai: penerbit sering menunda tarikh published_at, tetapi masa semakan dikaitkan oleh litar pemprosesan dan hanya bergerak ke hadapan.
Carian: Setiap Parameter yang Penting
Semua parameter adalah pilihan. Panggilan kosong akan memulangkan artikel terbaru dalam indeks.
Pertanyaan
- q Disamakan dengan tajuk (berat 3), deskripsi (berat 2) dan badan artikel. Semantik AND — setiap istilah mesti hadir, jadi menambah perkatan akan mempersempit, bukan meluaskan. Maksimal 500 aksara.
opec production cut berfungsi. what did OPEC decide about oil tidak memulangkan sebarang hasil.Penapis
Penapis digabungkan dengan AND merentas parameter dan OR dalam satu parameter. Jadi country=DE,AT&lang=de dibaca sebagai "artikel berbahasa Jerman dari Jerman atau Austria". Setiap satu menerima senarai berpisahkan koma sehingga lima puluh nilai.
| Penapis | Format | Nota |
|---|---|---|
country | ISO 3166-1 alpha-2, huruf besar | Negara penerbit. Diperolehan, bukan dinyatakan — lihat country_source dan strict_country. |
lang | ISO 639-1, huruf kecil | Dikesan daripada dokumen itu sendiri. Liputan 99.9%. |
tld | tanpa titik | Zon domain penerbit. tld=ua adalah fakta; country=UA adalah inferens. |
host | nama hos tepat | Seperti yang muncul dalam URL — sertakan www. jika penerbit menggunakannya. |
date | hari ini · semalam · 24j · 48j · 7h · 30h | Tempoh pratetap, dinilai berdasarkan published_at. |
from / to | Tarikh ISO | Tingkap eksplisit apabila pratetap tidak sesuai. |
strict_country | benar/salah | Hanya kira artikel yang negaranya merupakan fakta tegar dan bukan sekadar inferens. |
Kawalan output
| Parameter | Nilai | Kesan |
|---|---|---|
sort | tarikh · tarikh_asc · crawled · crawled_asc · relevansi | Urutkan mengikut crawled semasa mengimbas artikel baharu — penerbit akan menunda masa penerbitan; masa imbasan hanya bergerak ke hadapan. |
size | 1–100 | Keputusan setiap halaman. |
offset | 0–9900 | Anjak halaman. |
full_text | benar/salah | Memuatkan kandungan artikel. Tidak diaktifkan secara lalai. |
highlight | benar/salah | Pulangkan petikan yang sepadan. |
fields | CSV | Potong respons kepada medan yang benar-benar anda gunakan. |
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"Mengira Sebelum Mencari
Penamat yang paling kurang digunakan dalam perkhidmatan ini ialah /v1/stats. Selalunya, soalan yang berguna bukan "apakah artikelnya" tetapi "adakah apa-apa di sini, dan di mana ia berada". Mengira menjawab soalan itu dengan kos yang lebih rendah — kira-kira dua ratus token berbanding beberapa ribu untuk satu halaman keputusan — yang menjadikannya panggilan pertama yang tepat untuk agen yang memutuskan sama ada pencarian itu berbaloi untuk dijalankan.
curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"Ia memulangkan kiraan mengikut negara, bahasa, TLD, penerbit dan hari, dikira merentasi keseluruhan set yang sepadan bukannya halaman semasa. Ini juga cara anda mengukur liputan sebelum mempercayainya. Tangkapan layar tanpa penapis pada masa penulisan ini:
Negara teratas
| Negara | Artikel |
|---|---|
| India | 2,286,014 |
| Amerika Syarikat | 2,180,797 |
| Turki | 1,499,897 |
| Rusia | 1,436,556 |
| Itali | 1,057,479 |
| Argentina | 826,947 |
| Sepanyol | 812,347 |
| Ukraine | 662,041 |
| Brazil | 551,013 |
| Jerman | 543,132 |
| Perancis | 502,846 |
| Greece | 460,372 |
| Jepun | 437,209 |
| Vietnam | 408,934 |
| Mexico | 402,320 |
| Korea Selatan | 362,945 |
| Romania | 354,229 |
| United Kingdom | 334,379 |
| Iran | 291,782 |
| Poland | 255,599 |
Bahasa utama
Inggeris 5,513,650 · Sepanyol 2,699,457 · Rusia 1,785,796 · Turki 1,501,004 · Itali 992,200 · Jerman 733,677 · Perancis 689,136 · Arab 664,016 · Portugis 637,607 · Hindi 560,840 · Greek 466,504 · Jepun 427,085 · Vietnam 385,719 · Romania 358,766 · Cina 352,720 · Ukraine 345,809 · Korea 335,079 · Parsi 268,126 · Poland 238,904 · Bulgaria 183,204.
Taburan ini bernilai untuk diteliti seketika, kerana ia adalah kebalikan daripada apa yang diberikan oleh kebanyakan API berita. Korpus biasa yang mementingkan bahasa Inggeris dan Amerika Syarikat bukanlah seperti ini: India mendahului Amerika Syarikat, Turki mendahului Jerman, dan Greek, Vietnam, Parsi serta Bulgaria masing-masing mempunyai perwakilan enam angka. Jika soalan anda berkaitan dengan akhbar bukan bahasa Inggeris, ini adalah set data yang berbeza secara ketara.
Isipadu
Lengkung harian dalam by_day meliputi keseluruhan tetingkap sembilan puluh hari. Hari-hari terkini berada dalam lingkungan kira-kira 400,000 hingga 700,000 artikel sehari; pada awal tetingkap tersebut, sebelum lapisan RSS ditambah bersama pengambilan arkib, isipadu harian berada pada 130,000–230,000. Kedua-dua angka tersebut boleh dilihat dalam respons yang sama, yang merupakan intipati perkhidmatan ini — ia menunjukkan kepada anda peningkatan kendiriannya daripada hanya mengutip purata pemasaran.
Trend: Apa yang Sebenarnya Diliput oleh Akhbar Sekarang
Carian menjawab soalan "apa yang ditulis tentang X". Trend menjawab soalan yang berbeza dan sering kali lebih baik: "apa yang sedang berlaku" — tanpa memerlukan X.
Robot mengelompokkan artikel kepada cerita mengikut negara dan mengekalkannya dikemas kini. Setiap lima minit, artikel baharu dilekatkan kepada cerita yang diketahui melalui kata-kata pengenalannya, tanpa sebarang panggilan model; setiap beberapa jam, satu negara melalui proses lengkap di mana model bahasa membaca tajuk dan menamakan semula cerita tersebut dari awal. Pada masa penulisan, lapisan trend meliputi 115 negara, yang masing-masing dikira semula dalam beberapa minit yang lalu.
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": [ … ]
}
]
}Setiap cerita disertakan dengan dua kiraan dan ia mempunyai maksud yang berbeza. articles (artikel) mewakili kehebatan; publishers (penerbit) mewakili keluasan. Cerita dengan 200 artikel dari 4 penerbit adalah obsesi satu redaksi. Cerita dengan 60 artikel dari 40 penerbit adalah satu peristiwa. Susunan lalai adalah berdasarkan penerbit, dan min_publishers / min_articles membolehkan anda menetapkan piawaian anda sendiri.
Setiap cerita dikategorikan mengikut satu set tetap: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.
Tingkap masa adalah pilihan pembaca, bukan robot
Ini adalah keputusan reka bentuk yang sungguh elegan. Setiap artikel disimpan bersama masa penerbitannya dan dikaitkan dengan cerita masing-masing, jadi mana-mana tingkap masa — lima belas minit, sejam, sehari, atau tarikh kalendar tertentu — hanyalah satu pertanyaan julat (range query) ke atas data yang sama yang telah disimpan. Satu pengiraan melayani semua tingkap serentak. window=15m, window=1h, window=24h, date=2026-09-01, atau pasangan since/until yang dinyatakan secara eksplisit semuanya berfungsi terhadap indeks yang sama tanpa perlu pengiraan semula.
Kata kunci: perkataan yang menjadi asas berita
curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"Setiap kata kunci dikembalikan bersama bilangan cerita berbeza yang menggunakannya, bilangan artikel yang terkandung dalam cerita-cerita tersebut, dan — yang paling menarik — bilangan akhbar nasional yang menggunakannya. Angka terakhir inilah yang membezakan peristiwa global daripada domestik. Satu perkataan yang muncul di tujuh puluh negara adalah cerita dunia; satu perkataan yang mendominasi akhbar di satu negara adalah cerita domestik, tidak kira seberapa kuat ia disuarakan di negara tersebut.
Negara mana yang sedang disokong secara langsung
curl "https://freenewsapi.ai/v1/trends/countries"Mengembalikan setiap negara yang dipantau beserta bilangan cerita langsungnya dan berapa minit lalu ia dikira semula — Turki, Rusia, Iran, Greece, India, Itali, Ukraine, Romania, Argentina, Jerman dan Brazil semuanya kini mempunyai ribuan cerita langsung masing-masing, yang dikira semula dalam tempoh sepuluh minit yang lalu. Dan /v1/trends/{cc}/{slug} membuka mana-mana cerita tunggal beserta senarai artikel penuhnya.
Pasar vs. Liputan: Harga pada Satu Paksi, Perhatian pada Paksi Lain
Ini adalah ciri paling luar biasa dalam perkhidmatan ini, dan ia wujud kerana korpus menjadikan pembinaannya hampir percuma. Letakkan siri harga bersebelahan dengan berapa banyak dunia menulis tentang perkara tersebut dalam jam yang sama, pada satu garis masa.
curl "https://freenewsapi.ai/v1/markets"Empat instrumen dipantau, merangkumi empat kelas aset:
| Kelas | Instrumen | Granulariti | Sumber |
|---|---|---|---|
| Kripto | Bitcoin, Ethereum, Solana, XRP, BNB, Dogecoin | jam | Binance |
| Logam | Emas (USD/oz) | jam | Binance |
| FX | EUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLN | hari | ECB |
| Tenaga | Harga kuasa Jerman (EUR/MWh) | jam | Energy-Charts |
curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"Panggilan tunggal itu memberikan anda nilai lira terhadap dolar dan jumlah liputan akhbar Turki dalam tempoh yang sama, disusun mengikut jam. Akhbar Turki merupakan komponen ketiga terbesar dalam korpus ini, itulah sebabnya pasangan ini menghasilkan sesuatu yang bermakna dan bukan sekadar hingar.
Dan blok sentimen Bitcoin yang lengkap
Bitcoin mendapat keluarga tersendiri yang terdiri daripada tujuh titik akhir, kerana ia merupakan satu-satunya instrumen di mana nada berita dan pergerakan harga sentiasa diperdebatkan tetapi jarang diukur:
| Titik Akhir | Data |
|---|---|
/v1/btc/summary | Harga terkini, pergerakan semasa, dan nada liputan berita hari ini. |
/v1/btc/price | Candlestick BTC/USDT mengikut selang masa. |
/v1/btc/sentiment | Nada berita mengikut tempoh masa. |
/v1/btc/series | Harga dan nada diselaraskan dalam satu garis masa. |
/v1/btc/correlation | Korelasi antara nada dan pergerakan harga mengikut pergeseran masa — adakah liputan mendahului pergerakan harga, atau mengikutinya? |
/v1/btc/news | Artikel kripto bersama label sentimennya, boleh ditapis mengikut label, hos, bahasa dan kata kunci carian. |
/v1/btc/sources | Outlet mana yang memacu liputan kripto, dan bagaimana setiap satunya condong. |
Label sentimen berasal daripada model bahasa yang memproses artikel kripto segar setiap lima minit, berbanding senarai syiling yang telah dikalibrasikan. /v1/btc/correlation dengan parameter max_shift ialah pilihan yang perlu dicapai jika anda pernah ingin menguji tuntutan "berita menyebabkan pergerakan" bukannya mengulangnya.
Carian Sama, Sebagai Suapan
Tiga lagi hujung sambungan mengambil parameter carian yang sama dan menjana hasil dalam format sindikasi bukan JSON:
GET /v1/rss— RSS 2.0GET /v1/atom— Atom 1.0GET /v1/feed.json— JSON Suapan 1.1
https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=dateIni bermakna sebarang carian yang disimpan menjadi suapan yang boleh anda tampal ke dalam pembaca, nod n8n, integrasi Slack, pencetus Zapier atau penjana laman statik — tanpa kod dan tanpa kunci. Ia adalah ciri kecil yang secara senyap membuang keseluruhan lapisan integrasi untuk bukan pengaturcara.
MCP: Dua Puluh Lapan Alat, Dua Lapisan
Pelayan MCP terletak di satu URL, menyokong HTTP Boleh Dipaparkan (JSON-RPC 2.0 melalui POST, versi protokol 2025-06-18), menyokong pengumpulan, dan — seperti semua yang lain di sini — tidak mempunyai langkah pengesahan dan tidak mempunyai id sesi.
claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcpIa mendedahkan 28 alat dalam dua lapisan yang disengajakan.
Lapisan satu: enam pintasan yang menjawab keseluruhan soalan dalam satu panggilan
| Alat | Untuk |
|---|---|
search_news | "Apa yang ditulis tentang X" — carian teks penuh, hasil yang dipotong. |
get_trends | "Apa yang berlaku" — cerita yang dikelompokkan, bukan senarai artikel. |
trend_keywords | Perkataan yang menjadi asas berita pada masa ini, termasuk bilangan cerita dan penyebaran mengikut negara. |
find_publishers | Cari penerbit: nama, domain, negara, bahasa, bilangan artikel sehari. |
list_countries | Negara mana yang mempunyai cerita langsung, berapa banyak, dan seberapa terkini. |
market_vs_news | Siri harga bersebelahan dengan isipadu liputan. Panggil tanpa instrumen untuk melihat apa yang tersedia. |
Lapisan dua: setiap titik akhir, dijana daripada perkhidmatan itu sendiri
Di bawah jalan pintas, setiap titik akhir mentah didedahkan sebagai alat tersendiri dengan setiap parameter yang diterima oleh API — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, keseluruhan keluarga news_get_btc_*, pengendali suapan, dan news_get_health. Ini dijana daripada perkhidmatan langsung, jadi ia tidak akan menyimpang daripada apa yang sebenarnya diterima oleh API.
Dua alat meta melengkapkan kitaran: news_list_endpoints mengembalikan katalog segala yang wujud, dan news_get melaksanakan GET mentah pada mana-mana laluan — jadi agen yang menemui titik akhir yang tidak dicakupi oleh senarai alatnya masih boleh mencapainya.
curl "https://freenewsapi.ai/mcp?format=json"Satu GET, tanpa penggantungan, dan anda mempunyai katalog yang boleh dibaca mesin sepenuhnya: pelayan, pengangkutan, protokol, bilangan alat, setiap alat dengan huraian, dan setiap titik akhir dengan senarai parameter.
Dibina untuk Dibaca oleh Mesin
Dokumentasi ini bukan sekadar tambahan yang dilekatkan pada API — ia adalah output kelas utama daripadanya. Laman web ini menghantar 665 halaman statik, dan beberapa di antaranya wujud khusus supaya model tidak perlu membaca HTML:
- /openapi.json Skema OpenAPI yang lengkap.
- /llms.txt Fail orientasi ringkas — apa itu perkhidmatan ini, titik akhir (endpoints), cara melakukan pertanyaan dengan baik, serta ralat.
- /llms-full.txt Seluruh dokumentasi dalam satu fail teks biasa, melebihi seratus kilobyt, supaya agen boleh memuatkan keseluruhan manual dalam satu panggilan muat turun.
- /agents Tiga puluh sembilan halaman yang khusus untuk pembina agen: definisi fungsi OpenAI sedia guna, definisi penggunaan alat Anthropic, arahan sistem untuk pengambilan berita, resipi RAG, jadual kos token, dan resipi agen.
- /agents/models Kod panggilan alat mengikut keluarga model — 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 Apa yang terkandung dalam korpus, metodologi, skema indeks, dan sebuah halaman bertajuk Kualiti Data yang mendokumentasikan kesilapan dalam set data tersebut.
- /sources Katalog yang boleh diteroka mengandungi 11,668 penerbit, yang boleh ditapis mengikut negara, bahasa dan zon domain.
- /compare Halaman perbandingan bersebelahan dengan NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube dan FreeNewsAPI.io.
Serta 168 halaman negara, 121 halaman bahasa dan 275 halaman TLD — satu permukaan boleh lawati untuk setiap bahagian korpus, setiap satunya memaparkan apa yang sebenarnya terkandung di dalamnya.
Asal Usul Artikel
Dua laluan penyepaduan memberi makan kepada indeks yang sama, dan perbezaan di antara keduanya mempunyai kepentingan.
Laluan arkib
Setiap sepuluh minit, satu tugas menyemak arkib CC-NEWS Common Crawl bagi mencari fail WARC baharu dan memproses apa sahaja yang belum pernah dilihatnya, menggunakan empat puluh pekerja selari. Pengeluar teks mengekstrak setiap artikel daripada hasil lepan mentah menggunakan satu rantaian yang telah didokumenkan bagi setiap medan — dan rantaian tersebut telah diukur terhadap data sebenar bukan sekadar andaian:
| Medan | Rantaian | Liputan |
|---|---|---|
| description | JSON-LD → meta → OpenGraph → kad Twitter → articleBody → perenggan pendahuluan | 98.1% |
| language | <html lang> → JSON-LD inLanguage → og:locale | 99.9% |
| country | ccTLD → JSON-LD addressCountry → bahasa-wilayah → og:locale | 79.1% |
| date | JSON-LD datePublished → meta → trafilatura → masa lepan | 100% |
Angka negara itu adalah yang paling jujur, dan itulah sebabnya country_source didedahkan pada setiap artikel: kira-kira satu perlima rekod tidak mempunyai isyarat negara yang boleh dipercayai langsung, dan kira-kira satu ketiga nilai yang wujud adalah inferens bukan fakta. API memberitahu anda mana yang mana secara terus-terang, bukan dengan berpura-pura.
Laluan langsung
Satu robot kedua mengimbas suapan penerbit RSS setiap lima minit, dalam kitaran dengan permintaan bersyarat — suapan yang memulangkan 304 Not Modified hampir tidak menelan kos, dan selang pengimbasan setiap suapan telah disesuaikan dengan kekerapan penerbitan sebenar. Sebuah penerbit yang menerbitkan lima cerita sehari tidak akan diimbas setiap lima belas minit.
Ia juga hanya mengambil apa yang diletakkan oleh penerbit dalam suapan tersebut: tajuk, ringkasan, dan teks penuh apabila suapan memuatkannya. Ia tidak melayari laman web penerbit untuk mendapatkan lebih banyak kandungan. Itu adalah had yang disengajakan, dan itulah sebabnya perkhidmatan ini dapat menepati janji yang dibuat pada halaman undang-undang yang berorientasikan penerbit.
Dan jentera di sekelilingnya
Di sekitar dua laluan pengumpulan data terdapat lebih sedozen robot lain yang beroperasi mengikut jadual: penemuan dan penyegerakan sumber, resolusi negara per-domain, pembinaan dan audit trend, pengisian semula kata kunci, sentimen kripto, tarikan pasaran, katalog taksonomi, pengekalan (selang sembilan puluh hari dikuatkuasakan oleh kuarim malam pada published_at, bukan oleh usia indeks), pengesahan hari, semakan semula artikel kosong, dan penjaga kesihatan yang memulakan semula apa sahaja yang telah berhenti. Korpus ini disimpan pada klaster Elasticsearch yang khusus.
Apa yang Set Data Ini Lakukan Salah
Perkhidmatan ini menerbitkan had-had sendiri, yang merupakan cara terpantas untuk menilai sama ada ia sesuai dengan masalah anda.
- Negara adalah inferens Baca
country_sourcepada setiap artikel, dan tambahkanstrict_country=trueapabila anda mengira mengikut negara berbanding melayari. - published_at adalah dibekalkan oleh penerbit Penanggalan balik adalah biasa. Susun mengikut
crawledapabila anda mengimbas untuk melihat apa yang baru. - Jumlah maksimum adalah 10,000 Untuk kelajuan.
total_is_lower_boundmemberitahu anda apabila anda mencapai had atas. - Tiada ekstraksi sentimen atau entiti Di luar blok Bitcoin, artikel tidak mempunyai skor sentimen dan tiada entiti bernama. Itu tidak berada dalam skop.
- Sembilan puluh hari dan tidak lebih Tiada arkib yang lebih mendalam. Jika anda memerlukan data tahun 2019, ini bukan alat yang tepat.
- Tiada SLA Ia percuma. Ia juga dipantau dan dilindungi, tetapi tiada jaminan yang dijanjikan secara bertulis.
- Teks menjadi hak milik penerbit Setiap respons termasuk URL asal, dan pengguna dijangka memberikan pautan kembali kepadanya.
Penggunaan Berkesan: Kos, Penimbalan Halaman dan Ralat
Disiplin token
Untuk agen, saiz respons adalah kos sebenar. Bentuk yang didokumentasikan:
| Panggilan | Kos token anggaran | Bila |
|---|---|---|
/v1/stats | ~200 | Pertama. Putuskan sama ada carian ini bernilai untuk dijalankan. |
/v1/search hanya metadata | beberapa ribu setiap halaman | Imbas dan pilih. |
/v1/search?full_text=true | ~900 setiap artikel | Hanya untuk sedikit artikel yang benar-benar anda pilih. |
Dua puluh artikel dengan full_text=true adalah kira-kira 40,000 token. Corak yang disyorkan sentiasa sama: kira, imbas, kemudian ambil kandungan penuh hanya untuk artikel yang diperlukan.
Halaman melebihi had atas
offset berhenti pada 9,900. Untuk memindai set data yang besar, jangan melawan had tersebut — gunakan penapisan berdasarkan masa pula. Ulang setiap hari, atau setiap jam untuk pertanyaan yang sibuk, dengan from/to dan sort=date. Dokumentasi mempunyai halaman khusus mengenai cara memindai keseluruhan hari.
Ralat
Kontrak ini jelas dan mudah dikodkan: 4xx bermaksud permintaan anda salah — betulkannya, jangan cuba semula. 5xx bermaksud perkhidmatan sedang rosak — kurangkan frekuensi permintaan. 429 bermaksud perlahankan dan cuba semula. Parameter pertanyaan yang tidak diketahui akan diabaikan, bukan ditolak, jadi menambah medan baru tidak akan pernah mengganggu pemanggil sedia ada.
Kenal Pasti Diri Anda (Pilihan, dan Benar-benar Pilihan)
Tanpa kunci, tiada cara untuk menghubungi pemanggil. Sopan santu yang dicadangkan ialah menggunakan header yang menamakan agen anda, rangka kerja yang digunakan, dan model AI yang menjalankannya:
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>)Nilai yang sama boleh digunakan sebagai parameter pertanyaan biasa, yang biasanya lebih mudah:
https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4oKunci yang tidak diketahui akan diabaikan, jadi kunci tambahan sentiasa selamat untuk dihantar. Tiada pengesahan, tiada penapisan jika ia diabaikan, dan satu arahan yang tegas: jangan letakkan data peribadi pengguna akhir dalam medan ini.
Melawan Berita Berbayar APIs
Halaman perbandingan di tapak web merangkumi sebelas pesaing secara individu. Perbezaan struktur yang kekal pada kesemua mereka:
100 permintaan/hari, kelewatan 24 jam
Bentuk standard pakej berita percuma-API: tong token yang cukup kecil untuk menjadi demo, dengan artikel segar ditahan untuk pelanggan berbayar.
- Kunci diperlukan
- Had harian
- Artikel tertunda
- Komersial tidak dibenarkan
Tiada had, tiada kelewatan, tiada kunci
Had 20 permintaan/saat per IP adalah satu-satunya had. Artikel terbaru biasanya berusia kurang daripada dua minit, dan penggunaan komersial dibenarkan.
- Tiada kunci, tiada pendaftaran
- Tiada had harian atau bulanan
- Segar semula secara berterusan
- Penggunaan komersial dibenarkan
Utamakan bahasa Inggeris, utamakan Amerika Syarikat
Kebanyakan korpus dibina daripada senarai penerbit berbahasa Inggeris dengan baki dunia ditambah pada hujungnya.
- Dominasi bahasa Inggeris
- Liputan bukan Latin yang nipis
India > AS, Turki > Jerman
Kira-kira 100 bahasa dengan jumlah data berangka enam dalam bahasa Yunani, Vietnam, Parsi, Ukraine dan Bulgaria.
- 100 negara
- ~100 bahasa
- 11,668 sumber yang tersenarai
Apa yang perkhidmatan berbayar masih berikan kepada anda tetapi ini tidak: skor sentimen dan pengekstrakan entiti sebagai medan piawai, arkib yang kembali beberapa tahun, dan kontrak dengan SLA di belakangnya. Itu adalah perkara sebenar, dan jika anda memerlukannya, anda harus membelinya.
Resipi
Pemantau negara secara langsung
curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"Adakah cerita ini global atau domestik?
curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world eventDasarkan model pada liputan semasa dengan kos rendah
# 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"Adakah liputan mendahului harga?
curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"Tukar carian tersimpan menjadi suapan
https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50Cari outlet yang penting dalam pasaran
curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that sliceVersi Ringkas
Free News API ialah carian teks penuh ke atas lebih 21.5 juta artikel berita dari lebih 25,000 penerbit di 100 negara dan kira-kira 100 bahasa, dalam tetingkap bergerak sembilan puluh hari, disegarkan secara berterusan, tanpa kunci, tanpa pendaftaran dan tanpa kuota melebihi had kadar per-IP. Di atas carian ini terdapat pengelompokan kisah semasa mengikut negara di 115 negara, analisis kata kunci yang memisahkan peristiwa dunia daripada domestik, fourteen instrumen pasaran yang dipetakan terhadap isipadu liputan, blok sentimen Bitcoin tujuh hujung, RSS/Atom/JSON sindikasi untuk sebarang pertanyaan, dan pelayan MCP 28 alat yang dijana daripada perkhidmatan itu sendiri.
Ia mendokumentasikan kadar kesilapannya sendiri, mendedahkan bagaimana setiap nilai negara diterbitkan, dan menerbitkan halaman mengenai apa yang data itu salah. Untuk agen yang perlu mengetahui apa yang dunia katakan — dalam bahasa Turki, dalam bahasa Yunani, dalam bahasa Hindi, pada masa ini — gabungan ini sukar ditemui pada harga apa pun, dan yang ini percuma.
Carian menggunakan AND merentas semua istilah. Gunakan 2–5 kata kunci, bukan soalan bahasa semula jadi.
Free News API, mengenai cara membuat pertanyaan dengan baik
Mula di sini: freenewsapi.ai · MCP di freenewsapi.ai/mcp · seluruh manual sebagai satu fail di /llms-full.txt.