News - Multi Source Real Time News Aggregation API

📰 API-News — API اخبار جهانی لحظه‌ای

🌍 یک API؛ هزاران خبر؛ امکانات بی‌نهایت

API-News یک API قدرتمند، آماده استفاده در محیط Production و جامع برای جمع‌آوری اخبار است که به اپلیکیشن‌های شما امکان می‌دهد اخبار تازه، ساختاریافته و قابل جست‌وجو را از منابع مختلف، تنها از طریق یک API یکپارچه دریافت کنند.

به‌جای اینکه برای هر سرویس خبری یکپارچه‌سازی جداگانه انجام دهید و چندین Provider را به‌صورت مستقل مدیریت و نگهداری کنید، API-News یک رابط یکپارچه برای کشف، جست‌وجو، فیلتر، پایش و دریافت اخبار در اختیار شما قرار می‌دهد.

API-News داده‌های منابع مختلف را جمع‌آوری کرده، اطلاعات مقالات را استانداردسازی می‌کند، اخبار تکراری را حذف می‌کند، نتایج را رتبه‌بندی می‌کند و امکانات قدرتمندی برای جست‌وجو، فیلتر و کشف اخبار در اختیار توسعه‌دهندگان قرار می‌دهد.

✨ چرا API-News متفاوت است؟

🔹 🌐 جمع‌آوری از چندین منبع — اخبار منتشرشده توسط منابع مختلف را تنها با یک API دریافت کنید.

🔹 ⚡ اخبار تازه و به‌روز — جدیدترین اخبار در دسترس را از Providerهای پشتیبانی‌شده دریافت کنید.

🔹 🧹 حذف خودکار اخبار تکراری — اخبار مشابه منتشرشده توسط منابع مختلف را شناسایی و مدیریت کنید.

🔹 🎯 فیلترهای قدرتمند — اخبار را بر اساس کشور، زبان، دسته‌بندی، Provider، منبع، تاریخ و موارد دیگر فیلتر کنید.

🔹 🔎 جست‌وجوی پیشرفته — در منابع مختلف جست‌وجو کنید و نتایج را با فیلترهای متنوع محدود کنید.

🔹 🔥 اخبار فوری و ترند — فیدهای خبری لحظه‌ای و سیستم‌های هشدار خبری بسازید.

🔹 🏢 پایش شرکت‌ها — اخبار مرتبط با شرکت‌ها و سازمان‌ها را دنبال کنید.

🔹 📈 اخبار مالی — اخبار مرتبط با نمادهای بورسی را دریافت کنید.

🔹 🌍 پوشش جهانی — به اخبار بین‌المللی، منطقه‌ای و محلی دسترسی داشته باشید.

🔹 🌎 پشتیبانی از چند زبان — محتوای مقالات را به زبان موردنظر دریافت کنید.

🔹 🖼️ غنی‌سازی اختیاری اطلاعات — اطلاعات تکمیلی مانند تصویر و متادیتای مقاله را دریافت کنید.

🔹 📊 JSON استاندارد و یکپارچه — پاسخ‌هایی با ساختار ثابت و مناسب برای وب‌سایت‌ها، داشبوردها، اپلیکیشن‌های موبایل و سیستم‌های هوش مصنوعی.

---

💡 API-News برای چه پروژه‌هایی مناسب است؟

API-News برای توسعه‌دهندگانی طراحی شده است که در حال ساخت موارد زیر هستند:

📰 اخبار و رسانه

• 🗞️ وب‌سایت‌های خبری
• 📱 اپلیکیشن‌های خبری موبایل
• 📰 خبرخوان‌های شخصی‌سازی‌شده
• 🚨 پلتفرم‌های اخبار فوری
• 📺 داشبوردهای خبری

🤖 هوش مصنوعی و اتوماسیون

• 🤖 دستیارهای هوشمند خبری
• 🧠 اپلیکیشن‌های RAG
• 🪄 Agentهای هوش مصنوعی
• ✍️ سیستم‌های تولید محتوای خودکار
• 📚 دستیارهای تحقیقاتی
• 📰 سیستم‌های خلاصه‌سازی اخبار با هوش مصنوعی

