سرویس‌های وب و پلتفرم API

راهنمای اتصال به OnlySub API

موتور هوش مصنوعی MediaSync تمامی اندپوینت‌های جستجو، استعلام متادیتا، دانلود زیرنویس‌های UTF-8 و مانیفست افزونه استریمیو را در قالبی پرسرعت و استاندارد در اختیار پلیرها و ربات‌ها قرار می‌دهد.

مستندات Swagger / OpenAPI

آدرس پایه سرویس

https://onlysub.ir/api/v1

مجهز به پروتکل امن TLS 1.3 و فشرده‌سازی Gzip

نرخ مجاز فراخوانی

۶۰ درخواست در دقیقه (عمومی)

بدون نیاز به کلید برای جستجو و دانلود عادی

انکودینگ و فرمت

UTF-8 Without BOM • SubRip (.srt)

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

نمونه کد فراخوانی سریع

# واکشی اطلاعات زیرنویس با شناسه فیلم
curl -X GET "https://onlysub.ir/api/v1/movies/interstellar" \
  -H "Accept: application/json"

فهرست اندپوینت‌های استاندارد نسخه ۱

GET/api/v1/movies/search

q=Interstellar

جستجوی پیشرفته فیلم‌ها و سریال‌ها با نام انگلیسی، فارسی یا شناسه IMDb

نمونه پاسخ سرور (JSON):

{
  "items": [
    {
      "id": "47f49201-cdda-4a25-932e-f933801c8256",
      "slug": "interstellar",
      "title_en": "Interstellar",
      "title_fa": "میان‌ستاره‌ای",
      "release_year": 2014,
      "imdb_id": "tt0816692",
      "imdb_rating": 8.7
    }
  ],
  "total": 1
}

GET/api/v1/movies/{id_or_slug}

interstellar

دریافت اطلاعات متادیتا، خلاصه‌داستان و کلیه زیرنویس‌های فعال اثر

نمونه پاسخ سرور (JSON):

{
  "id": "47f49201-cdda-4a25-932e-f933801c8256",
  "slug": "interstellar",
  "title_en": "Interstellar",
  "title_fa": "میان‌ستاره‌ای",
  "release_year": 2014,
  "imdb_id": "tt0816692",
  "imdb_rating": 8.7,
  "subtitles": [
    {
      "id": "sub_fa_001",
      "language_code": "fa",
      "format": "srt",
      "downloads_count": 842,
      "is_ai_generated": true
    }
  ]
}

GET/api/v1/subtitles/download/{id}

sub_fa_001?format=srt&mode=uncensored

دانلود مستقیم فایل زیرنویس SRT با انکودینگ UTF-8 و انتخاب حالت سانسور یا خالص

نمونه پاسخ سرور (JSON):

1
00:01:14,200 --> 00:01:17,800
پدرم یک کشاورز بود، مثل بقیه در آن دوران.

2
00:01:18,100 --> 00:01:21,500
اما او هرگز فراموش نکرد که ما کاشف هستیم...

GET/stremio/manifest.json

پروتکل رسمی افزونه استریمیو (Stremio v3 Addon Protocol) جهت کشف خودکار زیرنویس

نمونه پاسخ سرور (JSON):

{
  "id": "org.onlysub.addon",
  "version": "1.0.0",
  "name": "OnlySub AI Subtitles",
  "description": "Multi-language AI cinema subtitles by MediaSync",
  "resources": ["subtitles"],
  "types": ["movie", "series"]
}