Free News API: การค้นหาข้อความเต็มรูปแบบจากบทความ 21 ล้านฉบับ ผู้จัดพิมพ์ 25,000 ราย และ 100 ประเทศ — โดยไม่ต้องใช้คีย์เลย

บริการข่าว API ส่วนใหญ่จะขายตามจำนวนคำขอ ต้องใช้คีย์ และจำกัดจำนวนเพียงร้อยคำขอต่อวันในแผนฟรี Free News API ไม่ใช่แบบนั้น: บทความ 21.5 ล้านฉบับในช่วงเวลา 90 วันที่หมุนวน ผู้จัดพิมพ์กว่า 25,000 ราย ไม่มีคีย์ ไม่ต้องสมัครใช้งาน ไม่มีโควตา อนุญาตให้ใช้เชิงพาณิชย์ นี่คือฟีเจอร์ทั้งหมด — การค้นหา สถิติ แนวโน้ม ตลาด ฟีด และ MCP — พร้อมคำอธิบายอย่างตรงไปตรงมาว่าข้อมูลเหล่านี้คลาดเคลื่อนอย่างไร

ลักษณะของปัญหา

เมื่อถามเอเจนต์ AI ว่าโลกกำลังเขียนเกี่ยวกับเรื่องใดอยู่ตอนนี้ มันจะมีตัวเลือกที่ไม่ดีสามทาง มันสามารถสแครปข้อมูลจากผู้จัดพิมพ์โดยตรง ซึ่งมีความเปราะบาง ช้า และคลุมเครือทางกฎหมาย มันสามารถเรียกใช้ API ข่าวเชิงพาณิชย์ ซึ่งหมายถึงการมีบัญชี คีย์ บิลรายเดือน และ — ในแผนฟรีทุกแผนในตลาด — จำกัดเพียงร้อยคำขอต่อวัน และบทความอาจล่าช้าไป 24 ชั่วโมง หรือมันสามารถคาดเดาจากข้อมูลการฝึกที่หยุดอัปเดตไปหลายเดือนแล้ว

Free News API ขจัดราคาและเอกสาร paperwork ของตัวเลือกกลางออก โดยไม่ลดทอนความสามารถลง การเรียกใช้ GET เพียงครั้งเดียว ไม่ต้องใช้ข้อมูลรับรอง กับชุดข้อมูลที่มี 21,557,044 บทความ จากผู้จัดพิมพ์มากกว่า 25,000 ราย ในช่วงเวลา 90 วันที่หมุนวนและอัปเดตอย่างต่อเนื่อง — บทความที่ใหม่ที่สุดในดัชนีมักจะมีอายุต่ำกว่าสองนาที

จุดปลายหลัก 4 จุด และอื่นๆ อีกมาก

แกนกลางของบริการคือจุดปลาย (endpoints) 4 จุดของ GET ทั้งหมดอยู่ภายใต้ https://freenewsapi.ai ทั้งหมดส่งคืนข้อมูล JSON แบบ UTF-8 พร้อมหัวข้อความต้องการ Access-Control-Allow-Origin: * เพื่อให้โค้ดเบราว์เซอร์สามารถเรียกใช้โดยตรงได้ และทั้งหมดรายงานเวลาฝั่งเซิร์ฟเวอร์ในฟิลด์ took_ms

ล้อมรอบแกนกลางนี้คืออีกสี่กลุ่ม ซึ่งแต่ละกลุ่มสามารถเป็นผลิตภัณฑ์แยกต่างหากได้ในที่อื่น: trends (การจัดกลุ่มเรื่องราวแบบเรียลไทม์ตามประเทศ), markets (อนุกรมราคาที่จัดเรียงตามปริมาณการรายงานข่าว), crypto sentiment (บล็อก Bitcoin แบบเจ็ดจุดปลายทาง) และ syndication (การค้นหาเดียวกันที่แสดงผลเป็น RSS, Atom หรือ JSON Feed) ทั้งหมดนี้มีรายละเอียดครอบคลุมด้านล่าง

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"
    }
  ]
}

สามฟิลด์ในคำตอบนั้นสมควรได้รับความสนใจทันที เนื่องจากข้อมูลเหล่านี้บ่งบอกถึงความซื่อสัตย์ของชุดข้อมูลทั้งหมด total_is_lower_bound จะบอกคุณเมื่อจำนวนที่ตรงกันถึงขีดจำกัดสูงสุดที่ 10,000 และหยุดนับ country_source บอกคุณว่า วิธีการ กำหนดประเทศเป็นอย่างไร — เพราะในชุดข้อมูลข่าวใดๆ ส่วนสำคัญของค่าประเทศเป็นเพียงการอนุมาน ไม่ใช่ข้อเท็จจริง และ crawled_at คือข้อมูลเวลาที่เชื่อถือได้: ผู้เผยแพร่มักระบุวันที่เผยแพร่ย้อนหลังใน published_at แต่เวลาการ crawl จะถูกกำหนดโดยระบบท่อส่งข้อมูล (pipeline) และจะเคลื่อนไปข้างหน้าเท่านั้น