💰 امور مالی و بازارهای سرمایه

• 📈 داشبوردهای اخبار سهام
• 💹 سیستم‌های تحلیل و هوش بازار
• 🏦 اپلیکیشن‌های مالی
• 📊 پلتفرم‌های تحقیق و تحلیل سرمایه‌گذاری
• 🔔 سیستم‌های پایش بازار

📣 بازاریابی و کسب‌وکار

• 👀 پایش برند
• 🕵️ پایش رقبا
• 📢 پایش اخبار و روابط عمومی
• 📊 تحلیل و پایش صنعت
• 🔎 تحقیق درباره ترندها
• 📝 تحقیق و جمع‌آوری اطلاعات برای تولید محتوا

⚙️ اتوماسیون

• 📧 خبرنامه‌های خودکار
• 📱 سیستم‌های تولید و انتشار محتوای شبکه‌های اجتماعی
• 🔔 سیستم‌های هشدار خبری
• 📰 خلاصه‌های روزانه اخبار
• 🔄 سیستم‌های اتوماسیون محتوا

---

🌟 قابلیت‌های کلیدی

🌐 جمع‌آوری اخبار از چندین منبع

اخبار منابع مختلف را از طریق یک API یکپارچه دریافت کنید.

معماری فعلی Providerها از منابعی مانند Google News، BBC، The Guardian، NYT، Al Jazeera، NPR، Deutsche Welle، France 24، CNBC، Sky News، Wikipedia Current Events، Reddit و همچنین Providerهای مبتنی بر API پشتیبانی می‌کند.

---

⚡ دریافت جدیدترین اخبار

جدیدترین اخبار موجود را از منابع پشتیبانی‌شده دریافت کنید.

GET /api/v1/latest

مثال

/api/v1/latest?country=us&pageSize=20

همچنین می‌توانید با استفاده از پارامتر q، فید اخبار را روی یک موضوع یا عبارت مشخص متمرکز کنید.

---

🔥 اخبار فوری

جدیدترین و فوری‌ترین اخبار منتشرشده را دریافت کنید.

GET /api/v1/breaking

این Endpoint برای موارد زیر بسیار مناسب است:

🚨 هشدارهای اخبار فوری 📱 اپلیکیشن‌های لحظه‌ای 📺 داشبوردهای زنده خبری 🤖 سیستم‌های پایش خودکار

این Endpoint بر پوشش خبری بسیار جدید، از جمله اخبار منتشرشده در بازه زمانی اخیر مانند یک ساعت گذشته، تمرکز دارد.

---

📈 اخبار ترند و پربازدید

اخباری را پیدا کنید که در حال حاضر توجه زیادی را به خود جلب کرده‌اند.

GET /api/v1/trending

از این Endpoint برای ساخت موارد زیر استفاده کنید:

🔥 بخش اخبار ترند 📱 فیدهای Discover 📰 صفحات اخبار محبوب 🤖 سیستم‌های تشخیص ترند

---

🗞️ مهم‌ترین اخبار

مهم‌ترین اخبار مربوط به یک نسخه یا کشور مشخص را دریافت کنید.

GET /api/v1/top

مثال

/api/v1/top?country=us

---

🔎 جست‌وجوی قدرتمند اخبار

در میان منابع خبری موجود جست‌وجو کنید.

GET /api/v1/search

مثال

/api/v1/search?q=artificial+intelligence

می‌توانید جست‌وجو را با پارامترهای مختلف ترکیب کنید:

• 🌍 country — کشور
• 🗣️ lang — زبان
• ⏱️ when — بازه زمانی
• 📅 from — تاریخ شروع
• 📅 to — تاریخ پایان
• 🎯 sortBy — نحوه مرتب‌سازی
• 🔌 providers — Providerهای موردنظر
• 📰 sources — منابع خبری
• 🚫 excludeSources — منابعی که باید حذف شوند
• 🌎 translate — ترجمه محتوا
• 🖼️ enrich — غنی‌سازی اطلاعات
• 📄 page — شماره صفحه
• 📊 pageSize — تعداد نتایج در هر صفحه

