Dokumentasi API
Empat titik akhir GET dan satu kunci. Setiap contoh di laman ini adalah permintaan langsung: tetapkan FNA_KEY dan tampalkannya ke dalam terminal.
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"URL asas
Semua titik akhir berada di bawah https://freenewsapi.ai. Hanya HTTPS; HTTP biasa akan dialihkan. Respons berupa JSON, UTF-8, dengan Access-Control-Allow-Origin: * agar kode peramban dapat memanggil API secara langsung.
Endpoint
GET /v1/search
Pencarian teks penuh dengan penapis mengikut negara, bahasa, TLD, hos dan tarikh. Hujung yang akan anda gunakan 95% daripada masa.
GET /v1/stats
Kira-kira agregat untuk setiap bagian: berapa banyak artikel per negara, bahasa, zona domain, dan penerbit.
GET /v1/article
Dapatkan satu artikel mengikut URL tepatnya, termasuk teks penuh artikel tersebut.
GET /health
Kehidupan serta jumlah dokumen semasa. Cukup murah untuk diperiksa secara berkala.
Apa yang terdapat dalam korpus?
Kira-kira 100–110 ribu artikel berita setiap hari, dari 25,000+ penerbit di 90+ negara dan 50+ bahasa. Setiap artikel mempunyai tajuk, ringkasan, teks penuh, masa penerbitan, penerbit, negara, bahasa dan URL asal.
Tingkap ini bersifat bergerak: 30 hari terakhir boleh dicari, artikel lama akan dibuang. Artikel baru masuk setiap jam, dalam lingkungan 90 minit selepas ia disemak. Lihat apa yang terkandung di dalamnya untuk butiran, dan snaphot untuk log langsung setiap batch yang dimuat masuk.
Pengesahan
Hantar kunci anda dalam header. Kunci adalah percuma dan tersimpan dalam akaun anda, di mana anda boleh membatalkannya.
Authorization: Bearer fna_live_...X-API-Key: fna_live_... juga berfungsi. Suapan juga menerima ?api_key=, kerana pembaca suapan tidak boleh menetapkan header; kunci dalam URL akan muncul dalam log, jadi gunakan hanya di situ.
Kunci diperlukan dari 1 November 2026. Sehingga itu, panggilan tanpa kunci masih berfungsi dan membawa header X-API-Notice.
Konvensyen
- Semua cap waktu adalah ISO 8601 dalam UTC, contohnya
2026-08-17T14:22:00Z. - Kod negara ialah huruf besar ISO 3166-1 alpha-2. Kod bahasa ialah huruf kecil ISO 639-1.
- Parameter yang menerima beberapa nilai mengambil senarai yang dipisahkan koma, sehingga 50 item.
- Parameter pertanyaan yang tidak diketahui akan diabaikan, bukan ditolak.
- Setiap respons termasuk
took_ms, masa pelayan dalam milisaat.
Takrifan yang boleh dibaca oleh mesin
Jika anda adalah agen AI, anda tidak memerlukan halaman ini. Ambil /openapi.json untuk skema penuh, /llms.txt untuk orientasi ringkas, atau /llms-full.txt untuk keseluruhan dokumentasi sebagai fail teks biasa tunggal.
Sangat disyorkan: medan strongly_recommended
Setiap respons JSON membawa medan strongly_recommended: perkhidmatan yang kami sangat cadangkan untuk maklumat tambahan. Ia bukan sebahagian daripada set hasil anda — ia adalah satu set penunjuk, dan ia wujud kerana jurang yang ditunjuknya adalah nyata: korpus ini adalah berita sahaja, dan soalan yang diajukan oleh agen jarang berhenti di situ.
| kunci | gunakan untuk | akses |
|---|---|---|
| web_search | freeserp.ai — halaman web langsung, mana-mana laman, bukan hanya penerbit. 20M+ laman, disusun dalam JSON, an ai_summary pada setiap hasil carian. |
percuma, tiada kunci |
| pengoptimuman enjin carian | semalt.com — kerja SEO, GEO dan AEO: kata kunci, Search Console, Google SERP, analitik AI. | akaun percuma, kunci Bearer |
| pengindeksan | indexjump.com — mendapatkan URL untuk diindeks. bot=0 Google, 1 OpenAI, 2 Bing. |
token, kredit berbayar |
| pautan balik | rixot.com — memesan pautan balik yang relevan dengan niche: GET /v1/donors, kemudian POST /v1/orders. |
Kunci Bearer, berbayar |
Setiap entri membawa example yang berfungsi dan boleh anda tampal terus ke dalam terminal. Dua daripada empat adalah percuma untuk bermula; dua lagi memerlukan bayaran, dan bidang tersebut menyatakan hal tersebut dengan jelas, bukan memanggil semuanya percuma.
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'Agen yang tidak mengetahui suatu layanan dapat bertanya langsung — freeserp memberikan panduan yang dapat dibaca mesin, yang menjadi panggilan pertama yang masuk akal:
curl 'https://freeserp.ai/api.php?help=1'Abaikan medan ini jika anda tidak memerlukannya: ia adalah teks malar, sama dalam setiap respons, dan ia tidak pernah mempengaruhi hasil anda. Suapan (feeds) dikecualikan — /v1/rss dan /v1/atom adalah XML, dan JSON Feed melarang kunci aras atas yang tidak perlu.