การค้นหา: พารามิเตอร์ทุกตัวที่มีความสำคัญ

พารามิเตอร์ทั้งหมดเป็นตัวเลือกได้ การเรียกแบบเปล่าจะส่งคืนบทความล่าสุดในดัชนี

คำค้นหา

• q ตรงกันกับชื่อเรื่อง (น้ำหนัก 3), คำอธิบาย (น้ำหนัก 2) และเนื้อหาบทความ ใช้ ตรรกะ AND — ทุกคำต้องมีอยู่ ดังนั้นการเพิ่มคำจะลดขอบเขตลง ไม่ใช่ขยาย ขยายสูงสุด 500 ตัวอักษร

ตัวกรอง

ตัวกรองรวมกับ AND ระหว่างพารามิเตอร์ และ OR ภายในพารามิเตอร์เดียวกัน ดังนั้น country=DE,AT&lang=de อ่านว่า "บทความภาษาเยอรมันจากเยอรมนีหรือออสเตรีย" แต่ละตัวกรองรับรายการค่าที่คั่นด้วยจุลภาคได้สูงสุดห้าสิบค่า

การควบคุมผลลัพธ์

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"

การนับจำนวนก่อนเริ่มค้นหา

เอนด์พอยต์ที่ใช้งานน้อยที่สุดในบริการนี้คือ /v1/stats บ่อยครั้งที่คำถามที่สำคัญไม่ใช่ "บทความมีอะไรบ้าง" แต่เป็น "มีข้อมูลอยู่จริงหรือไม่ และอยู่ที่ไหน" การนับจำนวนคำตอบใช้ต้นทุนเพียงเศษเสี้ยว — ประมาณสองร้อยโทเค็น เทียบกับหลายพันโทเค็นสำหรับการดึงหน้าผลลัพธ์หนึ่งหน้า — ทำให้เป็นคำสั่งแรกที่เหมาะสมสำหรับเอเจนต์ที่จะตัดสินใจว่าการค้นหาครั้งนั้นคุ้มค่าที่จะดำเนินการหรือไม่

curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"

ฟังก์ชันนี้จะส่งคืนจำนวนตามประเทศ ภาษา TLD ผู้เผยแพร่ และวันที่ โดยคำนวณจากชุดข้อมูลที่ตรงกันทั้งหมด ไม่ใช่แค่หน้าปัจจุบัน ซึ่งวิธีนี้ยังใช้วัดความครอบคลุมของข้อมูลก่อนที่จะเชื่อถือผลลัพธ์ได้อีกด้วย ตัวอย่างข้อมูลแบบไม่กรอง ณ เวลาที่เขียนบทความ:

ประเทศชั้นนำ

ภาษาหลัก

อังกฤษ 5,513,650 · สเปน 2,699,457 · รัสเซีย 1,785,796 · ตุรกี 1,501,004 · อิตาลี 992,200 · เยอรมัน 733,677 · ฝรั่งเศส 689,136 · อาหรับ 664,016 · โปรตุเกส 637,607 · ฮินดี 560,840 · กรีก 466,504 · ญี่ปุ่น 427,085 · เวียดนาม 385,719 · โรมาเนีย 358,766 · จีน 352,720 · ยูเครน 345,809 · เกาหลี 335,079 · เปอร์เซีย 268,126 · โปแลนด์ 238,904 · บัลแกเรีย 183,204

การกระจายตัวนี้คุ้มค่าแก่การพิจารณาสักครู่ เพราะมันตรงข้ามกับสิ่งที่ API ข่าวส่วนใหญ่ให้คุณ โดยทั่วไปแล้วคลังข้อมูลภาษาอังกฤษเป็นอันดับหนึ่งและสหรัฐอเมริกาเป็นอันดับหนึ่งไม่ใช่สิ่งที่เป็นแบบนี้: อินเดียมีอันดับสูงกว่าสหรัฐอเมริกา ตุรกีมีอันดับสูงกว่าเยอรมัน และกรีก เวียดนาม เปอร์เซีย และบัลแกเรียต่างก็มีตัวแทนระดับหกหลัก หากคุณถามเกี่ยวกับสื่อที่ไม่ใช่ภาษาอังกฤษ นี่คือชุดข้อมูลที่แตกต่างกันอย่างมาก

ปริมาณ