🎯 جست‌وجو بر اساس میزان ارتباط

sortBy=relevance

گزینه‌ای مناسب برای:

🔎 تحقیقات 🧠 کشف محتوا 📚 جمع‌آوری اطلاعات

🕐 نمایش جدیدترین اخبار در ابتدا

sortBy=publishedAt

مناسب برای فیدهای خبری لحظه‌ای و به‌روز.

---

🧠 کشف اخبار مرتبط

🔍 کشف پوشش خبری

GET /api/v1/discover

اخبار و پوشش‌های مرتبط با یک موضوع را پیدا کنید.

🔗 اخبار مرتبط

GET /api/v1/related

مثال

/api/v1/related?q=Federal+Reserve+interest+rates

مناسب برای:

🧠 تحقیقات 📰 ویجت‌های اخبار مرتبط 🤖 دستیارهای هوش مصنوعی 📊 پلتفرم‌های هوش و تحلیل اطلاعات

---

🌍 اخبار جهانی و جغرافیایی

🗺️ کشورها

فهرست کشورهای پشتیبانی‌شده را دریافت کنید:

GET /api/v1/countries

دریافت اخبار یک کشور:

GET /api/v1/countries/{code}

مثال

/api/v1/countries/us

کد کشورها بر اساس استاندارد ISO-3166 Alpha-2 استفاده می‌شود.

---

🌎 اخبار منطقه‌ای

GET /api/v1/regions/{region}

مثال

/api/v1/regions/europe

نتایج منطقه‌ای اخبار کشورهای مختلف یک منطقه را تجمیع کرده و اخبار تکراری را حذف می‌کنند.

---

📍 اخبار محلی

اخبار مرتبط با یک موقعیت جغرافیایی را دریافت کنید:

GET /api/v1/local/{location}

مثال‌ها

/api/v1/local/London
/api/v1/local/California

مناسب برای:

📍 اپلیکیشن‌های اخبار محلی 🏙️ داشبوردهای شهری 🗺️ اپلیکیشن‌های مبتنی بر موقعیت مکانی 📰 رسانه‌ها و نشریات منطقه‌ای

---

🏷️ دسته‌بندی‌ها و موضوعات

📚 فهرست دسته‌بندی‌ها

GET /api/v1/categories

دسته‌بندی‌ها مستقل از Providerها هستند و می‌توانند شامل مواردی مانند موارد زیر باشند:

• 💻 فناوری
• 💼 کسب‌وکار
• ₿ رمزارز
• 🌍 جهان
• 🏦 امور مالی
• 🏛️ سیاست
• ⚽ ورزش
• 🎬 سرگرمی

کاتالوگ اصلی دسته‌بندی‌ها مستقل از Providerهای خبری طراحی شده است.

📰 اخبار یک دسته‌بندی

GET /api/v1/categories/{category}

مثال

/api/v1/categories/technology

---

🏢 اخبار شرکت‌ها و سازمان‌ها

🏢 اخبار شرکت

GET /api/v1/companies/{name}

مثال

/api/v1/companies/OpenAI

این Endpoint با استفاده از تطبیق دقیق عبارت، اخبار مرتبط با شرکت موردنظر را جست‌وجو می‌کند.

مناسب برای:

📊 پایش شرکت‌ها 🕵️ تحلیل رقبا 💼 تحقیقات کسب‌وکار 📣 پایش برند

---

🏛️ اخبار سازمان‌ها

GET /api/v1/organizations/{name}

اخبار مرتبط با سازمان‌ها، مؤسسات و نهادهای مختلف را دریافت کنید.

---

📈 اخبار مالی و سهام

💹 اخبار بر اساس نماد بورسی

GET /api/v1/tickers/{symbol}

مثال

/api/v1/tickers/AAPL

با استفاده از این Endpoint می‌توانید موارد زیر را بسازید:

📈 داشبوردهای سهام 💰 ابزارهای تحقیق و تحلیل سرمایه‌گذاری 🔔 هشدارهای بازار 📊 پلتفرم‌های هوش مالی

