From 1 November 2026 the API needs a free key. Calls without one work until then. Get a key · what changes
FA
EnglishУкраїнськаEspañolPortuguêsDeutschFrançaisItalianoPolskiNederlandsSvenskaDanskNorskSuomiČeštinaRomânăMagyarΕλληνικάTürkçeالعربيةעבריתفارسیहिन्दीবাংলাIndonesiaMelayuTiếng Việtไทย日本語한국어中文
وروددریافت کلید API

سوالات متداول

آیا واقعاً رایگان است؟

طرح رایگان رایگان است. یک کلید دریافت کنید و این را اجرا کنید:

bash
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=test&size=1"

پلن رایگان 3,000 درخواست در ماه و 120 درخواست در دقیقه دارد. کلیدها از تاریخ 2026 نوامبر 1 الزامی هستند.

نکته پنهان چیست؟

سه، به صراحت بیان شده است. پنجره 90 روزه است، نه سال‌ها. هیچ تعهد سطح خدمات (SLA) وجود ندارد. و هیچ تحلیل احساسات یا استخراج موجودیت وجود ندارد — رقبا بابت این موارد هزینه دریافت می‌کنند و ما هنوز آن‌ها را نداریم. لیست کامل نقاط ضعف ما.

آیا می‌توانم از آن به‌صورت تجاری استفاده کنم؟

بله، بدون ارتقا و بدون نیاز به مجوز. توجه داشته باشید که NewsAPI.org و GNews استفاده تجاری را در لایه‌های رایگان خود صرف‌نظر از حجم ممنوع می‌کنند — بررسی کنید که در جای دیگر چه چیزی را می‌پذیرید.

هنگام نمایش محتوا به یک شخص، به مقاله اصلی url لینک دهید. این کار ناشر است.

داده‌ها از کجا می‌آیند؟

آرشیوهای خبری عمومی در مقیاس بزرگ: مجموعه‌های انباهی از صفحات خبری که از قبل خزیده شده‌اند و به صورت پیوسته منتشر می‌شوند. ما هر انتشار را پردازش کرده و نتیجه را نمایه می‌کنیم. اطلاعات بیشتر درباره منابع.

تا چه حد به‌روز است و چگونه می‌توانم این موضوع را تأیید کنم؟

مخزن داده در طول روز به صورت پیوسته به‌روز می‌شود. هر دسته ورودی روی نقشه‌ها با نام فایل، تعداد مقالات و زمان انتشار منتشر می‌شود، در حالی که وضعیت و /health وضعیت زنده سرویس را نشان می‌دهند. بنابراین می‌توانید تازگی داده‌ها را خودتان اندازه‌گیری کنید و به نشان تبلیغاتی که ادعای زمان واقعی دارد اعتماد نکنید.

چرا فقط 90 روز؟

همان چیزی است که بدون تبدیل شدن به مرکز هزینه، در فضای قابل ارائه ما می‌گنجد. این معامله به شما پلن رایگان را خریداری کرده است. اگر به آرشیو نیاز دارید، آرشیو را بخرید — NewsData.io و Perigon سال‌ها آرشیو دارند.

آیا متن کامل مقاله را دریافت می‌کنم؟

بله، با full_text=true و بدون هزینه. هر رقیبی متن کامل را پشت یک لایه پولی قرار می‌دهد. متن‌ها بزرگ هستند — قبل از درخواست ده‌ها مورد، هزینه توکن را بررسی کنید.

کدام ناشران پوشش داده می‌شوند؟

شاخص فعلی شامل مطالب از 25,000+ ناشر است که در یک روز معمولی چند هزار مورد فعال هستند. پوشش خبری بر اساس آنچه آرشیوهای عمومی و خواننده‌های فید ما ثبت کرده‌اند است؛ گسترده است اما لیست تضمین‌شده‌ای برای هر رسانه خاص نیست. برای بررسی نام میزبان قبل از طراحی بر اساس آن، از دایرکتوری ناشران و تجزیه و تحلیل منابع استفاده کنید.

چرا فیلد کشور گاهی اشتباه است؟

زیرا استنتاج می‌شود و ما به شما می‌گوییم چگونه. country_source نشان می‌دهد که آیا از دامنه با کد کشور (مطمئن)، نشانه‌گذاری خود ناشر (مطمئن)، تگ محلی (معمولاً درست) یا پیش‌فرض قالب en-US (نامطمئن) آمده است. برای تحلیل سطح کشور، strict_country=true را اضافه کنید. توضیح کامل.

آیا می‌توانم نتایج را بر اساس مرتبط بودن به جای تاریخ دریافت کنم؟

بله: sort=relevance. پیش‌فرض date است زیرا بیشتر کاربران به دنبال جدیدترین نتایج هستند. هنگام استفاده از polling از sort=crawled استفاده کنید؛ زیرا ناشران زمان انتشار را به عقب برمی‌گردانند، اما زمان خزیدن همیشه رو به جلو است.

چگونه یک روز کامل را دریافت کنم؟

بر اساس زمان تقسیم کنید. سقف آفست 9,900 است و یک روز حدود 110,000 خبر دارد. حلقه در صفحه‌بندی قرار دارد.

آیا سرور MCP وجود دارد؟

بله. سرور در مسیر /mcp قرار دارد و از پروتکل Streamable HTTP همراه با کلید API شما استفاده می‌کند. ابزارهای دسته‌بندی‌شده‌ای برای جستجوی اخبار، روندها، ناشران و بازارها، به همراه ابزارهای تولیدشده از رویپایه OpenAPI را در اختیار می‌گذارد. /mcp.json فهرست ابزارها را به صورت قابل‌خواندن برای ماشین برمی‌گرداند و راهنمای MCP نحوه پیکربندی کلاینت را نشان می‌دهد.

آیا SDK دارید؟

خیر، و نیازی به آن ندارید. چهار نقطه پایانی GET است که JSON برمی‌گردانند. هر کلاینت HTTP در هر زبانی SDK است. مثال‌ها در شروع سریع.

اگر به بیش از طرح رایگان نیاز دارم چه؟

به پلن‌ها مراجعه کنید یا بپرسید. اگر در حال صادرات دسته‌جمعی هستید، راه بهتری از 100,000 درخواست HTTP وجود دارد.

آیا مرا ردیابی می‌کنید؟

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

من یک ناشر هستم و می‌خواهم سایت من حذف شود.

به ما بنویسید و انجام می‌شود، بدون بحث. جزئیات.