เส้นโค้งรายวันใน by_day ครอบคลุมหน้าต่างเก้าสิบวันเต็ม วันล่าสุดอยู่ในช่วงประมาณ 400,000 ถึง 700,000 บทความต่อวัน ในช่วงแรกๆ ของหน้าต่าง ก่อนที่ชั้น RSS จะถูกเพิ่มพร้อมกับกระบวนการนำเข้าคลังข้อมูล ปริมาณรายวันอยู่ที่ 130,000–230,000 ทั้งสองตัวเลขปรากฏในการตอบกลับเดียวกัน ซึ่งเป็นจุดประสงค์ — บริการนี้จะแสดงการเพิ่มขึ้นของตนเองให้คุณดู แทนที่จะอ้างอิงค่าเฉลี่ยทางการตลาด

แนวโน้ม: สื่อกำลังครอบคลุมอะไรอยู่จริงๆ ในขณะนี้

การค้นหาตอบคำถาม "มีใครเขียนเกี่ยวกับ X อย่างไร" แนวโน้มตอบคำถามที่แตกต่างกันและมักดีกว่า: "เกิดอะไรขึ้น" — โดยไม่จำเป็นต้องมี X

หุ่นยนต์จัดกลุ่มบทความเป็นเรื่องราวตามประเทศและอัปเดตอย่างต่อเนื่อง ทุกๆ ห้านาที บทความใหม่จะถูกแนบเข้ากับเรื่องราวที่รู้จักผ่านคำระบุตัวตน โดยไม่ต้องเรียกใช้โมเดลเลย ทุกๆ beberapa ชั่วโมง ประเทศหนึ่งจะผ่านการตรวจสอบแบบเต็มรูปแบบที่โมเดลภาษาอ่านหัวข้อข่าวและตั้งชื่อเรื่องราวใหม่ทั้งหมด ณ เวลาที่เขียน ชั้นแนวโน้มครอบคลุม 115 ประเทศ ซึ่งแต่ละประเทศได้รับการคำนวณใหม่ภายในไม่กี่นาทีที่ผ่านมา

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": [ … ]
    }
  ]
}

เรื่องราวแต่ละเรื่องมาพร้อมกับสองจำนวนและความหมายต่างกัน articles คือความดัง; publishers คือความกว้าง เรื่องราวที่มี 200 บทความจาก 4 สำนักพิมพ์เป็นเพียงความหลงใหลของห้องข่าวแห่งเดียว เรื่องราวที่มี 60 บทความจาก 40 สำนักพิมพ์คือเหตุการณ์ การเรียงลำดับเริ่มต้นคือตามจำนวนผู้เผยแพร่ และ min_publishers / min_articles ช่วยให้คุณกำหนดเกณฑ์เองได้

เรื่องราวแต่ละเรื่องถูกจัดหมวดหมู่จากชุดหมวดหมู่ที่กำหนดไว้: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society

ช่วงเวลาการแสดงผลเป็นสิทธิ์ของผู้ใช้ ไม่ใช่ของหุ่นยนต์

นี่คือการตัดสินใจด้านการออกแบบที่ประณีตอย่างแท้จริง บทความทุกเรื่องจะถูกจัดเก็บพร้อมเวลาเผยแพร่และเชื่อมโยงกับเรื่องราวที่เกี่ยวข้อง ดังนั้นช่วงระยะเวลาใดๆ — ยี่สิบห้านาที ชั่วโมงหนึ่งวัน หรือวันที่เฉพาะเจาะจงบนปฏิทิน — ก็เพียงแค่เป็นการค้นหาแบบช่วง (range query) บนข้อมูลที่จัดเก็บไว้ชุดเดียวกัน การคำนวณเพียงครั้งเดียวก็ตอบโจทย์ทุกช่วงเวลาได้พร้อมกัน window=15m, window=1h, window=24h, date=2026-09-01 หรือการระบุคู่ since/until ล้วนทำงานบนดัชนีเดียวกันได้โดยไม่จำเป็นต้องคำนวณซ้ำ

คำสำคัญ: คำศัพท์ที่เป็นรากฐานของข่าวสาร

curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"

แต่ละคำสำคัญจะแสดงจำนวนเรื่องราวที่แตกต่างกันที่ใช้คำนี้ จำนวนบทความในเรื่องราวเหล่านั้น และ — ซึ่งน่าสนใจเป็นพิเศษ — จำนวนสำนักข่าวระดับชาติที่ใช้คำนี้ ตัวเลขสุดท้ายนี้คือตัวแยกแยะระหว่างเหตุการณ์ระดับโลกและเหตุการณ์ภายในประเทศ คำที่ปรากฏใน seventy ประเทศถือเป็นเรื่องราวระดับโลก ในขณะที่คำที่ครองพื้นที่สื่อในประเทศใดประเทศหนึ่งถือเป็นเรื่องราวภายในประเทศ แม้ว่าจะมีเสียงดังเพียงใดก็ตาม

