Free News API: 21 ملین مضامین، 25,000 ناشرین اور 100 ممالک پر مکمل متن تلاش — بالکل کوئی کلید کے بغیر

خبر APIس عام طور پر فی درخواست بیچی جاتی ہیں، کلید کے پیچھے بند ہوتی ہیں، اور مفت ٹیر پر روزانہ سو درخواستوں تک محدود ہوتی ہیں۔ Free News API ان میں سے کوئی بھی چیز نہیں ہے: ایک رولنگ 90 دن کے وقفے پر 21.5 ملین مضامین، 25,000 سے زائد ناشرین، کوئی کلید نہیں، کوئی سائن اپ نہیں، کوئی کوٹہ نہیں، تجارتی استعمال کی اجازت ہے۔ یہاں پوری سطح موجود ہے — تلاش، شماریات، رجحانات، مارکیٹیں، فیڈز اور MCP — اور اس بات کا ایک سچا بیان کہ ڈیٹا کہاں غلطی کرتا ہے۔

مسئلے کی ساخت

ایک AI ایجنٹ سے پوچھیں کہ دنیا میں فی الحال کیا لکھا جا رہا ہے، اور اس کے پاس تین برے اختیارات ہیں۔ یہ براہ راست ناشرین سے اسکرپ کر سکتا ہے، جو نازک، سست اور قانونی لحاظ سے غیر واضح ہے۔ یہ ایک تجارتی خبر API کو کال کر سکتا ہے، جس کا مطلب ہے اکاؤنٹ، کلید، ماہانہ بل اور — مارکیٹ میں ہر مفت ٹیر پر — روزانہ سو درخواستیں اور مضامین میں چوبیس گھنٹے کی تاخیر۔ یا یہ تربیتی ڈیٹا سے اندازہ لگا سکتا ہے جو مہینوں پہلے رک گیا تھا۔

Free News API درمیانے آپشن کی قیمت اور کاغذی کارروائی کو ہٹا دیتا ہے بغیر اس کی صلاحیت کو ہٹائے۔ ایک GET درخواست، کوئی اسناد نہیں، ایک ایسے کورپس پر جو تحریر کے وقت 21,557,044 مضامین پر مشتمل ہے، بیس ہزار سے زائد ناشرین سے، ایک رولنگ نینتے دن کے وقفے پر رکھا گیا اور مسلسل اپ ڈیٹ کیا جاتا ہے — انڈیکس میں سب سے نیا مضمون عام طور پر دو منٹ سے بھی کم پرانا ہوتا ہے۔

چار بنیادی اینڈ پوائنٹس، اور پھر کچھ مزید

سروس کا مرکز چار GET اینڈ پوائنٹس ہیں، جو تمام https://freenewsapi.ai کے تحت ہیں، جو UTF-8 JSON واپس کرتے ہیں Access-Control-Allow-Origin: * کے ساتھ تاکہ براؤزر کوڈ انہیں براہ راست کال کر سکے، اور جو سرور سائیڈ ٹائم took_ms میں رپورٹ کرتے ہیں۔

اس مرکزی ڈھانچے کے گرد چار اور خاندانات بیٹھے ہیں، جن میں سے ہر ایک کہیں اور اپنی ذات میں ایک پروڈکٹ ہوتا: ٹرینڈز (ملک کے لحاظ سے لائیو اسٹوری کلسٹرنگ)، مارکیٹس (کوریج کے حجم کے مقابلے میں قیمت کی سیریز)، کرپٹو سینٹیمنٹ (بٹ کوائن بلاک کے سات اینڈ پوائنٹس)، اور سنڈیکیشن (ایک ہی سرچ کو RSS، Atom یا JSON فیڈ کے طور پر پیش کرنا)۔ ان سب کی تفصیل نیچے دی گئی ہے۔

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 کو عام طور پر پیچھے کی تاریخ (backdate) دیتے ہیں، لیکن کراول ٹائم پائپ لائن کے ذریعے مقرر کیا جاتا ہے اور صرف آگے کی طرف بڑھتا ہے۔

