Free News API: د ۲۱ ملیونه مقالو، ۲۵،۰۰۰ خپرونکو او ۱۰۰ هېوادونو په ټول متن کې لټون — په بشپړ ډول د هیڅ کلیدي پرته

خبرې APIs معمولاً د غوښتنې له مخې پلورل کیږي، د یوې کلیدي شاته پټېږي، او د وړیا پړوي په کې د ورځنيو سلو غوښتنو ته محدودې دي. Free News API د دې ټولو څخه توپیر لري: ۲۱.۵ ملیونه مقالې په یوه ۹۰ ورځني متحرک کړکېچ کې، ۲۵،۰۰۰ څخه زیات خپرونکي، هیڅ کلیدي، هیڅ ننوتل، هیڅ کواتا، او د سوداګریزې کارونې اجازه. دلته ټوله سطحه شتون لري — لټون، احصایې، ټرینډونه، بازارونه، فیډونه او MCP — او یو صادقانه حساب چې څنګه ډاټا غلطۍ کوي.

د ستونزې بڼه

که یو AI ایجنټ ته وپوښتئ چې نړۍ اوس څه لیکي، نو درې خرابې انتخابونه لري. دا کولی شي مستقیماً له خپرونکو څخه ډاټا راټول کړي، چې نازک، ورو او قانوني پلوه نامعلوم دی. دا کولی شي یوه سوداګریزه خبرې API وکاروي، چې پدې معنی ده چې یو حساب، یو کلیدي، میاشتنی بل او — په بازار کې د هر وړیا پړوي په کې — د ورځنيو سلو غوښتنو او د مقالو د ۲۴ ساعتونو ځنډ لري. یا دا کولی شي د روزنې ډاټا څخه اټکل وکړي چې میاشتې مخکې پای ته رسیدلې.

Free News API د منځني انتخاب بیه او کاغذونه لرې کوي پرته له دې چې وړتیا یې له منځه یوسي. یوه GET غوښتنه، هیڅ اعتبار، د یوې کورپس په سر چې د لیکلو په وخت کې ۲۱،۵۵۷،۰۴۴ مقالې له ۲۵،۰۰۰ څخه زیاتو خپرونکو له خوا لري، چې په یوه متحرک ۹۰ ورځني کړکېچ کې ساتل کیږي او په دوامداره توګه تازه کیږي — په انډیکس کې ترټولو نوې مقاله معمولاً د دوو دقیقو څخه کمه پخوانۍ ده.

څلور اصلي پایپونټونه، او نور هم

د خدمت هسته څلور GET پایپونټونه دي، ټول یې د https://freenewsapi.ai لاندې دي، ټول یې UTF-8 JSON بیرته ورکوي چې Access-Control-Allow-Origin: * سره دی ترڅو د براوزر کوډ کولی شي یې مستقیماً وکاروي، او ټول یې د سرور اړوند وخت په took_ms کې راپور ورکوي.

د دې اصلي هستې شاوخوا څلور نورې ډلې شتون لري، چې هر یو به په بل ځای کې یو محصول وي: تrends (د هیوادونو پر بنسټ د خبرو ګروپونه)، markets (د قیمت لړۍ چې د پوښښ حجم سره مطابقت لري)، crypto sentiment (د بیتکوین بلاک په اړه د درېیو پایتونو ټولګه)، او 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"
    }
  ]
}

په دې ځواب کې درې ځانګړتیاوې شتون لري چې سمدلاسه پام ته اړتیا لري، ځکه چې دوی د ټول ډیټاسټ لیکینه (honesty) ښیي. total_is_lower_bound تاسو ته ښیي کله چې د مطابقت شمېر د ۱۰،۰۰۰ پورې رسېږي او نور شمېرنه نه کوي. country_source ښیي څنګه هیواد ټاکل شوی — ځکه چې په هر خبري ډیټاسټ کې د هیواد ارزښتونو ډېره برخه اټکلونه دي، نه حقایق. او crawled_at باوري وخت نښه ده: خپرونکي published_at په معمول ډول شاته نیسي، خو د ګرځیدو (crawl) وخت د پайپ لاین لخوا ټاکل کیږي او یوازې مخکې ځي.

لټون: هغه پیرامیټرونه چې اهمیت لري

ټول پیرامیټرونه اختیاري دي. یو ساده بلګ (call) د انډیکس تر ټولو وروستي مقالې بیرته راوړي.

پوښتنه (Query)