ประเทศใดบ้างที่กำลังรายงานสด

curl "https://freenewsapi.ai/v1/trends/countries"

ระบบจะคืนข้อมูลประเทศทั้งหมดที่ถูกติดตาม พร้อมจำนวนเรื่องราวสดและระยะเวลาที่เพิ่งทำการคำนวณใหม่ — ตุรกี รัสเซีย อิหร่าน กรีซ อินเดีย อิตาลี ยูเครน โรมาเนีย อาร์เจนตินา เยอรมนี และบราซิล ต่างมีเรื่องราวสดนับพันเรื่องในแต่ละประเทศ ซึ่งได้รับการคำนวณใหม่ภายในสิบนาทีที่ผ่านมา นอกจากนี้ /v1/trends/{cc}/{slug} ยังเปิดโอกาสให้เข้าถึงเรื่องราวใดเรื่องราวหนึ่งพร้อมรายการบทความฉบับเต็ม

ตลาดเทียบกับความครอบคลุม: ราคาบนแกนหนึ่ง ความสนใจบนอีกแกนหนึ่ง

นี่คือสิ่งที่แปลกใหม่ที่สุดของบริการ และมันเกิดขึ้นได้เพราะชุดข้อมูลทำให้การสร้างฟีเจอร์นี้มีต้นทุนต่ำมาก นำชุดข้อมูลราคาไปวางเคียงข้างกับปริมาณการเขียนข่าวเกี่ยวกับสิ่งนั้นๆ ในช่วงเวลาเดียวกัน บนเส้นเวลาเดียวกัน

curl "https://freenewsapi.ai/v1/markets"

มีการติดตามเครื่องมือทางการเงินจำนวนสิบสี่ชิ้น ครอบคลุมสี่กลุ่มสินทรัพย์:

curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"

การเรียกข้อมูลเพียงครั้งเดียวนี้ให้คุณเห็นอัตราแลกเปลี่ยนลีราตุรกีเทียบกับดอลลาร์ และปริมาณการรายงานข่าวจากสื่อตุรกีในช่วงเวลาเดียวกัน โดยจัดเรียงตามชั่วโมงต่อชั่วโมง สื่อตุรกีเป็นองค์ประกอบที่ใหญ่เป็นอันดับสามของชุดข้อมูลนี้ ซึ่ง正是เหตุผลที่การจับคู่ข้อมูลนี้ให้ผลลัพธ์ที่มีความหมาย มิใช่เพียงข้อมูลรบกวน

และบล็อกความรู้สึกต่อ Bitcoin แบบครบถ้วน

Bitcoin มีครอบครัวของเอนด์พอยต์เป็นของตัวเองจำนวน 7 จุด เนื่องจากเป็นสินทรัพย์เดียวที่มีการถกเถียงกันอย่างต่อเนื่องเกี่ยวกับความสัมพันธ์ระหว่างโทนข่าวและการเคลื่อนไหวของราคา แต่กลับมีข้อมูลวัดผลน้อยมาก:

ป้ายความ.sentiment มาจากโมเดลภาษาที่ประมวลผลบทความคริปโตล่าสุดทุก ๆ ห้านาที โดยเทียบกับรายการเหรียญที่ผ่านการปรับเทียบแล้ว /v1/btc/correlation พร้อมพารามิเตอร์ max_shift คือจุดเริ่มต้นหากคุณเคยต้องการทดสอบข้ออ้างที่ว่า "ข่าวทำให้เกิดการเคลื่อนไหว" แทนที่จะยอมรับว่าเป็นเรื่องจริง

การค้นหาแบบเดียวกัน ในรูปแบบฟีด

เอนด์พอยต์อีกสามตัวรับพารามิเตอร์การค้นหาแบบเดียวกันและแสดงผลในรูปแบบ syndication แทนที่จะเป็น JSON:

• GET /v1/rss — RSS 2.0
• GET /v1/atom — Atom 1.0
• GET /v1/feed.json — JSON Feed 1.1

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

นั่นหมายความว่า การค้นหาที่บันทึกไว้ทุกการค้นหาจะกลายเป็นฟีดที่คุณสามารถวางลงในโปรแกรมอ่านฟีด โหนด n8n การผสานรวม Slack ตัวกระตุ้น Zapier หรือเครื่องสร้างเว็บไซต์แบบสแตติก — โดยไม่ต้องเขียนโค้ดและไม่ต้องใช้คีย์ เป็นฟีเจอร์เล็กๆ ที่ช่วยตัดชั้นการผสานรวมออกได้อย่างเงียบเชียบสำหรับผู้ที่ไม่ใช่โปรแกรมเมอร์

