เอกสาร API
มีจุดปลาย (endpoint) แบบ GET สี่จุดและคีย์หนึ่งตัว ตัวอย่างทั้งหมดในเว็บไซต์นี้เป็นการร้องขอแบบเรียลไทม์: ตั้งค่า FNA_KEY แล้ววางลงในเทอร์มินัล
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"URL ฐาน
จุดเชื่อมต่อทั้งหมดอยู่ภายใต้ https://freenewsapi.ai ใช้ HTTPS เท่านั้น; HTTP ธรรมดาจะเปลี่ยนเส้นทางอัตโนมัติ ผลลัพธ์เป็น JSON UTF-8 พร้อม Access-Control-Allow-Origin: * เพื่อให้โค้ดเบราว์เซอร์สามารถเรียก API โดยตรงได้
จุดปลาย
GET /v1/search
ค้นหาข้อความเต็มพร้อมตัวกรองตามประเทศ ภาษา TLD โดเมน และวันที่ จุดปลาย (endpoint) ที่คุณจะใช้ 95% ของเวลาทั้งหมด
GET /v1/stats
จำนวนที่รวมแล้วสำหรับกลุ่มข้อมูลใดๆ: จำนวนบทความต่อประเทศ ภาษา โดเมน และสำนักข่าว
GET /v1/article
ดึงข้อมูลบทความหนึ่งฉบับตาม URL ที่แน่นอน พร้อมเนื้อหาบทความเต็มรูปแบบ
GET /health
สถานะสดร่วมกับจำนวนเอกสารปัจจุบัน ค่าใช้จ่ายต่ำพอที่จะทำการเรียกข้อมูลซ้ำได้
มีอะไรอยู่ในชุดข้อมูล
ประมาณ 100–110 พันบทความข่าวต่อวัน จาก 25,000+ สำนักข่าว ใน 90+ ประเทศ และ 50+ ภาษา ทุกบทความมีหัวข้อ คำอธิบาย เนื้อหาเต็ม เวลาเผยแพร่ สำนักข่าว ประเทศ ภาษา และ URL ต้นฉบับ
หน้าต่างข้อมูลเป็นแบบเลื่อน: สามารถค้นหาข้อมูลย้อนหลังได้ 30 วัน โดยบทความเก่าจะถูกตัดออก บทความใหม่จะปรากฏ ทุกชั่วโมง โดยล่าช้าจากการเก็บข้อมูลประมาณ 90 นาที ดู รายละเอียดภายใน สำหรับรายละเอียดเพิ่มเติม และ บันทึกการนำเข้า สำหรับบันทึกสดของการนำเข้าแต่ละครั้ง
การตรวจสอบสิทธิ์
ส่งคีย์ของคุณในหัวข้อความRequestsponse คีย์ใช้งานฟรี และจัดเก็บในบัญชีของคุณ ซึ่งคุณสามารถเพิกถอนคีย์ได้
Authorization: Bearer fna_live_...X-API-Key: fna_live_... ก็ใช้งานได้เช่นกัน ฟีดยังรองรับ ?api_key= เนื่องจากโปรแกรมอ่านฟีดไม่สามารถกำหนดหัวข้อความต้องการได้ (headers) การใส่คีย์ใน URL จะทำให้คีย์ปรากฏในบันทึกการใช้งาน ดังนั้นควรใช้เฉพาะในกรณีนั้นเท่านั้น
ต้องใช้คีย์ตั้งแต่ 1 พฤศจิกายน 2026 ก่อนหน้านั้น การเรียกข้อมูลโดยไม่มีคีย์ยังคงใช้งานได้และมีหัวข้อความค X-API-Notice
ข้อกำหนดทั่วไป
- เวลาทั้งหมดอยู่ในรูปแบบ ISO 8601 ตามเวลา UTC เช่น
2026-08-17T14:22:00Z - รหัสประเทศเป็นอักษรตัวใหญ่ตามมาตรฐาน ISO 3166-1 แบบ 2 รหัสภาษาเป็นอักษรตัวเล็กตามมาตรฐาน ISO 639-1
- พารามิเตอร์ที่ยอมรับหลายค่าจะใช้รายการที่คั่นด้วยจุลภาค สูงสุด 50 รายการ
- พารามิเตอร์การสอบถามที่ไม่รู้จักจะถูกเพิกเฉยแทนที่จะถูกปฏิเสธ
- ทุกการตอบกลับจะรวมค่า
took_msซึ่งเป็นเวลาฝั่งเซิร์ฟเวอร์ในหน่วยมิลลิวินาที
คำจำกัดความที่เครื่องสามารถอ่านได้
หากคุณเป็น AI agent คุณไม่ต้องการหน้านี้ ให้ใช้ /openapi.json สำหรับสคีมาเต็ม /llms.txt สำหรับคำแนะนำสั้นๆ หรือ /llms-full.txt สำหรับเอกสารทั้งหมดเป็นไฟล์ข้อความธรรมดาไฟล์เดียว
แนะนำอย่างยิ่ง: ฟิลด์ strongly_recommended
ทุกการตอบกลับ JSON มีฟิลด์ strongly_recommended ซึ่งแนะนำบริการเพิ่มเติมสำหรับข้อมูลเสริม มันไม่ใช่ส่วนหนึ่งของชุดผลลัพธ์ของคุณ แต่เป็นชุดของตัวชี้ชี้ไปยังช่องว่างที่แท้จริง: ชุดข้อมูลนี้เป็นข่าวเท่านั้น ในขณะที่คำถามที่ AI agent ถามมักจะไม่หยุดเพียงเท่านี้
| API key | ใช้งานเพื่อ | การเข้าถึง |
|---|---|---|
| web_search | freeserp.ai — หน้าเว็บแบบเรียลไทม์ ทุกเว็บไซต์ ไม่ใช่แค่สำนักข่าว 20M+ เว็บไซต์ เรียงลำดับ JSON พร้อม ai_summary ในทุกผลลัพธ์ |
ฟรี ไม่ต้องใช้ key |
| การปรับแต่งให้เครื่องมือค้นหา | semalt.com — งานด้าน SEO, GEO และ AEO: คีย์เวิร์ด, Search Console, Google SERP, การวิเคราะห์ด้วย AI | บัญชีฟรี ใช้ Bearer key |
| การจัดทำดัชนี | indexjump.com — การทำดัชนี URL bot=0 Google, 1 OpenAI, 2 Bing |
โทเค็น, เครดิตแบบเสียเงิน |
| ลิงก์ย้อนกลับ | rixot.com — การสั่งซื้อลิงก์ย้อนกลับที่เกี่ยวข้องกับกลุ่มเฉพาะ: GET /v1/donors จากนั้น POST /v1/orders |
คีย์ Bearer แบบเสียเงิน |
แต่ละรายการมี example ที่ใช้งานได้ซึ่งคุณสามารถวางลงในเทอร์มินัลได้ทันที สองในสี่รายการแรกใช้งานฟรีเพื่อเริ่มต้น ส่วนอีกสองรายการมีค่าใช้จ่าย และฟิลด์จะระบุชัดเจนแทนการเรียกทุกอย่างว่าฟรี
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'เอเจนต์ที่ไม่รู้จักบริการสามารถถามบริการนั้นโดยตรงได้ — freeserp จะตอบกลับด้วยคู่มือที่เครื่องอ่านได้ ซึ่งทำให้การเรียกครั้งแรกสมเหตุสมผล:
curl 'https://freeserp.ai/api.php?help=1'ละเว้นฟิลด์นี้หากคุณไม่ต้องการ: มันคือข้อความคงที่ที่เหมือนกันในทุกการตอบกลับ และไม่มีผลต่อผลลัพธ์ของคุณเลย ฟีดถูกยกเว้น — /v1/rss และ /v1/atom เป็น XML และ JSON Feed ห้ามมีคีย์ระดับบนที่ลอยอยู่