سرچ: ہر پیرامیٹر جو اہم ہے

تمام پیرامیٹرز اختیاری ہیں۔ ایک خام کال انڈیکس میں موجود تازہ ترین مضامین واپس کرتی ہے۔

کوئری

• 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، ناشر اور دن کے لحاظ سے گنتی واپس کرتا ہے، جو کہ مکمل مطابقت رکھنے والے سیٹ پر حساب کی جاتی ہے نہ کہ موجودہ صفحے پر۔ یہی وہ طریقہ ہے جس سے آپ اس پر بھروسہ کرنے سے پہلے اس کی کوریج کو ناپ سکتے ہیں۔ تحریر کے وقت بغیر کسی فلٹر کے اس کا منظر:

اہم ممالک

زبان‌های برتر

انگلیسی ۵٬۵۱۳٬۶۵۰ · اسپانیایی ۲٬۶۹۹٬۴۵۷ · روسی ۱٬۷۸۵٬۷۹۶ · ترکی ۱٬۵۰۱٬۰۰۴ · ایتالیایی ۹۹۲٬۲۰۰ · آلمانی ۷۳۳٬۶۷۷ · فرانسوی ۶۸۹٬۱۳۶ · عربی ۶۶۴٬۰۱۶ · پرتغالی ۶۳۷٬۶۰۷ · هندی ۵۶۰٬۸۴۰ · یونانی ۴۶۶٬۵۰۴ · ژاپنی ۴۲۷٬۰۸۵ · ویتنامی ۳۸۵٬۷۱۹ · رومانیایی ۳۵۸٬۷۶۶ · چینی ۳۵۲٬۷۲۰ · اوکراینی ۳۴۵٬۸۰۹ · کره‌ای ۳۳۵٬۰۷۹ · فارسی ۲۶۸٬۱۲۶ · لهستانی ۲۳۸٬۹۰۴ · بلغاری ۱۸۳٬۲۰۴.

این توزیع ارزش آن را دارد که یک لحظه به آن دقت کنید، زیرا دقیقاً برعکس آن چیزی است که بیشتر APIهای خبری به شما ارائه می‌دهند. مجموعه داده‌های معمول که انگلیسی‌محور و ایالات متحده‌محور هستند، این‌گونه نیستند: هند بر ایالات متحده پیشی دارد، ترکی بر آلمانی، و یونانی، ویتنامی، فارسی و بلغاری همگی نمایندگان شش رقمی دارند. اگر پرسش شما درباره مطبوعات غیرانگلیسی است، این یک مجموعه داده کاملاً متفاوت است.

حجم

منحنی روزانه در 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 نشان‌دهنده گستردگی است. داستانی که ۲۰۰ مقاله از ۴ رسانه دارد، نشان‌دهنده وسواس یک خبرگزاری است. داستانی که ۶۰ مقاله از ۴۰ رسانه دارد، یک رویداد است. مرتب‌سازی پیش‌فرض بر اساس publishers است و min_publishers / min_articles به شما امکان می‌دهند تا خودتان معیارها را تعیین کنید.

کہانیوں کو ایک مقررہ سیٹ سے ایک زمرہ حاصل ہوتا ہے: politics، business، markets، tech، sport، health، science، culture، crime، conflict، weather، society۔

کھڑکی قاری کا انتخاب ہے، روبوٹ کا نہیں

یہ ایک واقعی خوبصورت ڈیزائن کا فیصلہ ہے۔ ہر مضمون کو اس کی اشاعت کے وقت کے ساتھ محفوظ کیا جاتا ہے اور اسے کہانی سے منسلک کیا جاتا ہے، اس لیے کوئی بھی کھڑکی — پندرہ منٹ، ایک گھنٹہ، ایک دن، یا ایک مخصوص کیلنڈر تاریخ — صرف اسی محفوظ ڈیٹا پر ایک رینج کویری ہے۔ ایک ہی حساب کتاب ہر کھڑکی کے لیے ایک ساتھ کام کرتی ہے۔ window=15m، window=1h، window=24h، date=2026-09-01، یا واضح since/until جوڑا، سب ایک ہی انڈیکس کے خلاف بغیر دوبارہ حساب کتاب کے کام کرتے ہیں۔