MCP: เครื่องมือยี่สิบแปดชิ้น สองชั้น

เซิร์ฟเวอร์ MCP ทำงานอยู่ที่ URL เดียว รองรับ Streamable HTTP (JSON-RPC 2.0 ผ่าน POST เวอร์ชันโปรโตคอล 2025-06-18) รองรับการส่งคำสั่งแบบรวมกลุ่ม และ — เหมือนทุกสิ่งในที่นี้ — ไม่มีขั้นตอนการตรวจสอบสิทธิ์และไม่มี session id

claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcp

มันเปิดเผย เครื่องมือ 28 ชิ้นในสองชั้นที่ออกแบบมาอย่างตั้งใจ

ชั้นที่หนึ่ง: ทางลัดหกทางที่ตอบคำถามครบถ้วนในหนึ่งคำสั่ง

ชั้นที่สอง: ทุกเอนด์พอยต์ ซึ่งสร้างขึ้นจากบริการเอง

ภายใต้ทางลัดเหล่านั้น ทุกเอนด์พอยต์แบบดิบจะถูกเปิดเผยเป็นเครื่องมือของตัวเอง โดยรองรับพารามิเตอร์ทุกตัวที่ API ยอมรับ ได้แก่ news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, กลุ่ม news_get_btc_* ทั้งหมด, ตัวเรนเดอร์ฟีด และ news_get_health สิ่งเหล่านี้ถูกสร้างขึ้นจากบริการแบบเรียลไทม์ จึงไม่คลาดเคลื่อนจากสิ่งที่ API ยอมรับจริง ๆ

เครื่องมือเมตาสองตัวช่วยปิดวงจร: news_list_endpoints จะคืนแคตตาล็อกของสิ่งที่มีอยู่ทั้งหมด และ news_get จะทำการ GET แบบดิบกับเส้นทางใด ๆ — ดังนั้นเอเจนต์ที่พบเอนด์พอยต์ซึ่งรายการเครื่องมือของพวกมันไม่ได้ครอบคลุมไว้ ก็ยังสามารถเข้าถึงได้

curl "https://freenewsapi.ai/mcp?format=json"

GET เพียงครั้งเดียว ไม่ต้องมีการจับมือเชื่อมต่อ และคุณจะได้แคตตาล็อกที่เครื่องอ่านได้ทั้งหมด: เซิร์ฟเวอร์, โปรโตคอลการขนส่ง, โปรโตคอล, จำนวนเครื่องมือ, รายละเอียดของเครื่องมือทุกตัว และรายการพารามิเตอร์ของเอนด์พอยต์ทุกจุด

สร้างมาเพื่อให้อ่านโดยเครื่องจักร

เอกสารประกอบไม่ใช่สิ่งที่ต่อเติมภายหลังเข้ากับ API — แต่เป็นผลลัพธ์ระดับแรกที่เกิดจากบริการนี้โดยตรง เว็บไซต์จัดส่งหน้าเว็บคงที่จำนวน 665 หน้า และหลายหน้ามีอยู่โดยเฉพาะเพื่อให้โมเดลไม่ต้องอ่าน HTML:

• /openapi.json สคีม่า OpenAPI แบบเต็ม
• /llms.txt ไฟล์แนะนำแบบสั้น — ระบุบริการ จุดปลาย (endpoints) วิธีส่งคำขออย่างมีประสิทธิภาพ และข้อผิดพลาดที่อาจเกิดขึ้น
• /llms-full.txt เอกสารทั้งหมดรวมอยู่ในไฟล์ข้อความธรรมดาเพียงไฟล์เดียว มีขนาดเกินร้อยกิโลไบต์ เพื่อให้เอเจนต์สามารถดึงข้อมูลคู่มือทั้งหมดมาประมวลผลได้ในครั้งเดียว
• /agents สามสิบเก้าหน้าที่ออกแบบมาเพื่อผู้สร้างเอเจนต์โดยเฉพาะ: รวมถึงคำจำกัดความฟังก์ชัน OpenAI แบบพร้อมใช้ คำจำกัดความการใช้เครื่องมือของ Anthropic คำสั่งระบบสำหรับการดึงข้อมูลข่าว สูตร RAG ตารางต้นทุนโทเค็น และสูตรการสร้างเอเจนต์
• /agents/models โค้ดการเรียกใช้เครื่องมือแยกตามตระกูลโมเดล — 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 ข้อมูลภายในชุดข้อมูล วิธีการทำงาน สคีม่าของดัชนี และหน้า Data quality ที่บันทึกข้อมูลข้อผิดพลาดของชุดข้อมูลนี้
• /sources แคตตาล็อกที่สามารถเรียกดูได้ ประกอบด้วยสำนักพิมพ์ 11,668 แห่ง ซึ่งสามารถกรองตามประเทศ ภาษา และโดเมนได้
• /compare หน้าเปรียบเทียบแบบเคียงข้างกับ NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube และ FreeNewsAPI.io