---

📰 منابع خبری

📚 فهرست منابع

GET /api/v1/sources

کاتالوگ منابع و ناشران شناخته‌شده را دریافت کنید.

📰 اخبار یک منبع مشخص

GET /api/v1/sources/{domain}

مثال

/api/v1/sources/bbc

یا:

/api/v1/sources/reuters.com

این Endpoint از شناسه منبع و همچنین دامنه ناشر پشتیبانی می‌کند.

---

🌎 ترجمه اخبار

محتوای مقاله را بدون حذف نسخه اصلی ترجمه کنید.

translate=fa

مثال

/api/v1/latest?country=us&translate=fa

محتوای ترجمه‌شده در فیلد translation مقاله قرار می‌گیرد و اطلاعات اصلی مقاله همچنان در دسترس خواهد بود.

مناسب برای:

🌍 اپلیکیشن‌های چندزبانه 🇩🇪 اپلیکیشن‌های خبری آلمانی 🇫🇷 اپلیکیشن‌های خبری فرانسوی 🇮🇷 اپلیکیشن‌های خبری فارسی 🤖 Agentهای هوش مصنوعی چندزبانه

---

🖼️ غنی‌سازی تصویر و متادیتا

غنی‌سازی اختیاری اطلاعات منتشرشده توسط ناشر را فعال کنید:

enrich=true

مثال

/api/v1/search?q=technology&enrich=true

API می‌تواند به‌صورت Best-Effort اطلاعاتی مانند og:image و توضیحات صفحه را استخراج کند.

⚠️ توجه: غنی‌سازی نیازمند پردازش بیشتری است و ممکن است زمان پاسخ API را افزایش دهد.

---

⏱️ جست‌وجو بر اساس بازه زمانی

اخبار را بر اساس بازه‌های زمانی نسبی دریافت کنید:

1h
1d
7d

مثال

/api/v1/recent/1h

همچنین می‌توانید بازه زمانی دقیق مشخص کنید:

from=2026-07-01
to=2026-07-08

API هم از بازه‌های زمانی نسبی و هم از بازه‌های تاریخی مشخص پشتیبانی می‌کند.

---

📄 صفحه‌بندی نتایج

بیشتر Endpointهای خبری از صفحه‌بندی پشتیبانی می‌کنند:

page=1
pageSize=20

حداکثر مقدار

pageSize=100

روش جایگزین:

limit=20
offset=0

💡 پیشنهاد

برای فیدهای معمولی:

pageSize=20

برای جمع‌آوری حجم بیشتری از داده:

pageSize=100

همیشه فقط به اندازه‌ای داده درخواست کنید که واقعاً اپلیکیشن شما نیاز دارد.

---

📦 پاسخ JSON تمیز و استاندارد

تمام مقالات در یک ساختار استاندارد و قابل پیش‌بینی قرار می‌گیرند.

نمونه پاسخ

{
  "id": "75f8f2b5331ccdd2ee0f1b53d77f006e8ce7dcd0",
  "title": "Example headline",
  "description": "Example description",
  "url": "https://example.com/article",
  "source": {
    "name": "Example News",
    "domain": "example.com",
    "provider": "example"
  },
  "imageUrl": "https://example.com/image.jpg",
  "publishedAt": "2026-07-26T08:48:18.000Z",
  "lang": "en",
  "country": "us",
  "category": "technology"
}

ساختار استاندارد مقاله شامل موارد زیر است:

🆔 شناسه یکتا 📰 عنوان 📝 توضیحات 🔗 لینک مقاله 📰 اطلاعات منبع 🕐 زمان انتشار 🗣️ زبان 🌍 کشور 🏷️ دسته‌بندی 🖼️ تصویر 🌎 ترجمه اختیاری

---

🧹 حذف خودکار اخبار تکراری

هنگامی که چند Provider یک خبر مشابه را منتشر می‌کنند، API-News شناسه‌های پایدار برای مقالات ایجاد می‌کند تا شناسایی اخبار تکراری آسان‌تر شود.