• q د سرلیک (وزن ۳)، تشریح (وزن ۲) او د مقالې متن سره مطابقت لري. AND منطق — هر اصطلاح باید شتون ولري، نو د یوې کلمې اضافه کول پراخوالی کموي، نه یې زیاتوي. اعظمي ۵۰۰ کاراکټرونه.

فلټرونه

فلټرونه د 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، خپورونکي او ورځې له مخې شمېرې بیرته راستونوي، چې د ټول مطابقت لرونکي سیټ پر بنسټ محاسبه شوي دي نه د اوسني پاڼې پر بنسټ. دا هغه ډول دی چې تاسو پکې پوښښ اندازه کوئ مخکې له دې چې باور وکړئ. د لیکلو په وخت کې بې فیلټه Snapshot:

غوره هېوادونه

غوره ژبې

انګلیسي ۵٬۵۱۳٬۶۵۰ · سپانيالي ۲٬۶۹۹٬۴۵۷ · روسي ۱٬۷۸۵٬۷۹۶ · ترکی ۱٬۵۰۱٬۰۰۴ · ایتالياني ۹۹۲٬۲۰۰ · الماني ۷۳۳٬۶۷۷ · فرانسوي ۶۸۹٬۱۳۶ · عربي ۶۶۴٬۰۱۶ · پرتګالي ۶۳۷٬۶۰۷ · هندي ۵۶۰٬۸۴۰ · یوناني ۴۶۶٬۵۰۴ · جاپاني ۴۲۷٬۰۸۵ · ویتنامي ۳۸۵٬۷۱۹ · روماني ۳۵۸٬۷۶۶ · چيني ۳۵۲٬۷۲۰ · اوکرایني ۳۴۵٬۸۰۹ · کوري ۳۳۵٬۰۷۹ · فارسي ۲۶۸٬۱۲۶ · پولنډي ۲۳۸٬۹۰۴ · بلغاري ۱۸۳٬۲۰۴.

دا ویش د یوې شیبې لپاره د پام وړ دی، ځکه دا د ډیری خبریال APIو لخوا ورکړل شوي معلوماتو سره مخالف دی. هغه معمول انګلیسي-لومړی، امریکايي-لومړی متن د دې سره توپیر لري: هند د امریکایي متحده ایالاتو څخه لوړ رتبه لري، ترکی د الماني څخه لوړ رتبه لري، او یوناني، ویتنامي، فارسي او بلغاري ټول شپږ رقمي استازیتوب لري. که ستاسو پوښتنه د غیر انګلیسي پریس په اړه وي، دا یو materially توپیر لرونکی ډیټاسیټ دی.

حجم

د by_day په اړه ورځنی منحنی د نوي څلوېښت ورځو پوښښ لري. وروستي ورځې د نږدې ۴۰۰،۰۰۰ څخه تر ۷۰۰،۰۰۰ پورې مقالې په ورځ کې موقعیت لري؛ د وینډو په پیل کې، د RSS پوړ د آرشیو د جذب سره یوځای اضافه کیدو دمخه، ورځنی حجم د ۱۳۰،۰۰۰–۲۳۰،۰۰۰ په کچه و. دواړه شمیرې په یوه ځواب کې ښکاره دي، چې هدف یې دا دی — خدمت تاسو ته د خپل پراختیا ښیي، نه د یو مارکیټینگ اوسط 引用.

میلان: پریس اوس څه پوښښ کوي

لټون ځوابونه "د 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 پراخوالی دی. یوه کیسه چې ۲۰۰ مقالې له ۴ خپرونکو څخه لري د یو خبري ادارې لېوالتیا ده. یوه کیسه چې ۶۰ مقالې له ۴۰ خپرونکو څخه لري یوه پیښه ده. پیش فرض ترتیب د خپرونکو پر بنسټ دی، او min_publishers / min_articles تاسو ته اجازه درکوي چې خپله معیار ټاکئ.

دا کیټګوري له یو ثابت سیټ څخه راوړي: politics، business، markets، tech، sport، health، science، culture، crime، conflict، weather، society.

د کړکۍ (window) انتخاب د لوستونکي حق دی، نه د روبوټ.

دا یوه خورا ښکلې ډیزاین پرېکړه ده. هر مقاله د خپریدو په وخت کې ذخیره کیږي او د هغې کیسې سره نښلول کیږي، نو هر کړکۍ — دویږی دقیقې، یوه ساعت، یوه ورځ، یا یو ځانګړی تقویمي نیټه — یوازې د ورته ذخیره شوي ډاټا په یوه رینج پوښتنه (range query) ده. یوه محاسبه د ټولو کړکیو لپاره په یو وخت کې کار کوي. window=15m، window=1h، window=24h، date=2026-09-01، یا یو ځانګړی since/until جوړه د ورته انډیکس پر بنسټ د بیا محاسبې پرته کار کوي.

