یک شروع رایگان برای شما

۳ روز رایگان،
پنل تحلیلگر را تجربه کنید

ثبت‌نام کنید و با تأیید شماره موبایل، دسترسی آزمایشی سه‌روزه‌تان را فعال کنید.

✓ بدون نیاز به پرداخت✓ فعال‌سازی پس از تأیید موبایل
شروع رایگان ۳ روزه

ویژه کاربران جدید · یک دوره برای هر حساب

زنده بازار
تتر (USDT): در حال دریافت طلای ۱۸ عیار بازار: در حال دریافت سکه امامی: در حال دریافت سکه طرح جدید: در حال دریافت دلار آزاد: در حال دریافت دلار نیما: در حال دریافت یورو: در حال دریافت شاخص کل: در حال دریافت خبر پردازش‌شده ۲۴ ساعت: —

مستندات API

به مستندات «خبر API» خوش آمدید. با استفاده از این سرویس می‌توانید خبرهای گردآوری‌شده از منابع متصل را جست‌وجو و فیلتر کنید و خروجی ساختاریافته JSON دریافت کنید. تازگی هر نتیجه به زمان دریافت آن از منبع وابسته است.

Base URL https://khapi.ir/api/v1

🔑 احراز هویت (Authentication)

برای استفاده از سرویس، باید کلید API خود را در هدر (Header) تمام درخواست‌ها ارسال کنید.

HTTP Header
x-api-key: YOUR_API_KEY

📡 دریافت لیست اخبار

مصرف سهمیه بر مبنای درخواست API است، نه تعداد خبر برگشتی. سقف روزانه و ماهانه حساب را در پنل توسعه‌دهنده ببینید؛ رسیدن به هر کدام پاسخ ۴۲۹ ایجاد می‌کند.

متد: GET /news

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

برای سازگاری با نسخه‌های قبلی، limit نام جایگزین page_size و source نام جایگزین sources است. مقدار صریح page_size اولویت دارد؛ source فقط در نبود مقدار غیرخالی sources استفاده می‌شود.

پارامترهای ورودی (Query Params):

در نمایشگر کوچک، برای دیدن همهٔ ستون‌ها جدول را افقی حرکت دهید.

پارامتر نوع توضیحات
sources string نام دقیق منبع مطابق فهرست منابع (مثلاً ISNA)؛ چند منبع با کاما جدا می‌شوند
categories string دسته‌بندی فارسی (مثلاً: ورزشی، سیاسی، فناوری)؛ چند دسته با کاما جدا می‌شوند
page_size int تعداد نتایج هر صفحه: ۱ تا ۱۰۰ (پیش‌فرض: ۱۰)
qstringجست‌وجو در عنوان، متن و برچسب‌ها
pageintشماره صفحه، شروع از ۱

نمونه درخواست (cURL):

Bash
curl -X GET "https://khapi.ir/api/v1/news?page_size=5" \
     -H "x-api-key: YOUR_API_KEY"

تاریخ published_at میلادی و بر مبنای UTC است؛ برای نمایش محلی، منطقهٔ زمانی را تبدیل کنید. نمونه پاسخ (JSON):

{
  "status": "success",
  "total_results": 1,
  "page": 1,
  "page_size": 5,
  "total_pages": 1,
  "articles": [
    {
      "source": "Zoomit",
      "title": "هوش مصنوعی جدید گوگل معرفی شد",
      "summary": "گوگل امروز از مدل جدید جمینای رونمایی کرد...",
      "url": "https://zoomit.ir/...",
      "published_at": "2026-11-05T10:30:00",
      "image_url": "https://cdn.zoomit.ir/..."
    }
  ]
}

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

در صورت بروز مشکل، API کدهای استاندارد HTTP را برمی‌گرداند.

کد پیام علت
401 Unauthorized کلید API نامعتبر یا ارسال نشده است.
429 Too Many Requests تعداد درخواست‌های شما از حد مجاز گذشته است.