هویت مقاله می‌تواند بر اساس موارد زیر تعیین شود:

1. 🔗 آدرس مقاله
2. 🆔 شناسه یا GUID مربوط به Provider
3. 📰 عنوان مقاله

این قابلیت باعث می‌شود API-News برای سیستم‌های تجمیع اخبار، مانیتورینگ و تحلیل اطلاعات بسیار کاربردی باشد.

---

📊 اطلاعات Provider و وضعیت پاسخ

پاسخ‌های API می‌توانند اطلاعات مربوط به وضعیت اجرای Providerها را نیز در اختیار شما قرار دهند:

{
  "providers": {
    "requested": 12,
    "succeeded": 12,
    "failed": []
  },
  "partial": false,
  "degraded": false
}

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

---

⚡ عملکرد و کش

API-News از Caching کوتاه‌مدت برای افزایش سرعت پاسخ‌ها، در حالی که اخبار همچنان تازه باقی بمانند، استفاده می‌کند.

پاسخ‌ها می‌توانند شامل اطلاعاتی مانند موارد زیر باشند:

• ⚡ وضعیت Cache Hit
• ⏳ مدت اعتبار Cache یا TTL
• 🕐 زمان پردازش درخواست
• 🔌 زمان پاسخ Provider
• 🌐 زمان پاسخ منبع بالادستی
• 🌎 زمان موردنیاز برای ترجمه
• 🖼️ زمان موردنیاز برای غنی‌سازی اطلاعات

🚀 نکات مهم برای عملکرد بهتر

برای دستیابی به بهترین عملکرد:

✅ جست‌وجوهای هدفمند انجام دهید. ✅ مقدار مناسب pageSize را انتخاب کنید. ✅ در صورت امکان بازه زمانی جست‌وجو را محدود کنید. ✅ در صورت عدم نیاز، enrich=true را فعال نکنید. ✅ فقط Providerهای موردنیاز خود را درخواست کنید. ✅ داده‌هایی که مرتباً درخواست می‌شوند را در اپلیکیشن خود Cache کنید.

---

❤️ گردش کار پیشنهادی API

یک اپلیکیشن خبری معمولی می‌تواند از جریان زیر استفاده کند:

                    ┌────────────────┐
                    │  اپلیکیشن شما 🤖 │
                    └────────┬───────┘
                             │
                             ▼
                    ┌────────────────┐
                    │  API-News 📰   │
                    └────────┬───────┘
                             │
              ┌──────────────┼──────────────┐
              ▼              ▼              ▼
           جست‌وجو 🔎      ترند 🔥       فوری 🚨
              │              │              │
              └──────────────┼──────────────┘
                             ▼
                    تجمیع و استانداردسازی
                             │
                             ▼
                       حذف تکراری‌ها 🧹
                             │
                             ▼
                       فیلتر و رتبه‌بندی 🎯
                             │
                             ▼
                         پاسخ JSON 📦

---

🛠️ مرجع کامل Endpointها

🧩 Endpoint	📌 توضیحات
GET /api/v1/latest	⚡ جدیدترین اخبار
GET /api/v1/top	🏆 مهم‌ترین اخبار
GET /api/v1/trending	🔥 اخبار ترند
GET /api/v1/breaking	🚨 اخبار فوری
GET /api/v1/headlines	🗞️ تیترهای خبری
GET /api/v1/search	🔎 جست‌وجوی اخبار
GET /api/v1/discover	🧠 کشف پوشش خبری
GET /api/v1/related	🔗 اخبار مرتبط
GET /api/v1/countries	🌍 فهرست کشورها
GET /api/v1/countries/{code}	🗺️ اخبار یک کشور
GET /api/v1/countries/{code}/{category}	🏷️ اخبار دسته‌بندی‌شده یک کشور
GET /api/v1/regions	🌎 فهرست مناطق
GET /api/v1/regions/{region}	🌐 اخبار منطقه‌ای
GET /api/v1/categories	📚 فهرست دسته‌بندی‌ها
GET /api/v1/categories/{category}	📰 اخبار یک دسته‌بندی
GET /api/v1/topics	🧩 فهرست موضوعات
GET /api/v1/topics/{topic}	📰 اخبار یک موضوع
GET /api/v1/companies/{name}	🏢 اخبار شرکت
GET /api/v1/organizations/{name}	🏛️ اخبار سازمان
GET /api/v1/tickers/{symbol}	📈 اخبار نماد بورسی
GET /api/v1/sources	📰 فهرست منابع
GET /api/v1/sources/{domain}	🔎 اخبار یک منبع
GET /api/v1/local/{location}	📍 اخبار محلی
GET /api/v1/recent/{window}	⏱️ اخبار اخیر
GET /api/v1/timerange	📅 اخبار در بازه زمانی
GET /api/v1/date/{date}	📆 اخبار یک تاریخ مشخص
GET /api/v1/health	💚 بررسی سلامت سرویس
GET /api/v1/ready	✅ بررسی آمادگی سرویس
GET /api/v1/version	🔖 نسخه API
GET /api/v1/meta	🧰 متادیتای API