کلیمې (Keywords): هغه کلمې چې خبرونه پر بنسټ یې جوړ شوي دي

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

هره کلیمه داسې بیرته راځي چې څو جلا کیسې یې لري، څو مقالې هغه کیسې لري، او — چې زړه راښکونکی دی — څو ملي مطبوعات یې کاروي. دا وروستی شمېره د نړیوالې پیښې او داخلي پیښې ترمنځ توپیر دی. یوه کلمه چې په څلوېښتو هیوادونو کې راڅرګنده کیږي یوه نړیواله کیسه ده؛ یوه کلمه چې د یو هیواد مطبوعات تسلط کوي یوه داخلي کیسه ده، که څه هم هلته ډیره غږیزه وي.

کوم هیوادونه ژوندی (live) دي

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

ټول تعقیب شوي هیوادونه د هغوی د ژوندیو کیسو شمېر او څو دقیقې مخکې بیا محاسبه شوي و — ترکیه، روسیه، ایران، یونان، هند، ایټالیا، اوکراین، رومانيا، ارجنټاین، المان او برازیل اوس مهال هر یو یې په زرګونو ژوندی کیسې لري، چې د تیرو لسو دقیقو په موده کې بیا محاسبه شوي دي. او /v1/trends/{cc}/{slug} هر یوه کیسه د هغې د بشپړ مقالې لیست سره خلاصوي.

بازارونه په مقابل کې پوښښ: قیمت په یوه محور کې، پام په بل کې

دا په خدمت کې تر ټولو غیر معمولي څه دی، او دا شتون لري ځکه چې د ټولګې (corpus) له امله د جوړولو نږدې وړیا دی. د قیمت یو لړۍ د هغه شی په اړه نړۍ څومره لیکلي، په هغو ورته ساعتونو کې، په یوه ټایم لاین کې ایږدئ.

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

څوارلس وسایلو (instruments) تعقیب کیږي، د څلورو داراییو ډولونو په اوږدو کې:

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

دا یو ځانګړی غږ تاسو ته د ډالرو په مقابل کې د ترکیې لیرې (لیرې) او د همدې مودې لپاره د ترکیې د مطبوعاتو پوښښ حجم ورکوي، چې هر ساعه سره سمون لري. ترکیه‌يي مطبوعات د دې ټولګې دریم لوی برخه جوړوي، چې همدا دلیل دی چې دا جوړښت څه معنی لرونکی تولیدوي نه چې غږ.

او د بیتکوین د احساساتو بشپړ بلاک

بټکویین د ځانګړو څلور واړه پای ټکونو (endpoints) کورنۍ ترلاسه کوي، ځکه دا یوازنی وسیله ده چې د خبرونو د غبرګون او بیه کې بدلون په اړه تل بحث کیږي، خو نادره ځله اندازه کیږي:

د احساس لیبلونه د یوې ژبې ماډل څخه راځي چې هر پنځه دقیقې وروسته تازه کرېپټو مقالې په یوه تنظیم شوي سیکوینسي لیست کې ګوري. که تاسو هیڅکله غوښتنه «خبره حرکت رامنځته کوي» ازموینې ته اړتیا لرل، نو /v1/btc/correlation د max_shift پیرامیټر سره هغه څه دي چې تاسو یې ته اړتیا لرئ، نه یوازې د هغې تکرار.

همه لټون، د یوې فیډ په توګه

درې نور پای ټکونه ورته لټون پیرامیټرونه اخلي او پایلې د JSON پر ځای د ساینډیکیشن فارمیټونو په توګه وړاندې کوي:

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

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

دا پدې مانا ده چې هر خوندي شوی لټون یوه فیډ کیږي چې تاسو کولی شئ یې په لوستونکي، n8n نود، د سلیک انټیګریشن، د زاپیر ټریګر یا یو سټاټیک سایټ جنریټر کې ځای پر ځای کړئ — پرته له کوم کوډ او کلیدي. دا یوه کوچنۍ ځانګړتیا ده چې د غیر پروګرامرونو لپاره د یو بشپړ انټیګریشن پوړ په پټه لرې کوي.

MCP: څوېښتمې اوزارې، دوه پوړونه