کلیدی الفاظ: خبروں کے بنیادی الفاظ

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

ہر کلیدی لفظ اتنے ہی مختلف کہانیوں کے ساتھ واپس آتا ہے جو اسے استعمال کرتی ہیں، اتنے ہی مضامین جو ان کہانیوں پر مشتمل ہیں، اور — دلچسپ پہلو — کہ کتنی قومی اخبارات اسے استعمال کرتی ہیں۔ وہ آخری نمبر عالمی واقعے اور مقامی واقعے کے درمیان فرق ہے۔ ایک ایسا لفظ جو ستر ممالک میں ظاہر ہوتا ہے ایک عالمی کہانی ہے؛ ایک ایسا لفظ جو ایک ملک کی اخبارات پر غالب ہوتا ہے ایک مقامی کہانی ہے، چاہے وہاں اس کی آواز کتنی ہی بلند کیوں نہ ہو۔

کون سے ممالک لائیو ہیں

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"

یہ ایک ہی کال آپ کو ڈالر کے مقابلے میں لیرا کی قیمت اور اسی عرصے میں ترکی کی پریس کی کوریج کا حجم فراہم کرتی ہے، جو گھنٹہ وار ہم آہنگ ہے۔ ترکی کی پریس اس کورپس کا تیسرا سب سے بڑا حصہ ہے، اور اسی لیے یہ جوڑی شور کے بجائے کچھ معنی خیز پیدا کرتی ہے۔

اور ایک مکمل بٹ کوائن جذباتی بلاک

بٹ کوائن کو اس کے اپنے سات انڈپوائنٹس کا ایک خاندان ملا ہے، کیونکہ یہ وہ واحد آلہ ہے جس میں خبروں کے لہجے اور قیمت میں تبدیلی کے بارے میں مسلسل بحث ہوتی ہے لیکن اس کی پیمائش کم ہی کی جاتی ہے:

جذباتی لیبلز ایک لینگویج ماڈل سے آتے ہیں جو ہر پانچ منٹ میں تازہ کریپٹو آرٹیکلز پر چلتا ہے، ایک کیلیبریٹڈ کوائن لسٹ کے ساتھ۔ /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 نوڈ، Slack انٹیگریشن، Zapier ٹرگر یا سٹیٹک سائٹ جنریٹر میں پیسٹ کر سکتے ہیں — بغیر کسی کوڈ اور بغیر کسی کلید کے۔ یہ ایک چھوٹی فیچر ہے جو غیر پروگرامرز کے لیے ایک پوری انٹیگریشن لیئر کو خاموشی سے ختم کر دیتی ہے۔

MCP: اٹھارہ ٹولز، دو تہیں

MCP سرور ایک URL پر موجود ہے، Streamable HTTP (JSON-RPC 2.0 over POST، پروٹوکول ورژن 2025-06-18) بولتا ہے، بیچنگ کی حمایت کرتا ہے، اور — جیسا کہ یہاں باقی سب کچھ ہے — میں کوئی اتھارائزیشن اسٹیپ اور کوئی سیشن آئی ڈی نہیں ہے۔

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 ایک مختصر رہنمائی فائل — سروس کیا ہے، اس کے اینڈ پوائنٹس، اچھی طرح سے کیسے کیری (query) کریں، اور غلطیاں۔
• /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 کورپس کے اندر کیا ہے، طریقہ کار، انڈیکس اسکیما، اور ڈیٹا کوالٹی نامی ایک صفحہ جو اس ڈیٹا سیٹ میں غلطیوں کی دستاویز کرتا ہے۔
• /sources 11,668 شائع کنندگان کا ایک براؤز ایبل کیٹلاگ، جسے ملک، زبان اور ڈومین زون کے لحاظ سے فلٹر کیا جا سکتا ہے۔
• /compare NewsAPI.org، GNews.io، NewsData.io، Mediastack، Currents، TheNewsAPI، NewsCatcher، WorldNewsAPI، Perigon، APITube اور FreeNewsAPI.io کے مقابلے میں سائیڈ-بائی-سائیڈ صفحات۔