รวมถึงหน้าประเทศ 168 หน้า หน้าภาษา 121 หน้า และหน้า TLD 275 หน้า — พื้นผิวที่เรียกดูได้หนึ่งชั้นสำหรับแต่ละส่วนย่อยของชุดข้อมูล โดยแต่ละหน้าจะแสดงเนื้อหาจริงที่มีอยู่

ที่มาของบทความ

สองเส้นทางการรับข้อมูลป้อนเข้าสู่ดัชนีเดียวกัน และความแตกต่างระหว่างสองเส้นทางนี้มีนัยสำคัญ

เส้นทางคลังข้อมูล

ทุกสิบนาที งานหนึ่งจะตรวจสอบคลังข้อมูล CC-NEWS ของ Common Crawl เพื่อหาไฟล์ WARC ใหม่ และประมวลผลไฟล์ที่ยังไม่เคยเห็น โดยใช้ผู้ทำงานคู่ขนานจำนวน 40 ตัว เครื่องสกัดจะดึงบทความแต่ละฉบับออกจากข้อมูลการเก็บรวบรวมดิบโดยใช้ลำดับชั้นที่ระบุไว้สำหรับแต่ละฟิลด์ — และลำดับชั้นเหล่านี้ได้รับการวัดผลกับข้อมูลจริงแทนที่จะเป็นการสมมติ:

ตัวเลขประเทศในข้อมูลนี้คือค่าที่แท้จริง และนี่คือเหตุผลที่ country_source ถูกเปิดเผยในบทความทุกฉบับ: ประมาณหนึ่งในห้าของบันทึกไม่มีสัญญาณประเทศที่เชื่อถือได้เลย และประมาณหนึ่งในสามของค่าที่มีอยู่เป็นค่าที่อนุมานขึ้น ไม่ใช่ข้อเท็จจริง API จะบอกคุณว่าค่าไหนเป็นค่าไหน แทนที่จะแกล้งทำเป็นว่าข้อมูลทั้งหมดถูกต้อง

เส้นทางแบบเรียลไทม์

หุ่นยนต์อีกตัวจะดึงข้อมูลฟีด RSS จากสำนักข่าวทุก ๆ ห้านาที โดยทำงานแบบหมุนเวียนพร้อมใช้ conditional requests — ฟีดที่ตอบกลับด้วยสถานะ 304 Not Modified จะใช้ทรัพยากรน้อยมาก และช่วงเวลาการดึงข้อมูลของฟีดแต่ละรายการจะถูกปรับให้เหมาะสมกับความถี่ที่ฟีดนั้นเผยแพร่เนื้อหาจริง ๆ สำนักข่าวที่ลงบทความห้าเรื่องต่อวันจะไม่ถูกดึงข้อมูลซ้ำทุกสิบห้านาที

ระบบยังดึงเฉพาะข้อมูลที่สำนักข่าวใส่ไว้ในฟีดเท่านั้น ได้แก่ หัวข้อ บทนำ และเนื้อหาเต็ม (เมื่อฟีดมีให้) ระบบจะไม่เข้าไปสำรวจเว็บไซต์ของสำนักข่าวเพื่อดึงข้อมูลเพิ่มเติม การจำกัดขอบเขตนี้เป็นการออกแบบอย่างตั้งใจ และเป็นเหตุผลที่ทำให้บริการนี้สามารถให้คำมั่นตามที่ระบุไว้ในหน้ากฎหมายสำหรับพันธมิตรสำนักข่าวได้

และกลไกที่เกี่ยวข้อง

รอบกระบวนการรับข้อมูลสองเส้นทางหลัก ยังมีหุ่นยนต์อีกกว่าสิบตัวทำงานตามตารางเวลา ได้แก่ การค้นหาและซิงค์แหล่งข้อมูล การระบุประเทศตามโดเมน การสร้างและตรวจสอบแนวโน้ม การเติมคำค้นหาย้อนหลัง การวิเคราะห์ความรู้สึกเกี่ยวกับคริปโต การดึงข้อมูลตลาด การจัดทำแคตตาล็อกหมวดหมู่ การเก็บรักษาข้อมูล (หน้าต่างเก้าสิบวันถูกบังคับใช้ผ่านคิวรี่ nightly บนฟิลด์ published_at ไม่ใช่ตามอายุของ index) การยืนยันวันที่ การตรวจสอบบทความที่ว่างเปล่า และตัวเฝ้าระวังสุขภาพที่รีสตาร์ทกระบวนการที่หยุดทำงาน ระบบคลังข้อมูลทั้งหมดอาศัยคลัสเตอร์ Elasticsearch เฉพาะ