---

🛡️ مدیریت خطاها

خطاهای API دارای ساختاری استاندارد و یکپارچه هستند:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "statusCode": 400,
    "retryable": false,
    "requestId": "request-id"
  }
}

ساختار خطا شامل موارد زیر است:

🔢 کد خطای قابل پردازش توسط برنامه 💬 پیام قابل فهم برای کاربر یا توسعه‌دهنده 🌐 کد وضعیت HTTP 🔄 مشخص‌کردن امکان Retry 🆔 شناسه درخواست برای رهگیری و عیب‌یابی

🔄 خطاهای قابل تلاش مجدد

اگر مقدار زیر باشد:

retryable = true

اپلیکیشن شما می‌تواند بر اساس سیاست Retry خود، درخواست را دوباره ارسال کند.

در خطاهای غیرقابل Retry، ابتدا مشکل درخواست را برطرف کنید و سپس دوباره درخواست دهید.

---

🩺 سلامت و مانیتورینگ سرویس

💚 بررسی سلامت

GET /api/v1/health

بررسی می‌کند که سرویس API در حال اجرا است یا خیر.

---

✅ بررسی آمادگی

GET /api/v1/ready

آمادگی سرویس و دسترسی به منابع بالادستی را بررسی می‌کند.

---

🔖 نسخه API

GET /api/v1/version

نسخه API و قابلیت‌های Providerهای موجود را برمی‌گرداند.

---

🧰 متادیتای API

GET /api/v1/meta

یک کاتالوگ قابل پردازش توسط ماشین از موارد زیر ارائه می‌دهد:

• 🔌 Providerها
• 🧩 موضوعات
• 🏷️ دسته‌بندی‌ها
• 🌍 کشورها
• 🌎 مناطق
• 📰 منابع خبری

---

🚀 همین امروز شروع به ساخت کنید

فرقی نمی‌کند در حال ساخت چه نوع محصولی باشید:

📰 پلتفرم خبری 🤖 Agent خبری هوش مصنوعی 📈 داشبورد مالی 🔎 ابزار تحقیق و پژوهش 🏢 سیستم پایش شرکت‌ها 📱 اپلیکیشن خبری موبایل 🔥 فید اخبار ترند 🚨 سیستم هشدار اخبار فوری 📊 پلتفرم هوش بازار ⚙️ سیستم اتوماسیون محتوا

API-News یک API واحد، قدرتمند و توسعه‌دهنده‌پسند در اختیار شما قرار می‌دهد تا بتوانید اخبار تازه را از منابع متعدد کشف، جست‌وجو و دریافت کنید؛ بدون اینکه مجبور باشید برای هر منبع یکپارچه‌سازی جداگانه ایجاد و نگهداری کنید.

🌍 یک API برای اخبار جهان

🔎 همه‌چیز را جست‌وجو کنید

⚡ به جدیدترین اخبار دسترسی داشته باشید

🚀 سریع‌تر محصول بسازید

API-News — اخبار جهان، در یک API. 📰🌍🚀