اس کے علاوہ 168 ملک کے صفحات، 121 زبان کے صفحات اور 275 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 10,000 پر محدود ہے رفتار کے لیے۔ total_is_lower_bound آپ کو بتاتا ہے جب آپ چھت پر پہنچتے ہیں۔
• کوئی سینٹیمنٹ یا اینٹیٹی ایکسٹریکشن نہیں بٹ کوائن بلاک کے باہر، آرٹیکلز میں کوئی سینٹیمنٹ اسکور نہیں ہوتا اور کوئی نامزد اینٹیٹیز نہیں ہوتی۔ یہ اسکوپ میں نہیں ہے۔
• نوے دن اور اس سے زیادہ نہیں اس سے گہرا آرکائیو کوئی نہیں۔ اگر آپ کو 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

نامعلوم کلیدوں کو نظر انداز کیا جاتا ہے، اس لیے اضافی کلیدیں بھیجنا ہمیشہ محفوظ ہے۔ کچھ بھی تصدیق نہیں کیا جاتا، اسے چھوڑنے پر کچھ بھی تھrottle نہیں کیا جاتا، اور واحد ہدایت واضح ہے: ان فیلڈز میں اینڈ یوزر کی ذاتی معلومات کبھی نہ رکھیں۔

ادائیگی شدہ خبروں 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 100 ممالک اور تقریباً 100 زبانوں میں 25,000 سے زائد ناشرین سے 21.5 ملین سے زائد خبروں کے مضامین پر مکمل متن تلاش ہے، جو 90 روز کے مسلسل چلنے والے دورانیے پر کام کرتا ہے، مسلسل تازہ کاری کے ساتھ، بغیر کسی کلید، بغیر سائن اپ اور بغیر کسی کوٹہ کے، صرف فی-آئی پی شرح کی حد تک۔ تلاش کے اوپر 115 ممالک میں براہ راست ملک وار کہانیوں کا گروہ بندی، کی ورڈ تجزیہ جو عالمی واقعات کو مقامی واقعات سے الگ کرتا ہے، 14 مارکیٹ آلات کو کوریج والیوم کے خلاف پلاٹ کیا گیا ہے، سات اینڈ پوائنٹس والا بٹ کوائن جذباتی بلاک، RSS/Atom/JSON کسی بھی کوئری کی سنڈیکیشن، اور سروس سے جنریٹ ہونے والا 28 ٹولز MCP سرور شامل ہے۔

یہ اپنی اپنی غلطی کی شرحوں کو دستاویزی بناتا ہے، ہر ملک کے ویلیو کی اخذ کی تفصیلات ظاہر کرتا ہے، اور شائع کرتا ہے کہ ڈیٹا میں کیا غلطیاں ہوتی ہیں۔ اس ایجنٹ کے لیے جسے یہ جاننے کی ضرورت ہے کہ دنیا میں کیا ہو رہا ہے — ترکی، یونان، ہندی میں — ابھی، یہ امتیاز کسی بھی قیمت پر ملنا مشکل ہے، اور یہ مفت ہے۔

تلاش تمام ٹرمز کے لیے AND (اور) پر مبنی ہے۔ قدرتی زبان کے سوال کے بجائے 2–5 کلیدی الفاظ استعمال کریں۔

Free News API، اسے اچھی طرح سے کیسے کوئری کریں

یہاں سے شروع کریں: freenewsapi.ai · freenewsapi.ai/mcp پر MCP · پورا مینوئل ایک فائل کے طور پر /llms-full.txt پر۔