ข้อจำกัดของชุดข้อมูลนี้

บริการนี้เปิดเผยข้อจำกัดของตัวเอง ซึ่งเป็นวิธีที่เร็วที่สุดในการประเมินว่าชุดข้อมูลนี้เหมาะกับปัญหาของคุณหรือไม่

• ประเทศเป็นค่าที่อนุมาน ตรวจสอบ country_source ในทุกบทความ และเพิ่มพารามิเตอร์ strict_country=true เมื่อคุณกำลังนับจำนวนบทความตามประเทศ แทนที่จะเพียงเลื่อนดูข้อมูล
• published_at เป็นค่าที่สำนักข่าวระบุ การย้อนหลังวันที่เป็นเรื่องปกติ ควรเรียงลำดับตาม crawled เมื่อคุณกำลังดึงข้อมูลเพื่อหาเนื้อหาใหม่
• ค่า total ถูกจำกัดไว้ที่ 10,000 เพื่อความเร็ว total_is_lower_bound จะแจ้งให้คุณทราบเมื่อคุณถึงขีดจำกัดสูงสุด
• ไม่มีข้อมูลความรู้สึกหรือการดึงข้อมูลเอนทิตี นอกเหนือจากบล็อก Bitcoin แล้ว บทความอื่น ๆ จะไม่มีคะแนนความรู้สึก (sentiment score) และไม่มีเอนทิตีที่มีชื่อ (named entities) ซึ่งอยู่นอกขอบเขตของบริการนี้
• เก้าสิบวัน ไม่มากกว่านั้น ไม่มีฐานข้อมูลเชิงลึกกว่านี้ หากคุณต้องการข้อมูลปี 2019 เครื่องมือนี้ไม่ใช่ทางเลือกที่ถูกต้อง
• ไม่มี SLA บริการฟรี มีการดูแลและตรวจสอบ แต่ไม่มีคำรับประกันเป็นลายลักษณ์อักษร
• ข้อความเป็นกรรมสิทธิ์ของผู้เผยแพร่ ทุกการตอบกลับจะรวม URL ดั้งเดิมไว้ด้วย และผู้ใช้ควรลิงก์กลับไปยังแหล่งข้อมูลนั้น

การใช้งานอย่างมีประสิทธิภาพ: ค่าใช้จ่าย การแบ่งหน้า และข้อผิดพลาด

วินัยด้านโทเค็น

สำหรับเอเจนต์ ขนาดของการตอบกลับคือต้นทุนที่แท้จริง รูปแบบที่เอกสารระบุไว้คือ:

บทความยี่สิบบทความพร้อม full_text=true จะใช้โทเคนประมาณ 40,000 โทเคน รูปแบบที่แนะนำคือเหมือนกันเสมอ: นับจำนวน สแกน แล้วจึงดึงเนื้อหาสำหรับรายการที่คุณต้องการเท่านั้น

การเลื่อนหน้าเกินขีดจำกัด

offset จะหยุดที่ 9,900 เพื่อสำรวจชุดข้อมูลขนาดใหญ่ อย่าฝืนขีดจำกัดนี้ แต่ให้แบ่งตามเวลาแทน ใช้ลูปตามวันต่อวัน หรือตามชั่วโมงต่อชั่วโมงสำหรับการค้นหาที่ซับซ้อน โดยใช้ from/to และ sort=date เอกสารประกอบมีหน้าเฉพาะสำหรับการสำรวจข้อมูลตลอดทั้งวัน

ข้อผิดพลาด

ข้อตกลงมีความชัดเจนและง่ายต่อการเขียนโค้ด: 4xx หมายถึงคำขอมีข้อผิดพลาด — แก้ไขแล้วอย่าลองใหม่ 5xx หมายถึงบริการขัดข้อง — ถอยออกและรอ 429 หมายถึงลดความเร็วลงแล้วลองใหม่ พารามิเตอร์การค้นหาที่ไม่รู้จักจะถูกเพิกเฉยแทนที่จะถูกปฏิเสธ ดังนั้นการเพิ่มฟิลด์ใหม่จึงไม่ทำให้ผู้เรียกใช้งานเดิมขัดข้อง

ระบุตัวตนของคุณ (ไม่บังคับ และไม่บังคับจริงๆ)

หากไม่มีคีย์ ก็ไม่มีทางระบุผู้เรียกใช้งานได้ ธรรมเนียมที่แนะนำคือการระบุหัวข้อความร่วมมือที่บอกชื่อแอปพลิเคชันของคุณ กรอบการทำงานที่ใช้ และโมเดลที่ขับเคลื่อน:

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>)