MCP سرور په یوه URL کې پروت دی، د Streamable HTTP (JSON-RPC 2.0 د POST له لارې، د پروتوکول نسخه 2025-06-18) خبرې کوي، د ګروپ کولو ملاتړ کوي، او — لکه ټول نور دلته — د مجازیت ګام او سیشن 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 ټوله اسناد په یو ساده متن فایل کې، چې له سلو کیلوبایتونو ډېر حجم لري، ترڅو یو ایجنټ (agent) کولی شي ټول لارښود په یوه ځل کې په بشپړ ډول واخلي.
• /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 د ټولګې (corpus) دننه څه شته، میتودولوژي، د انډیکس شمېلا، او یوه پاڼه چې د ډاټا کیفیت په نوم ده او ښیي چې ډاټاسټ څه تېروتنې کوي.
• /sources د ۱۱،۶۶۸ ناشرانو یو لیدل کیدونکی کټالوګ، چې د هېواد، ژبې او ډومین زون پر بنسټ ویشل کیدی شي.
• /compare د NewsAPI.org، GNews.io، NewsData.io، Mediastack، Currents، TheNewsAPI، NewsCatcher، WorldNewsAPI، Perigon، APITube او FreeNewsAPI.io سره پرتله کوونکي پاڼې.

په دې کې ۱۶۸ د هیوادونو پاڼې، ۱۲۱ د ژبو پاڼې او ۲۷۵ د TLD پاڼې شاملې دي — هر یو د ټولې ډیټا یوه برخه لپاره د لټون وړ سطحه ده چې ښیي په هغه کې څه شتون لري.

مقالې څخه راځي

دوه د جذب لارې ورته انډیکس ډکوي، او د دوی ترمنځ توپیر مهم دی.

د آرشیف لاره

هر څلورسره دقیقې یو کار د Common Crawl د CC-NEWS آرشیف لپاره د نوي WARC فایلونو لپاره ګوري او هر هغه څه پروسس کوي چې یې مخکې نه وي لیدلي، د څلویښت موازي کارکوونکو په کارولو سره. استخراجونکی هر مقاله د خام ګرځیدو څخه د هر فیلد لپاره د ثبت شوي کاسکید سره اخیستل کیږي — او کاسکیدونه د ریښتیني ډیټا سره اندازه شوي و نه چې فرض شوي وي:

دا هغه ځایي شمېره ده چې په رښتیا باور وړ ده، او همدا لامل دی چې country_source په هره مقاله کې ښودل کیږي: نږدې یو پنځمه برخه ریکارډونه هیڅ باور وړ ځایي نښه نلري، او شاوخوا درېیمه برخه هغه ارزښتونه چې شتون لري، اټکل دي نه حقیقت. API تاسو ته ښیي چې کوم یو کوم دی، پر دې ځای چې ښکاره کړي.

ژوندی لاره

یو بل روبات د خپرونکي RSS فډونه هر پنځه دقیقې وروسته څیړي، په یوه دوران کې د شرایطو غوښتنو سره — یو فډ چې 304 Not Modified ځواب ورکوي نږدې هیڅ لګښت نلري، او د هر فډ د څیړنې وقفه د دې په ډول تنظیمه شوې چې څو ځله خپریږي. یوه خپرونه چې په یوه ورځ پنځه مقالې خپروي، هر څلورساعته نه ټولېږي.

هغه یوازې هغه څه اخلي چې خپرونکي په فډ کې ایښي دي: سرلیک، لومړنی پاراګراف، او بشپړ متن کله چې فډ یې لري. هغه د خپرونکي ویبپاڼې ته نه ځي ترڅو نور څه ترلاسه کړي. دا یو پام وړ حد دی، او همدا لامل دی چې خدمت هغه وعده کولی شي چې د خپرونکي له مخې یې په قانوني پاڼه کې کوي.

او د هغوی شاوخوا ماشینري

د دواړو د جذب لارو شاوخوا دوه ډوزنه نور روباتونه په وختونو کې ولاړ دي: د سرچینې کشف او همغږي، د هر ډومین لپاره ځایي حل، د ټرنډ جوړول او څارنه، د کلیمې بیا ډکول، د کریپټو احساسات، د بازار کششونه، یو ټاکسونومي کټالوګ، ساتنه (د نود ورځو کړکېچ د published_at په یوه شپني څیړنه پلي کیږي، نه د انډیکس عمر)، د ورځې تایید، د خالي مقالې بیا څارنه، او یو روغتیا ساتونکی چې هر هغه څه بیا پیل کوي چې دریدلي دي. کورپس یو ځانګړي Elasticsearch ټولګي ته اړوند دی.

دا ډیټاسټ څه غلط کوي

