هدهد ویژن

API خبر فارسی هدهد ویژن

وب‌سرویس JSON اخبار فارسی هدهد ویژن: دسته، استان، شهر، موضوع و کلیدواژه را خودتان فیلتر کنید و خبرهای تازه را با کلید اختصاصی در سایت یا اپ خود نمایش دهید. تست رایگان یک‌روزه؛ پلن هفتگی ۵ هزار تومان؛ پرداخت آنلاین و دریافت فوری کلید.

این API چه می‌دهد؟

  • خبرهای تازه ایران و جهان با عنوان، خلاصه، متن کامل، تصویر، دسته، استان و زمان انتشار در قالب JSON
  • فیلتر دسته و ژانر (اقتصاد، ورزش، فناوری، فرهنگ، سلامت، حوادث، گردشگری و ...)، ۳۱ استان، شهر، موضوع ویژه و کلیدواژه
  • دریافت فقط خبرهای جدید با شماره ترتیب since؛ هیچ خبری جا نمی‌ماند و تکراری نمی‌آید
  • کلید اختصاصی که فقط برای یک دامنه یا یک IP کار می‌کند

قیمت پلن‌های API خبر

پلن‌ها و قیمت به تومان
پلنمدتقیمت
تست رایگان۱ روزرایگان
هفتگی۷ روز۵٬۰۰۰ تومان
ماهانه۳۰ روز۲٬۰۰۰٬۰۰۰ تومان
سه‌ماهه۹۰ روز۶٬۰۰۰٬۰۰۰ تومان
شش‌ماهه۱۸۰ روز۱۲٬۰۰۰٬۰۰۰ تومان

نمونه فراخوانی

curl

curl -H "X-API-Key: hk_live_YOUR_KEY" "https://hodhodvision.ir/api/v1/feed/?limit=20"

Python

import requests
r = requests.get("https://hodhodvision.ir/api/v1/feed/", headers={"X-API-Key": "hk_live_YOUR_KEY"}, params={"since": 0}, timeout=15)
for n in r.json()["results"]:
    print(n["title"], n["url"])

امنیت و قوانین

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

API رایگان قیمت ارز و خودرو · مشخصات OpenAPI

پرسش‌های متداول

API خبر هدهد ویژن چیست؟

یک وب‌سرویس JSON است که خبرهای تازه فارسی هدهد ویژن را در چارچوبی که خودتان می‌سازید (دسته، استان، شهر، موضوع، کلیدواژه) به سایت یا اپ شما می‌رساند. هر مشترک یک کلید اختصاصی دارد و هر کلید فقط به یک آدرس (یک دامنه یا یک IP) وصل می‌شود.

پلن‌ها و قیمت‌ها چقدر است؟

تست رایگان یک‌روزه، هفتگی ۵ هزار تومان، ماهانه ۲ میلیون تومان، سه‌ماهه ۶ میلیون تومان و شش‌ماهه ۱۲ میلیون تومان. همه‌ی پلن‌ها از نظر امکانات یکسان‌اند و فقط مدت دسترسی فرق دارد.

چطور کلید می‌گیرم؟

پلن را انتخاب کنید، فیلترهای خبری و آدرس سایت یا IP را وارد کنید، حساب (نام کاربری و رمز) بسازید و پرداخت را در درگاه کامل کنید. کلید بلافاصله پس از پرداخت موفق در همان صفحه نمایش داده می‌شود.

چرا فقط یک دامنه یا یک IP؟

برای جلوگیری از فروش یا اشتراک کلید بین چند سایت. اگر کلید از آدرسی غیر از آدرس ثبت‌شده فراخوانی شود رد می‌شود و ثبت می‌گردد؛ آدرس دوم برای یک کلید پذیرفته نمی‌شود و یک آدرسِ فعال هم برای دو مشترک ثبت نمی‌شود.

کلید را می‌توانم در جاوااسکریپت مرورگر بگذارم؟

نه. فراخوانی باید از سرور شما انجام شود؛ درخواست‌هایی که هدر Origin مرورگر دارند رد می‌شوند تا کلید شما لو نرود. سرور شما خبرها را می‌گیرد و به صفحه‌های خودتان می‌دهد.

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

فراخوانی از سرور شما با IP همان سرور انجام می‌شود؛ اگر IP مبدأ با رکورد DNS دامنه یکی نیست، حالت IP را انتخاب کنید و IP خروجی سرور را وارد کنید.

خبرها چطور و با چه تأخیری می‌رسند؟

هر خبر پس از انتشار در هدهد ویژن یک شماره ترتیب (seq) می‌گیرد. با پارامتر since همیشه فقط خبرهای جدید را می‌گیرید و هیچ خبری جا نمی‌ماند؛ معمولاً چند ثانیه پس از انتشار در دسترس است.

استفاده از خبرها چه شرطی دارد؟

نمایش نام «هدهد ویژن» با پیوند به نشانی خبر (فیلد url) کنار هر خبر الزامی است. بازنشر بدون ذکر منبع یا واگذاری کلید به دیگران مجاز نیست.

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

با همان شماره و همان آدرس پلن جدید بخرید؛ زمان از پایان اشتراک فعلی جمع می‌شود و کلید عوض نمی‌شود. هر زمان کلید لو رفت از پنل «کلید جدید» بسازید؛ کلید قبلی فوری باطل می‌شود.