ค่าเดียวกันนี้สามารถใช้เป็นพารามิเตอร์การค้นหาแบบธรรมดา ซึ่งมักจะง่ายกว่า:

https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4o

คีย์ที่ไม่รู้จักจะถูกเพิกเฉย ดังนั้นการส่งคีย์เพิ่มเติมจึงปลอดภัยเสมอ ไม่มีอะไรถูกตรวจสอบ และไม่มีอะไรถูกจำกัดความเร็วหากไม่ได้ระบุไว้ และคำแนะนำหลักคือ: อย่าใส่ข้อมูลส่วนบุคคลของผู้ใช้งานปลายทางในฟิลด์เหล่านี้

ต่อสู้กับ APIs ของข่าวแบบเสียเงิน

หน้าเปรียบเทียบบนเว็บไซต์ครอบคลุมคู่แข่งสิบรายเป็นรายบุคคล ความแตกต่างเชิงโครงสร้างที่ยังคงมีอยู่ทั่วทั้งคู่แข่งเหล่านี้:

สิ่งที่บริการแบบเสียเงินยังคงมอบให้คุณซึ่งบริการนี้ไม่มี: คะแนนความรู้สึกและการแยกแยะเอนทิตีเป็นฟิลด์มาตรฐาน คลังข้อมูลย้อนหลังหลายปี และสัญญาที่มี SLA รองรับ สิ่งเหล่านี้เป็นสิ่งที่จับต้องได้ และหากคุณต้องการสิ่งเหล่านี้ คุณควรซื้อบริการเหล่านั้น

สูตรการทำอาหาร

เครื่องติดตามประเทศแบบเรียลไทม์

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"

เรื่องราวนี้เป็นเรื่องราวระดับโลกหรือภายในประเทศ

curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world event

ปรับโมเดลให้สอดคล้องกับข้อมูลปัจจุบันอย่างประหยัด

# 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"

การครอบคลุมข่าวเป็นปัจจัยนำราคาหรือไม่

curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"

เปลี่ยนการค้นหาที่บันทึกไว้ให้เป็นฟีด

https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50

ค้นหาแหล่งข่าวที่สำคัญในตลาด

curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that slice

สรุปสั้นๆ

Free News API เป็นบริการค้นหาข้อความเต็มรูปแบบ (full-text search) จากบทความข่าวกว่า 21.5 ล้านฉบับ จากผู้จัดพิมพ์มากกว่า 25,000 ราย ใน 100 ประเทศและประมาณ 100 ภาษา โดยครอบคลุมช่วงเวลา 90 วันแบบหมุนวนและอัปเดตอย่างต่อเนื่อง โดยไม่ต้องใช้คีย์ ไม่ต้องสมัครสมาชิก และไม่มีข้อจำกัดปริมาณการใช้งานอื่นนอกจากการจำกัดอัตราตาม IP บนพื้นฐานการค้นหา ยังมีฟีเจอร์การจัดกลุ่มเรื่องราวแบบเรียลไทม์ตามประเทศใน 115 ประเทศ การวิเคราะห์คำสำคัญที่แยกเหตุการณ์ระดับโลกออกจากภายในประเทศ การพล็อตเครื่องมือตลาด 14 ชนิดเทียบกับปริมาณการรายงานข่าว บล็อกความรู้สึกเกี่ยวกับบิตคอยน์ที่มี 7 จุดสิ้นสุด การกระจายเนื้อหาแบบ RSS/Atom/JSON สำหรับทุกการค้นพบ และเซิร์ฟเวอร์ MCP ที่ประกอบด้วย 28 เครื่องมือซึ่งสร้างจากบริการนี้เอง

บริการนี้บันทึกอัตราข้อผิดพลาดของตัวเอง เผยให้เห็นที่มาของค่าประเทศแต่ละค่า และเผยแพร่หน้าข้อมูลเกี่ยวกับสิ่งที่ข้อมูลอาจคลาดเคลื่อน สำหรับเอเจนต์ที่ต้องการทราบสิ่งที่โลกกำลังพูดถึง — ในภาษาตุรกี ภาษากรีก หรือภาษาฮินดี ณ ขณะนี้ — การผสมผสานดังกล่าวหาได้ยากมากในราคาใดก็ตาม และบริการนี้ให้ใช้งานฟรี

การค้นหาใช้ตรรกะ AND กับทุกคำ ใช้คำสำคัญ 2–5 คำ ไม่ใช่คำถามในรูปแบบภาษาธรรมชาติ

Free News API เกี่ยวกับวิธีการใช้งานอย่างมีประสิทธิภาพ

เริ่มต้นที่นี่: freenewsapi.ai · MCP ที่ freenewsapi.ai/mcp · คู่มือฉบับเต็มในรูปแบบไฟล์เดียวที่ /llms-full.txt