Free News API: ဆောင်းပါး ၂၁ သန်း၊ ပရိသတ် ၂၅,၀၀၀ နှင့် နိုင်ငံ ၁၀၀ အပေါ် Full-Text Search ပြုလုပ်နိုင်ပြီး၊ ခလုတ်လုံးဝ မလိုပါ

သတင်း API များကို အများအားဖြင့် request တစ်ခုချင်းစီအတွက် ရောင်းချပြီး key တစ်ခုနောက်ကွယ်တွင် ထားရှိလေ့ရှိကာ၊ free tier တွင် တစ်နေ့လျှင် request ၁၀၀ ထက်ပိုမူလေ့ရှိသည်။ Free News API သည် ထိုအရာများ မဟုတ်ပါ - ၉၀ ရက်ကြာသည့် rolling window အတွင်း ဆောင်းပါး ၂၁.၅ သန်း၊ ပရိသတ် ၂၅,၀၀၀ ကျော်၊ key မလို၊ signup မလို၊ quota မလို၊ ကုမ္ပဏီအသုံးပြုခွင့် ပေးထားသည်။ ဤနေရာတွင် search၊ statistics၊ trends၊ markets၊ feeds နှင့် MCP တို့၏ မျက်နှာစာအားလုံးနှင့် ဒေတာ မှားယွင်းနေသည့် အကြောင်းအရာတို့ကို ရှင်းလင်းစွာ ဖော်ပြထားသည်။

ပြဿနာ၏ ပုံသဏ္ဍာန်

AI agent တစ်ခုကို လက်ရှိကမ္ဘာလောကတွင် ဘာများကို ရေးသားနေသည်ကို မေးပါက ၎င်းသည် အခြေအနေ ၃ ခုကိုသာ ရွေးချယ်နိုင်သည်။ ၎င်းသည် publisher များကို တိုက်ရိုက် scrape လုပ်နိုင်သည် - ၎င်းသည် fragile၊ နှေးကွေးပြီး ဥပဒေရေးရာအရ မရှင်းလင်းသော အရာဖြစ်သည်။ ၎င်းသည် commercial news API တစ်ခုကို call လုပ်နိုင်သည် - ၎င်းသည် account၊ key၊ လစဉ် ငွေပေးချေမှုနှင့် - ဈေးကွက်ရှိ free tier အားလုံးတွင် တစ်နေ့လျှင် request ၁၀၀ နှင့် ဆောင်းပါးများကို ၂၄ နာရီ နောက်ကျစေခြင်းတို့ ပါဝင်သည်။ သို့မဟုတ် ၎င်းသည် လစဉ်များစွာ ကြာရှည်စွာ မပြောင်းလဲသော training data မှ ခန့်မှန်းနိုင်သည်။

Free News API သည် အလယ်အလတ် option ၏ ဈေးနှုန်းနှင့် စာရွက်စာတမ်းများကို ဖယ်ရှားပေးသော်လည်း ၎င်း၏ စွမ်းဆောင်ရည်ကို မဖယ်ရှားပါ။ One GET request၊ credentials မလို၊ corpus တစ်ခုပေါ်တွင် - ရေးသားချိန်တွင် ဆောင်းပါး ၂၁,၅၅၇,၀၄၄ ကျော်၊ ပရိသတ် ၂၅,၀၀၀ ကျော်မှ ရရှိပြီး၊ rolling ninety-day window တွင် ထိန်းသိမ်းထားပြီး continuously refresh လုပ်ထားသည် - index ထဲရှိ အနောက်ဆုံးဆောင်းပါးသည် အများအားဖြင့် ၂ မိနစ်အောက် အသက်သာရှိသည်။

အဓိက Endpoint လေးခုနှင့် အခြားအရာများ

Service ၏ အဓိကအစိတ်အပိုင်းမှာ GET endpoint လေးခုဖြစ်ပြီး၊ ၎င်းအားလုံးသည် https://freenewsapi.ai အောက်တွင်ရှိပြီး၊ UTF-8 JSON ကို Access-Control-Allow-Origin: * ဖြင့် ပြန်ပေးသည်။ ထို့ကြောင့် browser code များသည် ၎င်းတို့ကို တိုက်ရိုက်ခေါ်ယူနိုင်ပြီး၊ server-side အချိန်ကို took_ms တွင် ပြသသည်။

