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.

21.5M
artikel diindeks
25,000+
penerbit
100
negara
~100
bahasa
90 hari
jendela gelung
0
API kunci wujud
Peraturan: Tiada kunci API wujud dan tiada akan wujud. Tiada parameter untuknya, tiada header untuk dihantar, tiada akaun untuk dibuat, dan tiada kuota permintaan — hanya had kadar per-IP sebanyak 20 permintaan sesaat supaya satu pemanggil tidak boleh meruntuhkan perkhidmatan untuk pengguna lain.

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.

EndpointSoalan yang dijawab
GET /v1/searchCarian teks penuh dengan penapis. Endpoint yang anda gunakan 95% masa.
GET /v1/statsKiraan agregat untuk sebarang bahagian — mengikut negara, bahasa, TLD, penerbit dan hari.
GET /v1/articleSatu artikel mengikut URL tepat, termasuk keseluruhan teks.
GET /healthStatus 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

Gunakan pertanyaan seperti enjin carian, bukan seperti bot sembang: Ini adalah kesilapan paling biasa. Carian menggunakan AND merentas semua istilah, jadi tulis 2–5 kata kunci, bukan ayat. 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.

PenapisFormatNota
countryISO 3166-1 alpha-2, huruf besarNegara penerbit. Diperolehan, bukan dinyatakan — lihat country_source dan strict_country.
langISO 639-1, huruf kecilDikesan daripada dokumen itu sendiri. Liputan 99.9%.
tldtanpa titikZon domain penerbit. tld=ua adalah fakta; country=UA adalah inferens.
hostnama hos tepatSeperti yang muncul dalam URL — sertakan www. jika penerbit menggunakannya.
datehari ini · semalam · 24j · 48j · 7h · 30hTempoh pratetap, dinilai berdasarkan published_at.
from / toTarikh ISOTingkap eksplisit apabila pratetap tidak sesuai.
strict_countrybenar/salahHanya kira artikel yang negaranya merupakan fakta tegar dan bukan sekadar inferens.

Kawalan output

ParameterNilaiKesan
sorttarikh · tarikh_asc · crawled · crawled_asc · relevansiUrutkan mengikut crawled semasa mengimbas artikel baharu — penerbit akan menunda masa penerbitan; masa imbasan hanya bergerak ke hadapan.
size1–100Keputusan setiap halaman.
offset0–9900Anjak halaman.
full_textbenar/salahMemuatkan kandungan artikel. Tidak diaktifkan secara lalai.
highlightbenar/salahPulangkan petikan yang sepadan.
fieldsCSVPotong 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

NegaraArtikel
India2,286,014
Amerika Syarikat2,180,797
Turki1,499,897
Rusia1,436,556
Itali1,057,479
Argentina826,947
Sepanyol812,347
Ukraine662,041
Brazil551,013
Jerman543,132
Perancis502,846
Greece460,372
Jepun437,209
Vietnam408,934
Mexico402,320
Korea Selatan362,945
Romania354,229
United Kingdom334,379
Iran291,782
Poland255,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:

KelasInstrumenGranularitiSumber
KriptoBitcoin, Ethereum, Solana, XRP, BNB, DogecoinjamBinance
LogamEmas (USD/oz)jamBinance
FXEUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLNhariECB
TenagaHarga kuasa Jerman (EUR/MWh)jamEnergy-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 AkhirData
/v1/btc/summaryHarga terkini, pergerakan semasa, dan nada liputan berita hari ini.
/v1/btc/priceCandlestick BTC/USDT mengikut selang masa.
/v1/btc/sentimentNada berita mengikut tempoh masa.
/v1/btc/seriesHarga dan nada diselaraskan dalam satu garis masa.
/v1/btc/correlationKorelasi antara nada dan pergerakan harga mengikut pergeseran masa — adakah liputan mendahului pergerakan harga, atau mengikutinya?
/v1/btc/newsArtikel kripto bersama label sentimennya, boleh ditapis mengikut label, hos, bahasa dan kata kunci carian.
/v1/btc/sourcesOutlet 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:

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

Ini 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/mcp

Ia mendedahkan 28 alat dalam dua lapisan yang disengajakan.

Lapisan satu: enam pintasan yang menjawab keseluruhan soalan dalam satu panggilan

AlatUntuk
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_keywordsPerkataan yang menjadi asas berita pada masa ini, termasuk bilangan cerita dan penyebaran mengikut negara.
find_publishersCari penerbit: nama, domain, negara, bahasa, bilangan artikel sehari.
list_countriesNegara mana yang mempunyai cerita langsung, berapa banyak, dan seberapa terkini.
market_vs_newsSiri 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:

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:

MedanRantaianLiputan
descriptionJSON-LD → meta → OpenGraph → kad Twitter → articleBody → perenggan pendahuluan98.1%
language<html lang> → JSON-LD inLanguage → og:locale99.9%
countryccTLD → JSON-LD addressCountry → bahasa-wilayah → og:locale79.1%
dateJSON-LD datePublished → meta → trafilatura → masa lepan100%

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.

Penggunaan Berkesan: Kos, Penimbalan Halaman dan Ralat

Disiplin token

Untuk agen, saiz respons adalah kos sebenar. Bentuk yang didokumentasikan:

PanggilanKos token anggaranBila
/v1/stats~200Pertama. Putuskan sama ada carian ini bernilai untuk dijalankan.
/v1/search hanya metadatabeberapa ribu setiap halamanImbas dan pilih.
/v1/search?full_text=true~900 setiap artikelHanya 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-4o

Kunci 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:

Pakej percuma di tempat lain

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
Free News API

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
Liputan di tempat lain

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
Liputan di sini

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 event

Dasarkan 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=50

Cari 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 slice

Versi 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.