خدمت خپل محدودیتونه خپروي، چې تر ټولو چټکه لاره ده چې وګورئ ایا دا ستاسو د ستونزې لپاره مناسب دی که نه.

• ځایي اټکل شوی دی په هره مقاله کې country_source ولولئ، او strict_country=true اضافه کړئ کله چې تاسو د ځایونو له مخې شمېرنه کوئ، نه څیړنه.
• published_at د خپرونکي لخوا وړاندې شوی دی شاته نیول عام دي. کله چې تاسو د نوي څه لپاره څیړنه کوئ، د crawled پر بنسټ ترتیب کړئ.
• ټولیز شمېر په ۱۰،۰۰۰ پورې محدود دی د سرعت لپاره. total_is_lower_bound تاسو ته ښیي کله چې تاسو د سقف سره مخ کیږئ.
• هیڅ احساس یا د موجودیت استخراج نشته د بیتکوین بلاک څخه بهر، مقالې هیڅ احساسي نمره او هیڅ نومول شوي موجودیتونه نلري. دا د ساحې څخه بهر دی.
• نولې ورځې او نور نه دلته ژور آرشیف نشته. که تاسو ته ۲۰۱۹ کلن معلوماتو ته اړتیا وي، دا سمه وسیله نه ده.
• هیڅ SLA نشته دا وړیا دی. دا څارنه کیږي او ساتنه کیږي، خو په لیکلي ډول هیڅ وعده نشته.
• متن د خپرونکو ملکیت دی هر ځواب اصلي URL پکې شاملوي، او ډالرو ته تمه ده چې بیا یې ته لینک ورکړي.

د کارولو ښه طریقه: لګښت، پاڼې او تېروتنې

د ټوکن نظم

د یو ایجینټ لپاره، د ځواب اندازه اصلي لګښت دی. د هغه ثبت شوی شکل:

دوه لس مقالې د full_text=true سره نږدې ۴۰،۰۰٠ ټوکنونه دي. وړاندیز شوی نمونې تل یو شان دی: شمېرل، سکون، بیا یوازې هغو لږو لپاره چې تاسو یې اړین دي، متن راوړئ.

له سقف څخه پورته پاڼه کول

offset په ۹،۹۰۰ کې درېږي. د یو لوی سیټ لپاره، له سقف سره جګړه مه کوئ — د وخت پر بنسټ یې ویشئ. په ورځني ډول یا په ګرمه پوښتنه کې په ساعتني ډول حلقه جوړه کړئ، د 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 د ۲۱.۵ ملیونو خبري مقالو په ټول متن باندې د لټون یوه خدمت دی چې له ۲۵،۰۰۰ څخه زیاتو ناشرینو څخه په ۱۰۰ هېوادونو او نږدې ۱۰۰ ژبو کې ترلاسه کیږي. دا خدمت د ۹۰ ورځو په یوه روانه کړکېچ (rolling window) کې کار کوي چې په دوامداره ډول تازه کیږي، پرته له هر ډول کلیدي (key)، پرته له ثبت (signup) او پرته له هر ډول محدودیت څخه یوازې د IP پر بنسټ د نرخ محدودیت شتون لري. د دې لټون پر سر، په ۱۱۵ هېوادونو کې د ژوندیو کیسټونو ډلبندي، د کلیمو تحلیل چې د نړیوالو پیښو او داخلي پیښو جلا کوي، د څلورده بازار وسایلو پلټنه د پوښښ حجم سره، د بیتکوین احساس د څو برخو بلاک، RSS/Atom/JSON د هرې پوښتنې لپاره ساینډیکیشن، او د خدمت له خوا تولید شوی د ۲۸ وسایلو MCP سرور شامل دی.

دا خدمت خپل د تېروتنې کچه ثبتوي، ښیي چې د هر هېواد ارزښت څنګه استخراج شوی، او یوه پاڼه خپروي چې ښیي ډاټا څنګه غلطۍ کوي. د یو ایجنټ لپاره چې اړتیا لري پوه شي په نړۍ کې څه ویل کیږي — په ترکیي، په یوناني، په هندي، اوس مهال — دا ترکیب په هر بیه کې موندل ستونزمن دی، او دا خدمت وړیا دی.

لټون د ټولو کلیمو لپاره AND دی. د طبیعي ژبې پوښتنې پرځای ۲-۵ کلیمې وکاروئ.

Free News API، د ښه پوښتنې کولو لپاره

دلته پیل وکړئ: freenewsapi.ai · MCP په freenewsapi.ai/mcp · ټول لارښود په یوه فایل کې د /llms-full.txt په بڼه.