အဆိုပါ အဓိကအစုအဝေးကို ဗဟိုပြု၍ အခြား မိသားစုလေးစုလုံး ဝန်းရံထားသည်။ ဤတစ်ခုစီသည် နေရာအနှံ့တွင် ကိုယ်ပိုင်ထုတ်ကုန်တစ်ခုစီ ဖြစ်နိုင်သည်။ ။ တိုးတက်မှုများ (နိုင်ငံအလိုက် သတင်းအဖြစ် ဖြစ်ပေါ်နေသော ဖြစ်ရပ်များကို အုပ်စုဖွဲ့ခြင်း)၊ ဈေးကွက်များ (အုပ်စုဖွဲ့မှု ပမာဏနှင့် ညှိနှိုင်းထားသော ဈေးနှုန်း အစဉ်အတိုင်း)၊ ကွေးတိုက် ခံစားချက် (Bitcoin block ခြောက်ခုအတွက်)၊ နှင့် ပြန်လည်ဖြန့်ဖြူးခြင်း (အဆိုပါ 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 မှ သတ်မှတ်ပေးပြီး နောက်သို့ ပြန်မသွားဘဲ ရှေ့သို့သာ ရွေ့လျားသည်။

ရှာဖွေခြင်း - အရေးကြီးသော ပါရာမီတာအားလုံး

ပါရာမီတာအားလုံးကို မဖြစ်မနေ ထည့်သွင်းရန် မလိုပါ။ အခြေခံဆုံး ခေါ်ယူမှုဖြင့် index ထဲရှိ အသစ်ဆုံး ဆောင်းပါးများကို ရယူနိုင်သည်။

မေးခွန်း

• q ခေါင်းစဉ် (အလေးပေးမှု 3)၊ ဖော်ပြချက် (အလေးပေးမှု 2) နှင့် ဆောင်းပါးစာသားတို့နှင့် တိုက်ဆိုင်စစ်ဆေးသည်။ AND စကားလုံး - စကားလုံးအားလုံး ပါဝင်ရမည်။ ထို့ကြောင့် စကားလုံးတစ်ခု ထပ်ထည့်ခြင်းသည် ပိုမိုကျယ်ပြန့်စေခြင်းထက် ပိုမိုကျဉ်းမြောင်းစေသည်။ အများဆုံး 500 ကြိမ်။

စစ်ထုတ်ခြင်း

စစ်ထုတ်ခြင်းများသည် ပါရာမီတာအားလုံးအတွက် AND နှင့် တစ်ခုတည်းသော စစ်ထုတ်ခြင်းအတွက် OR တို့နှင့် ပေါင်းစပ်သည်။ ထို့ကြောင့် country=DE,AT&lang=de သည် "ဇာတ်လမ်းတိုများကို ဂျာမန်ဘာသာဖြင့် ရေးသားထားသော ဂျာမနီ သို့မဟုတ် အอสเตรีย" ဟု ဖတ်ရှုနိုင်သည်။ တစ်ခုစီသည် တစ်ခုတည်းသော စာရင်းအတွက် 50 ခုအထိ လက်ခံနိုင်သည်။

Output ထိန်းချုပ်မှု

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"

ရှာဖွေမည့်အကြောင်း မရှာမီ ရေတွက်ခြင်း

ဤဝန်ဆောင်မှုတွင် အသုံးအများဆုံးမဟုတ်သော endpoint မှာ /v1/stats ဖြစ်သည်။ အသုံးဝင်သော မေးခွန်းသည် "ဆောင်းပါးများ ဘာတွေလဲ" ဆိုတာထက် "ဒီမှာ ဘာမှရှိလား၊ ဘယ်မှာရှိလဲ" ဆိုတာဖြစ်လေ့ရှိသည်။ ရလဒေစာမျက်နှာတစ်ခုအတွက် ကုန်ကျစရိတ် ထောင်ပေါင်းများစွာအစား ခန့်မှန်းခြေ token နှစ်ရာခန့်ဖြင့် ရေတွက်ခြင်းသည် ရှာဖွေမှုကို ခြွင်းချက်မပါဘဲ အသုံးပြုရန် ဆုံးဖြတ်ရာတွင် အကုန်အကျ အနည်းဆုံးဖြစ်သောကြောင့် မှန်ကန်သော ပထမဆုံး call ဖြစ်စေသည်။

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

၎င်းသည် ကုလသမဂ္ဂနိုင်ငံများ၊ ဘာသာစကား၊ TLD၊ ထုတ်လုပ်သူနှင့် နေ့စွဲအလိုက် ရေတွက်ချက်မှုများကို ပြန်ပေးသည်။ ၎င်းသည် လက်ရှိ စာမျက်နှာမဟုတ်ဘဲ တစ်ခုလုံးသော ကိုက်ညီမှုရှိသော အစုအဝေးပေါ်တွင် တွက်ချက်ထားသည်။ ယုံကြည်မှုရှိစေရန် မတိုင်မီ ဖုံးလွှမ်းမှုကို တိုင်းတာရန် နည်းလမ်းလည်း ဖြစ်သည်။ ရေးသားချိန်တွင် ဖြစ်ပေါ်နေသော မပြင်ဆင်ဘဲ snapshot:

နိုင်ငံများ အများဆုံး

အဓိကဘာသာစကားများ

အင်္ဂလိပ် ၅,၅၁၃,၆၅၀ · စပိန် ၂,၆၉၉,၄၅၇ · ရုရှား ၁,၇၈၅,၇၉၆ · တူရကီ ၁,၅၀၁,၀၀၄ · အီတလီ ၉၉၂,၂၀၀ · ဂျာမန် ၇၃၃,၆၇၇ · ပြင်သစ် ၆၈၉,၁၃၆ · အာရပ် ၆၆၄,၀၁၆ · ပေါ်တူဂီ ၆၃၇,၆၀၇ · ဟင်ဒီ ၅၆၀,၈၄၀ · ဂရိ ၄၆၆,၅၀၄ · ဂျပန် ၄၂၇,၀၈၅ · ဗီယက်နမ် ၃၈၅,၇၁၉ · ရိုမေးနီးယား ၃၅၈,၇၆၆ · ချင်း ၃၅၂,၇၂၀ · အူကရိန်း ၃၄၅,၈၀၉ · ကိုရီးယား ၃၃၅,၀၇၉ · ပါရှန် ၂၆၈,၁၂၆ · ပိုလန် ၂၃၈,၉၀၄ · ဘူလဂေးရီးယား ၁၈၃,၂၀၄။

ဒီလို ဖြန့်ဖြူးမှုကို တစ်စက္ကန့်လောက် ကြည့်ရှုဖို့ တန်ဖိုးရှိပါတယ်။ အဘယ်ကြောင့်ဆိုသော် ၎င်းသည် သတင်း API အများစု ပေးလေ့ရှိသည့် အချက်အလက်နှင့် ဆန့်ကျင်ဘက် ဖြစ်သောကြောင့် ဖြစ်သည်။ အင်္ဂလိပ်-ပထမ၊ အမေရိကန်-ပထမ စနစ်ဖြင့် ဖွဲ့စည်းထားသည့် သာမန် စာအုပ်စုသည် ဤအချက်အလက်နှင့် ကွဲပြားသည်။ အိန္ဒိယနိုင်ငံသည် အမေရိကန်နိုင်ငံထက် ပိုမိုမြင့်မားပြီး၊ တူရကီသည် ဂျာမန်ထက် ပိုမိုမြင့်မားကာ၊ ဂရိ၊ ဗီယက်နမ်၊ ပါရှန်နှင့် ဘူလဂေးရီးယား ဘာသာစကားများစွာတွင်လည်း ခြောက်လုံးပါ အရေအတွက် ပါဝင်သည်။ သင့်မေးခွန်းသည် အင်္ဂလိပ်မဟုတ်သော သတင်းစာများနှင့် ပတ်သက်ပါက ဤသည်မှာ အခြေခံအားဖြင့် ကွဲပြားသည့် ဒေတာစုတစ်ခု ဖြစ်သည်။

ပမာဏ

by_day တွင် ပါဝင်သော နေ့စဉ် ခွေးစောင်းပုံသည် နေ့ ၉၀ ပြည့်ကာလတစ်ခုလုံးကို ဖုံးလွှမ်းထားသည်။ နောက်ဆုံးရက်များသည် နေ့စဉ် ၄၀၀,၀၀၀ မှ ၇၀၀,၀၀၀ အကြောင်းအရာများ အကြားတွင် ရှိနေပြီး၊ RSS အလွှာကို အrchive စုဆောင်းမှုနှင့်အတူ ထည့်သွင်းမီကာလက နေ့စဉ် ပမာဏမှာ ၁၃၀,၀၀၀ မှ ၂၃၀,၀၀၀ အကြားတွင် ရှိခဲ့သည်။ ဤနှစ်ခုလုံးသည် တူညီသော တုံ့ပြန်မှုတွင် ပါဝင်ပြီး၊ ၎င်းသည် သတင်းပေးစေvice ကိုက်ညီမှုရှိသည့် ချဉ်းကပ်မှုကို ပြသခြင်းဖြစ်ပြီး၊ ဈေးကွက်ဆိုင်ရာ ပျမ်းမျှအချက်အလက်ကို ဖော်ပြခြင်း မဟုတ်ပါ။

လမ်းကြောင်းများ - သတင်းစာများသည် လက်ရှိတွင် မည်သည့်အကြောင်းအရာများကို ဖော်ပြနေသနည်း

ရှာဖွေခြင်းသည် "X နှင့်ပတ်သက်၍ မည်သည့်အရာကို ရေးသားခဲ့သနည်း" ဟု မေးသည်။ လမ်းကြောင်းများသည် ကွဲပြားသော နှင့် မကြာခဏ ပိုကောင်းသော မေးခွန်းကို ဖြေဆိုသည် - "ဖြစ်ပျက်နေသည့်အရာ" - X လိုအပ်ခြင်းမရှိပါ။

ရိုဘော့တစ်ခုသည် နိုင်ငံတစ်ခုချင်းစီအတွက် အကြောင်းအရာများကို စုစည်းပြီး အချိန်နှင့်တစ်ပြေးညီ ပြင်ဆင်ပေးသည်။ နှစ်မိနစ်တိုင်းတွင် ခွဲခြားသတ်မှတ်သည့် စကားလုံးများဖြင့် သိရှိပြီးသော အကြောင်းအရာများသို့ အသစ်အကြောင်းအရာများကို ထည့်သွင်းပေးသည်။ မော်ဒယ်ခေါ်ဆိုမှု မလိုအပ်ပါ။ နာရီအနည်းငယ်တိုင်းတွင် နိုင်ငံတစ်ခုသည် အခေါင်းအိမ်များကို ဖတ်ရှုပြီး အကြောင်းအရာများကို အစကတည်းက ခေါင်းစဉ်ပေးသည်။ ရေးသားနေချိန်တွင် လမ်းကြောင်းအလွှာသည် နိုင်ငံ ၁၁၅ နိုင်ငံကို ဖုံးလွှမ်းထားပြီး၊ နာရီအနည်းငယ်အတွင်း ပြန်လည်တွက်ချက်ထားသည်။

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 သည် ချဲ့ကားမှုဖြစ်သည်။ နေရာ ၄ ခုမှ အကြောင်းအရာ ၂၀၀ ပါဝင်သော အကြောင်းအရာတစ်ခုသည် သတင်းစာတစ်စောင်၏ စိတ်ဝင်စားမှုဖြစ်သည်။ နေရာ ၄၀ မှ အကြောင်းအရာ ၆၀ ပါဝင်သော အကြောင်းအရာတစ်ခုသည် ဖြစ်စဉ်တစ်ခုဖြစ်သည်။ သတ်မှတ်ထားသော စီစဉ်ချက်သည် publishers အလိုက်ဖြစ်ပြီး min_publishers / min_articles သင့်အား သင့်အလိုအလျောက် သတ်မှတ်ခွင့်ပြုသည်။

သတင်းအကြောင်းအရာများသည် politics (နိုင်ငံရေး), business (စီးပွားရေး), markets (ဈေးကွက်), tech (နည်းပညာ), sport (အားကစား), health (ကျန်းမာရေး), science (သိပ္ပံ), culture (ယဉ်ကျေးမှု), crime (ပြစ်မှု), conflict (တိုက်ပွဲ/အငြင်းပွားမှု), weather (ရာသီဥတု), society (လူမှုရေး) စသည့် သတ်မှတ်ထားသော အမျိုးအစားစာရင်းမှ တစ်ခုခုကို သယ်ဆောင်သည်။

အချိန်ကာလရွေးချယ်မှုသည် ဖတ်ရှုသူ၏ ဆန္ဒဖြစ်ပြီး ရိုဘော့၏ ဆန္ဒမဟုတ်ပါ

ဒါက အမှန်တကယ် ချောမွေ့တဲ့ ဒီဇိုင်းဆုံးဖြတ်ချက်တစ်ခုပါ။ ဆောင်းပါးတိုင်းကို ထုတ်ဝေချိန်နဲ့အတူ သိမ်းဆည်းပြီး ၎င်း၏ သတင်းအကြောင်းအရာ (story) နဲ့ ချိတ်ဆက်ထားလို့၊ နှစ်သစ်ကူး ၁၅ မိနစ်၊ တစ်နာရီ၊ တစ်ရက် သို့မဟုတ် သတ်မှတ်ထားတဲ့ နေ့ရက်တစ်ခုလို အချိန်ကာလတိုင်းဟာ သိမ်းဆည်းထားတဲ့ ဒေတာတူညီတဲ့အပေါ် မူတည်တဲ့ range query တစ်ခုသာ ဖြစ်ပါတယ်။ တွက်ချက်မှုတစ်ခုတည်းက အချိန်ကာလအားလုံးကို တစ်ပြိုင်နက် ဖြေရှင်းပေးနိုင်ပါတယ်။ window=15m၊ window=1h၊ window=24h၊ date=2026-09-01 သို့မဟုတ် since/until စုံတွဲတစ်ခုစလုံးဟာ ပြန်လည်တွက်ချက်မှုမလိုဘဲ တူညီတဲ့ index ပေါ်မှာ အလုပ်လုပ်နိုင်ပါတယ်။

စကားလုံးများ - သတင်းတို့၏ အခြေခံကျသော စကားလုံးများ

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

စကားလုံးတစ်ခုစီသည် ၎င်းကို သယ်ဆောင်ထားသော ကွဲပြားသည့် သတင်းအကြောင်းအရာ (stories) အရေအတွက်၊ ထိုသတင်းအကြောင်းအရာများတွင် ပါဝင်သော ဆောင်းပါးအရေအတွက်၊ နှင့် - စိတ်ဝင်စားဖွယ်ကောင်းသော အချက်မှာ - ၎င်းကို အသုံးပြုသည့် နိုင်ငံရေးဆိုင်ရာ သတင်းစာများ အရေအတွက် တို့ကို ပြန်ပေးပါသည်။ နောက်ဆုံးအချက်က ကမ္ဘာ့ဖြစ်ရပ်တစ်ခုနဲ့ နိုင်ငံတွင်းဖြစ်ရပ်တစ်ခုကြားက ကွာခြားချက်ဖြစ်ပါတယ်။ နိုင်ငံပေါင်း ၇၀ တွင် ပါဝင်သော စကားလုံးတစ်ခုက ကမ္ဘာ့သတင်းတစ်ခုဖြစ်ပြီး၊ နိုင်ငံတစ်ခု၏ သတင်းစာများကို ဖြန့်ကျက်ထားသော စကားလုံးတစ်ခုက (သတင်းစာများတွင် မည်မျှမြည်ဆူစွာ ဖြစ်စေကာမူ) နိုင်ငံတွင်း သတင်းတစ်ခု ဖြစ်ပါတယ်။

အသက်ရှင်နေသော နိုင်ငံများ

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

စောင့်ကြည့်လျက်ရှိသော နိုင်ငံအားလုံးကို ၎င်းတို့၏ အသက်ရှင်သတင်းအကြောင်းအရာ အရေအတွက်နှင့် နောက်ဆုံးအကြိမ် ပြန်လည်တွက်ချက်ပြီးသားဖြစ်ချိန်မှ ဤနေ့ထိ မည်မျှမိနစ်ကြာသွားပြီဆိုတာတို့အတူ ပြန်ပေးပါသည် - တူရကီ၊ ရုရှား၊ အီရန်၊ ဂရိ၊ အိန္ဒိယ၊ အီတလီ၊ ယူကရိန်း၊ ရိုမေးနီးယား၊ အာဂျင်တီးနား၊ ဂျာမနီနှင့် ဘရာဇီးတို့အားလုံးတွင် လက်ရှိတွင် အသက်ရှင်သတင်းအကြောင်းအရာ နှစ်ထောင်ကျော်စီ ပါဝင်ပြီး နောက်ဆုံးတစ်ဆယ်မိနစ်အတွင်း ပြန်လည်တွက်ချက်ထားကြသည်။ /v1/trends/{cc}/{slug} ကလည်း သတင်းအကြောင်းအရာတစ်ခုတည်းကို ၎င်း၏ ဆောင်းပါးစာရင်းအပြည့်အစုံနှင့်အတူ ဖွင့်ပေးနိုင်သည်။

ဈေးကွက်များနှင့် ဖုံးလွှမ်းမှု - တစ်ဘက်တွင် ဈေးနှုန်း၊ အခြားတစ်ဘက်တွင် ဂရုစိုက်မှု

ဒါက ဝန်ဆောင်မှုထဲမှာ အထူးဆုံးဆုံး အရာဖြစ်ပြီး၊ corpus ကို အသုံးပြုပြီး တည်ဆောက်ရန် လက်တွေ့ကျပြီး သိပ်မကုန်ကျစေတဲ့အတွက် ဖြစ်ပေါ်လာတာပါ။ အချိန်တူညီတဲ့ နာရီအချိန်တွေမှာ ကမ္ဘာလုံးဆိုင်ရာ သတင်းစာများက ထိုအရာအကြောင်း မည်မျှရေးသားခဲ့သည်ဆိုတာကို ဈေးနှုန်းစီးရီးနဲ့ တစ်ခုတည်းသော ဇယားကြောင်း (timeline) ပေါ်မှာ တစ်ပြိုင်နက် နှိုင်းယှဉ်ပြသနိုင်ပါတယ်။

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

စျေးကွက်အမျိုးအစား လေးမျိုးအတွင်းရှိ စျေးကွက်ကိရိယာ (instruments) တစ်ဆယ့်လေးမျိုးကို စောင့်ကြည့်လျက်ရှိသည် -

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

ထိုတစ်ကြိမ်တည်းသော call ကိုယ်စားလှယ်က သင့်အား ဒေါ်လာနှင့် ယှဉ်လျှင် လီရာ (Lira) ဈေးနှုန်းနှင့် ထိုကာလအတွင်း တူရကီသတင်းစာများ၏ ဖုံးလွှမ်းမှု ပမာဏကို တစ်နာရီစီ တိုက်ရိုက်နှိုင်းယှဉ်ပေးပါသည်။ ဤ data corpus တွင် တူရကီသတင်းစာများသည် တတိယအကြီးဆုံး အစိတ်အပိုင်းဖြစ်ပြီး၊ ထို့ကြောင့် ဤစုံတွဲ (pairing) မှာ ဆူညံသံ (noise) မဟုတ်ဘဲ အဓိပ္ပာယ်ရှိသော ရလဒ်ကို ထုတ်ပေးနိုင်ခြင်း ဖြစ်ပါသည်။

Bitcoin စိတ်ကူးယဉ် (sentiment) အပြည့်အစုံ block တစ်ခု

Bitcoin သည် သတင်း၏ ဦးတည်ချက်နှင့် ဈေးကွက်လှုပ်ရှားမှုကို အမြဲတမ်း ဆွေးနွေးကြသော်လည်း တိုင်းတာမှု အနည်းငယ်သာ ရှိသောကြောင့် ၎င်း၏ ကိုယ်ပိုင် endpoint ခုခုနစ်ခုပါ အစုအဝေးကို ရရှိလာခဲ့သည်။

စိတ်ခံစားမှု label များသည် ငွေကြေးဒစ်ဂျစ်တယ် (crypto) ဆောင်းပါးအသစ်များကို ခြောက်မိနစ်တိုင်း စစ်ဆေးသည့် ဘာသာစကား မော်ဒယ် (language model) မှ ရရှိလာသည်။ သတင်းက ရွေ့လျားမှုကို ဖြစ်စေသည်ဟူသော ယူဆချက်ကို ထပ်မံပြောဆိုရုံမဟုတ်ဘဲ စမ်းသပ်ကြည့်ချင်ပါက /v1/btc/correlation နှင့် max_shift parameter ကို အသုံးပြုပါ။

အတူတူပင် ရှာဖွေမှုကို Feed အဖြစ်

ထပ်မံ endpoint သုံးခုသည် အတူတူပင် ရှာဖွေမှု parameter များကို ယူဆောင်ပြီး JSON အစား syndication format များအဖြစ် ရလဒ်များကို ပြသသည်။

• 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

ဆိုလိုသည်မှာ သိမ်းဆည်းထားသော ရှာဖွေမှုတိုင်းသည် reader၊ n8n node၊ Slack integration၊ Zapier trigger သို့မဟုတ် static site generator တစ်ခုခုထဲသို့ paste လုပ်နိုင်သည့် feed ဖြစ်လာသည် — ကုဒ်မလိုဘဲ၊ key လည်းမလိုဘဲ။ ၎င်းသည် programmer မဟုတ်သူများအတွက် integration layer တစ်ခုလုံးကို ဖယ်ရှားပေးသော အင်္ဂါရပ်ငယ်တစ်ခု ဖြစ်သည်။

MCP: ကိရိယာ (၂၈) ခု၊ အလွှာ (၂) ခု

MCP server သည် URL တွင် တည်ရှိပြီး Streamable HTTP (JSON-RPC 2.0 over POST, protocol version 2025-06-18) ကို ပြောဆိုသည်၊ batching ကို ပံ့ပိုးပေးပြီး — ဤနေရာရှိ အရာအားလုံးကဲ့သို့ — authorization step မရှိဘဲ session id လည်း မရှိပါ။

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

၎င်းသည် အလွှာ (၂) ခုတွင် ကိရိယာ (၂၈) ခုကို ဖော်ပြသည်။

အလွှာ (၁) - မေးခွန်းတစ်ခုလုံးကို call တစ်ခုတည်းဖြင့် ဖြေဆိုပေးသော shortcut (၆) ခု

အဆင့်နှစ် - နေရာတိုင်းကို ဝန်ဆောင်မှုမှ ထုတ်လုပ်ထားသည်

လမ်းကြောင်းအတိုင်း၊ တစ်ခုချင်းစီကို API လက်ခံသော ပါရာမီတာအားလုံးနှင့်အတူ ၎င်း၏ ကိုယ်ပိုင်ကိရိယာအဖြစ် ဖော်ပြထားသည် - news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, news_get_btc_* မိသားစု၊ feed renderers နှင့် news_get_health။ ၎င်းတို့သည် တိုက်ရိုက်ဝန်ဆောင်မှုမှ ထုတ်လုပ်ထားသောကြောင့် API လက်ခံသည့်အတိုင်း မပြောင်းလဲနိုင်ပါ။

Meta ကိရိယာနှစ်ခု ပတ်လုံးပတ်ဝန်းကျင်ကို ပိတ်ထားသည် - news_list_endpoints သည် အားလုံး၏ စာရင်းကို ပြန်ပေးသည်၊ news_get သည် မည်သည့်လမ်းကြောင်းတွင်မဆို raw GET ပြုလုပ်သည် - ထို့ကြောင့် ၎င်း၏ ကိရိယာစာရင်းတွင် မပါဝင်သော နေရာတစ်ခုကို တွေ့ရှိသည့် agent တစ်ခုသည် ၎င်းသို့ ရောက်ရှိနိုင်သည်။

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

တစ်ခု GET၊ လက်မောင်းမပါ၊ သင်သည် စက်လုပ်ဆောင်နိုင်သော စာရင်းကို ရရှိမည် - ဘက်စုံ၊ ပို့ဆောင်ရေး၊ ပရိုတိုကော၊ ကိရိယာအရေအတွက်၊ နေရာတိုင်းနှင့် ၎င်း၏ ပါရာမီတာစာရင်း။

စက်များအတွက် ဖတ်ရှုရန် ဖွဲ့စည်းထားသည်

စာရွက်စာတမ်းများသည် API နှင့်အတူ နောက်ဆုံးအနေဖြင့် ထည့်သွင်းထားခြင်း မဟုတ်ပါ - ၎င်းသည် ၎င်း၏ ပထမဆုံးထွက်ရှိမှုဖြစ်သည်။ နေ့စဉ် ၆၆၅ စာမျက်နှာများကို ထုတ်ပေးပြီး၊ မော်ဒယ်တစ်ခုသည် HTML ကို ဖတ်ရှုရန် လိုအပ်ခြင်း မရှိစေရန် အထူးတည်ဆောက်ထားသည်။

• /openapi.json OpenAPI schema အပြည့်အစုံ။
• /llms.txt ဝန်ဆောင်မှု၏ သဘောတရား၊ endpoint များ၊ မည်သို့ query ပေးရမည်၊ error များ စသည့် ခြုံငုံသဘောတရားဖော်ပြချက်။
• /llms-full.txt စာရွက်စာတမ်းအားလုံးကို တစ်ဖိုင်တည်းအဖြစ် ပြင်သစ်စာသား (plain-text) ဖြင့် ပေးထားပြီး၊ အက်ဂျင့် (agent) တစ်ခုလုံးကို တစ်ကြိမ်တည်း fetch လုပ်နိုင်ရန် ၁၀၀ ကီလိုဘိုက်ကျော် ပါဝင်သည်။
• /agents အက်ဂျင့် တည်ဆောက်သူများအတွက် ရည်ရွယ်သော စာမျက်နှာ ၃၉ ခု - အဆင်သင့် OpenAI function အဓိပ္ပာယ်ဖွင့်ဆိုချက်များ၊ Anthropic tool-use အဓိပ္ပာယ်ဖွင့်ဆိုချက်များ၊ သတင်းရှာဖွေရန် system prompts များ၊ RAG နည်းဗျူဟာများ၊ token ကုန်ကျစရိတ် ဇယားများနှင့် အက်ဂျင့် နည်းဗျူဟာများ။
• /agents/models မော်ဒယ် မိသားစုတစ်ခုစီအတွက် tool-coding ကုဒ်များ - 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 corpus အတွင်းရှိ အရာများ၊ နည်းဗျူဟာ၊ index schema နှင့် ဒေတာစုစည်းမှုတွင် မည်သို့များမှားယွင်းနေသည်ကို မှတ်တမ်းတင်ထားသော Data quality စာမျက်နှာ။
• /sources နိုင်ငံ၊ ဘာသာစကားနှင့် domain zone အလိုက် ခွဲခြားနိုင်သော ထုတ်ဝေသူ ၁၁,၆၆၈ ခု၏ စာရင်းစာအုပ်။
• /compare NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube နှင့် FreeNewsAPI.io တို့နှင့် နှိုင်းယှဉ်သော စာမျက်နှာများ။

ပိုမို၍ နိုင်ငံ ၁၆၈ နိုင်ငံ၏ စာမျက်နှာများ၊ ဘာသာစကား ၁၂၁ ခု၏ စာမျက်နှာများနှင့် TLD ၂၇၅ ခု၏ စာမျက်နှာများ — corpus ၏ အပိုင်းလိုက်တစ်ခုစီအတွက် ရှာဖွေကြည့်ရှုနိုင်သော မျက်နှာစာတစ်ခုစီသည် ၎င်းတွင် အမှန်တကယ် ပါဝင်သည့် အကြောင်းအရာများကို ပြသသည်။

ဆောင်းပါးများ မည်သို့ ဖြစ်ပေါ်လာသနည်း

ဆောင်းပါးများကို စုဆောင်းရန် လမ်းကြောင်းနှစ်ခုသည် တူညီသော index ကို feed ပေးပြီး ၎င်းတို့အကြား ကွဲပြားမှုသည် အရေးပါသည်။

Archive လမ်းကြောင်း

တစ်ဆယ်မိနစ်တိုင်းတွင် job တစ်ခုသည် Common Crawl ၏ CC-NEWS archive အတွက် WARC ဖိုင်အသစ်များကို စစ်ဆေးပြီး ၎င်းမမြင်ဖူးသော အရာများကို parallel workers ၄၀ ဖြင့် ဖြေရှင်းသည်။ Extractor သည် raw crawl ထဲမှ ဆောင်းပါးတစ်ခုချင်းစီကို field တစ်ခုချင်းစီအတွက် မှတ်တမ်းတင်ထားသော cascade ဖြင့် ထုတ်ယူသည် — cascade များသည် ယူဆချက်ထက် တကယ့်ဒေတာကို အသုံးပြု၍ တိုင်းတာခဲ့သည်:

နိုင်ငံဆိုင်ရာ ဒေတာဇယားက အမှန်တကယ် ဖြစ်သော အချက်အလက်ဖြစ်ပြီး၊ country_source ကို ဆောင်းပါးတိုင်းတွင် ဖော်ပြရခြင်းမှာ ၎င်း၏ အကြောင်းရင်းဖြစ်သည် — မှီခိုနိုင်သော နိုင်ငံဆိုင်ရာ အချက်အလက် မပါဝင်သည့် မှတ်တမ်းများသည် ခန့်မှန်းခြေအားဖြင့် တစ်ပုံစုလျှင် ခြောက်ပုံတစ်ပုံခန့်ရှိပြီး၊ ရှိနေသော တန်ဖိုးများအနက် သုံးပုံတစ်ပုံခန့်သည် အမှန်တကယ် အချက်အလက်မဟုတ်ဘဲ ခန့်မှန်းချက်သာ ဖြစ်သည်။ API သည် မည်သည်က အမှန်တကယ် ဖြစ်ပြီး မည်သည်က ခန့်မှန်းချက်ဖြစ်သည်ကို ဖော်ပြပေးသည်။

တိုက်ရိုက် လမ်းကြောင်း

ဒုတိယ ခွေးကောင်ရိုဘော့ (robot) သည် ခွေးကောင်ရိုဘော့ RSS feed များကို ခြောက်စက္ကန့်လျှင် တစ်ကြိမ် စစ်ဆေးသည်။ ဤ feed များသည် 304 Not Modified ဟု ပြန်လည်ဖြေကြားလေ့ရှိသဖြင့် ဝန်ထုပ်ဝန်ပိုး အလွန်နည်းပါးပြီး၊ feed တစ်ခုစီ၏ စစ်ဆေးချိန်ကာလကို ၎င်းတို့ စာမျက်နှာတင်ပေးမှု ကြိမ်နှုန်းအပေါ် မူတည်၍ စနစ်တကျ ချိန်ညှိထားသည်။ နေ့တိုင်း ဆောင်းပါး ခြောက်ပုဒ်ခန့် တင်ပေးသော သတင်းဌာနတစ်ခုကို ခြောက်မိနစ်လျှင် တစ်ကြိမ် ဖိအားပေးစစ်ဆေးနေခြင်း မဟုတ်ပါ။

ထို့အပြင် ၎င်းသည် ခွေးကောင်ရိုဘော့ feed တွင် ခွေးကောင်ရိုဘော့တင်ပေးထားသော အရာများသာ ယူဆောင်လာသည် — ခေါင်းစဉ်၊ ဦးဆောင်စာသားနှင့် feed တွင် ပါဝင်ပါက အပြည့်အစုံ စာသားများဖြစ်သည်။ ခွေးကောင်ရိုဘော့၏ ဝဘ်ဆိုက်ပေါ်သို့ ဝင်ရောက်ပြီး အခြားအချက်အလက်များကို မယူဆောင်ပါ။ ၎င်းသည် ရည်ရွယ်ချက်ရှိရှိ သတ်မှတ်ထားသော နယ်နိမိတ်တစ်ခုဖြစ်ပြီး၊ ဤအချက်ကြောင့်သာ ဝန်ဆောင်မှုပေးသည့် ဥပဒေရေးရာ စာမျက်နှာတွင် ခွေးကောင်ရိုဘော့ ပေးထားသော ကတိကဝတ်များကို ထိရောက်စွာ ပေးနိုင်ခြင်း ဖြစ်သည်။

အခြား စက်မှုလုပ်ငန်းများ

အထက်ပါ ခွေးကောင်ရိုဘော့ နှစ်ခု၏ ဝန်းကျင်တွင် စာရင်းသွင်းခြင်း လမ်းကြောင်းများစွာအတွက် ခွေးကောင်ရိုဘော့ တစ်ဆယ်ခုခန့် သတ်မှတ်ချိန်များအတိုင်း လုပ်ဆောင်နေသည် — အရင်းအမြစ် ရှာဖွေတွေ့ရှိခြင်းနှင့် sync လုပ်ခြင်း၊ domain တစ်ခုချင်းစီအတွက် နိုင်ငံဆုံးဖြတ်ခြင်း၊ နည်းလမ်းဆန်းများ တည်ဆောက်ခြင်းနှင့် စစ်ဆေးခြင်း၊ keyword ဖြည့်ဆည်းခြင်း၊ crypto sentiment၊ ဈေးကွက် ဆွဲယူခြင်း၊ taxonomy စာရင်းစု၊ retention (၉၀ ရက်ကာလကို index အသက်ကာလအလိုက် မဟုတ်ဘဲ published_at အတွက် ညစဉ် query ဖြင့် အကန့်အသတ်ချထားသည်)၊ နေ့စဉ် စစ်ဆေးခြင်း၊ ဆောင်းပါးလွတ်များ ပြန်လည်စစ်ဆေးခြင်းနှင့် အခြား ခွေးကောင်ရိုဘော့များ ရပ်တန့်သွားပါက ပြန်လည်စတင်ပေးသည့် ကျန်းမာရေး စောင့်ကြည့်သူများ ပါဝင်သည်။ ဒေတာစုစည်းမှုများသည် dedicated Elasticsearch cluster တွင် သိမ်းဆည်းထားသည်။

ဤ ဒေတာဇယား မှားယွင်းနေသော အချက်များ

ဝန်ဆောင်မှုပေးသည့် ကုမ္ပဏီသည် ၎င်း၏ ကန့်သတ်ချက်များကို ကိုယ်တိုင် ဖော်ပြထားသည်။ ၎င်းသည် သင့်ပြဿနာနှင့် ကိုက်ညီမှုရှိမရှိ ဆုံးဖြတ်ရန် အမြန်ဆုံးနည်းလမ်းဖြစ်သည်။

• နိုင်ငံကို ခန့်မှန်းထားသည် ဆောင်းပါးတိုင်းတွင် country_source ကို ဖတ်ရှုပါ။ နိုင်ငံအလိုက် ခွဲခြမ်းစိတ်ဖြာခြင်းမဟုတ်ဘဲ စာမျက်နှာများကို ဖြန့်ကြည့်နေချိန်တွင် strict_country=true ကို ထည့်သွင်းပါ။
• published_at သည် ခွေးကောင်ရိုဘော့ ပေးသော အချက်အလက်ဖြစ်သည် နောက်ပြန်ရက်ချိန်းခြင်းသည် အများအားဖြင့် ဖြစ်တတ်သည်။ အသစ်တင်လာသော အချက်အလက်များကို စစ်ဆေးနေချိန်တွင် crawled အလိုက် စီစဉ်ပါ။
• total သည် 10,000 အထိသာ ကန့်သတ်ထားသည် အမြန်နှုန်းအတွက် ဖြစ်သည်။ total_is_lower_bound သည် သင်သည် အကန့်အသတ်သို့ ရောက်ရှိသွားကြောင်း ပြသသည်။
• sentiment သို့မဟုတ် entity extraction မပါဝင်ပါ Bitcoin block အပြင်ဘက်ရှိ ဆောင်းပါးများတွင် sentiment score သို့မဟုတ် named entity များ မပါဝင်ပါ။ ၎င်းသည် ဤစနစ်၏ scope အတွင်း မပါဝင်ပါ။
• ရက်သားပေါင်း ၉၀ သာ၊ ထို့ထက်ပိုမည်မဟုတ်ပါ အနက်ရှိုင်းဆုံး ဂျာနယ်စာအုပ် (archive) မရှိပါ။ သင်သည် ၂၀၁၉ ခုနှစ်ရှိ ဒေတာများကို လိုအပ်ပါက ဤကိရိယာသည် သင့်အတွက် မမှန်ကန်ပါ။
• SLA မရှိပါ အခမဲ့ဖြစ်သည်။ သို့သော် ၎င်းကို စောင့်ကြည့်နှင့် ကာကွယ်ထားသော်လည်း စာဖြင့် အာမခံချက်ပေးထားခြင်း မရှိပါ။
• စာသားသည် ဖြန့်ချိသူများ၏ပိုင်ဆိုင်မှုဖြစ်သည် တုံ့ပြန်ချက်တိုင်းတွင် မူလ URL ပါဝင်ပြီး၊ အသုံးပြုသူများသည် ၎င်းသို့ ချိတ်ဆက်ပေးရန် မျှော်လင့်ထားသည်။

ကောင်းမွန်စွာ အသုံးပြုခြင်း: ကုန်ကျစရိတ်၊ စာမျက်နှာခွဲခြင်းနှင့် အမှားအယွင်းများ

Token စည်းကမ်း

Agent တစ်ခုအတွက် တုံ့ပြန်မှု အရွယ်အစားသည် အမှန်တကယ် ကုန်ကျစရိတ်ဖြစ်သည်။ ၎င်း၏ မှတ်တမ်းတင်ထားသော ပုံစံမှာ -

full_text=true ဖြင့် ဆောင်းပါး ၂၀ ပုဒ်သည် ခန့်မှန်းခြေ token ၄၀,၀၀၀ ခန့်ရှိသည်။ အကြံပြုထားသော ပုံစံမှာ အမြဲတမ်း တူညီသည် - အရေအတွက်ကို ရေတွက်၊ စကင်နာပြီးမှ လိုအပ်သော အနည်းငယ်အတွက်သာ ခန္ဓာကိုယ် (body) များကို ဆွဲယူပါ။

အပေါ်ဆုံးကန့်သတ်ချက်ထက် ကျော်လွန်သော စာမျက်နှာများ

offset သည် ၉,၉၀၀ တွင် ရပ်တန့်သွားသည်။ အစုအဝေးကြီးတစ်ခုကို လိုက်လံစစ်ဆေးရန်အတွက် ထိုအပေါ်ဆုံးကန့်သတ်ချက်ကို မတိုက်ခိုက်ဘဲ အချိန်အလိုက် ခွဲထုတ်ပါ။ from/to နှင့် sort=date တို့ဖြင့် နေ့အလိုက် သို့မဟုတ် မွန်းလွယ်/ညနေလေးများတွင် မေးခွန်းများများသောအခါ နာရီအလိုက် လိုက်လံပါ။ စာရွက်စာတမ်းများတွင် နေ့တစ်နေ့လုံးကို လိုက်လံစစ်ဆေးခြင်းအကြောင်း သီးသန့်စာမျက်နှာတစ်ခု ပါရှိသည်။

အမှားအယွင်းများ

သဘောတူညီချက်သည် ရှင်းလင်းပြီး ကုဒ်ရေးရလွယ်ကူသည် - 4xx ဆိုလျှင် မေးခွန်းမှားနေသည် - ပြင်ပါ၊ ထပ်မံမကြိုးစားပါ။ 5xx ဆိုလျှင် ဝန်ဆောင်မှု ပိတ်သွားသည် - နောက်ဆုတ်ပါ။ 429 ဆိုလျှင် နှေးပါနှင့် ထပ်မံကြိုးစားပါ။ မသိရှိသော မေးခွန်း ကန့်သတ်ချက်များကို ပယ်ဖျက်မည့်အစား လျစ်လျူရှုထားသဖြင့် နယ်ပယ်တစ်ခုကို ထည့်သွင်းခြင်းသည် လက်ရှိ အသုံးပြုသူကို မပျက်စေနိုင်ပါ။

သင့်ကိုယ်ကို ခွဲခြားသတ်မှတ်ပါ (ရွေးချယ်စရာ၊ နှင့် အမှန်တကယ် ရွေးချယ်စရာ)

key မရှိပါက အသုံးပြုသူကို ရောက်ရှိရန် နည်းလမ်းမရှိပါ။ အကြံပြုထားသော ယဉ်ကျေးမှုမှာ သင့် agent ၏ အမည်၊ ၎င်းလည်ပတ်သော framework နှင့် ၎င်းကို လည်ပတ်စေသော model ကို ဖော်ပြသော header တစ်ခု ဖြစ်သည် -

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

မသိရှိသော keys များကို လျစ်လျူရှုထားသဖြင့် အပို keys များကို ပို့ခြင်းသည် အမြဲတမ်း လုံခြုံသည်။ ဘာမျှ စစ်ဆေးခြင်းမရှိပါ၊ ၎င်းကို မထည့်သွင်းခြင်းအတွက် မည်သည့်အရာကိုမျှ ကန့်သတ်ခြင်းမရှိပါ၊ နှင့် တစ်ခုတည်းသော အမိန့်မှာ အတိအကျ - ဤနယ်ပယ်များတွင် အဆုံးသတ်အသုံးပြုသူ၏ ပုဂ္ဂိုလ်ရေးအချက်အလက်များကို မထည့်ပါနှင့်။

ပေးချေသော သတင်းများ API များနှင့် ဆန့်ကျင်ဘက်

ဆိုက်ရှိ နှိုင်းယှဉ်စာမျက်နှာများသည် ယှဉ်ပြိုင်သူ ၁၁ ဦးကို တစ်ဦးချင်းစီ ဖုံးလွှမ်းထားသည်။ ၎င်းတို့အားလုံးကို ဖြတ်သန်းသွားသော တည်ဆောက်ပိုင်း ကွဲပြားမှုများ -

ပေးချေမှုဆိုင်ရာ ဝန်ဆောင်မှုများက ဤဝန်ဆောင်မှုနှင့် မတူဘဲ ပေးနိုင်သေးသော အရာများမှာ - စံသတ်မှတ်ချက်များအဖြစ် သဘောထားအမြင် အမှတ်အသားများနှင့် သဘောတရားဆိုင်ရာ ဆွဲထုတ်မှုများ၊ နှစ်ပေါင်းများစွာ ကြာရှည်ခံသော သမိုင်းကြောင်းများနှင့် SLA (Service Level Agreement) နောက်ကွယ်မှ ကတိကဝတ်တစ်ခု ပါဝင်ခြင်း။ ၎င်းတို့သည် အမှန်တကယ် ရှိသော အရာများဖြစ်ပြီး သင်အတွက် လိုအပ်ပါက ဝယ်ယူသင့်သည်။

အစားအစာ ပြုလုပ်နည်းများ

နိုင်ငံတစ်ခု၏ တိုက်ရိုက် စောင့်ကြည့်ရေး

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 ပြုလုပ်နိုင်ပြီး၊ ၉၀ ရက်တာကာလအတွင်း continuously အဆက်မပြတ် update လုပ်ပေးပါသည်။ API key လိုအပ်ခြင်း၊ signup လိုအပ်ခြင်း၊ quota ကန့်သတ်ချက်မရှိပါ (IP တစ်ခုချင်းစီ၏ rate limit သာရှိပါသည်)။ ထို့အပြင် နိုင်ငံပေါင်း ၁၁၅ နိုင်ငံအတွက် live story clustering၊ ကမ္ဘာ့ဖြစ်ရပ်များနှင့် နိုင်ငံတွင်းဖြစ်ရပ်များကို ခွဲခြားပေးသော keyword analysis၊ market instruments များနှင့် coverage volume ကို နှိုင်းယှဉ်ပြသခြင်း၊ Bitcoin sentiment ကို တိုင်းတာသော endpoint ၇ ခုပါ block၊ RSS/Atom/JSON syndication ဖြင့် query မည်သည့်တန်ဖိုးမဆိုကို ပေးဆပ်ခြင်းနှင့် service မှတဆင့် generated လုပ်ထားသော ၂၈ ခုပါ MCP server တို့ ပါဝင်ပါသည်။

၎င်းသည် ၎င်း၏ error rate များကို မှတ်တမ်းတင်ထားပြီး၊ နိုင်ငံတစ်ခုချင်းစီ၏ value များကို မည်သို့ရရှိသည်ကို ဖော်ပြပေးပြီး၊ data များ မှားယွင်းနေသည့်အကြောင်းအရာကို စာမျက်နှာတစ်ခုတွင် ထုတ်ပြန်ထားပါသည်။ တူရကီ၊ ဂရိ၊ ဟင်ဒီ စသည့် ဘာသာစကားများဖြင့် ခုနစ်အချိန်ကမ္ဘာ့သတင်းများကို သိရှိလိုသော agent တစ်ခုအတွက် ဤကဲ့သို့သော ပေါင်းစပ်မှုကို ဈေးနှုန်းမရွေး ရှာဖွေရခက်ခဲပါသည်။ ဤ service သည် အခမဲ့ဖြစ်ပါသည်။

search သည် keyword များအားလုံးအတွက် AND ချိတ်ဆက်ထားပါသည်။ သဘာဝဘာသာစကားမေးခွန်းထက် ၂-၅ ခုပါ keyword များကို အသုံးပြုပါ။

Free News API၊ ၎င်းကို မည်သို့ query ပြုလုပ်ရမည်ကို လေ့လာရန်

ဤနေရာမှ စတင်ပါ: freenewsapi.ai · freenewsapi.ai/mcp တွင် MCP · /llms-full.txt တွင် manual အားလုံးကို ဖိုင်တစ်ခုတည်းအဖြစ်။