KarbalaDev API Documentation

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

Version 12.0.0 — 51 Endpoints — Base: https://karbaladev.ir/api

فال حافظ

2 endpoint
GET /api/hafez/fal
فال تصادفی با تفسیر
import requests\nr=requests.get("https://karbaladev.ir/api/hafez/fal")\nprint(r.json())
GET /api/hafez/all
۵ فال تصادفی
import requests\nr=requests.get("https://karbaladev.ir/api/hafez/all")\nprint(r.json())

فیلم‌های IMDB

5 endpoint
GET /api/movies
لیست فیلم‌ها
import requests\nr=requests.get("https://karbaladev.ir/api/movies")\nprint(r.json())
GET /api/movies/1
اطلاعات فیلم
import requests\nr=requests.get("https://karbaladev.ir/api/movies/1")\nprint(r.json())
GET /api/movies/search?q=Godfather
جستجوی فیلم
import requests\nr=requests.get("https://karbaladev.ir/api/movies/search",params={"q":"Godfather"})\nprint(r.json())
GET /api/genres
لیست ژانرها
import requests\nr=requests.get("https://karbaladev.ir/api/genres")\nprint(r.json())
GET /api/genres/1/movies
فیلم‌های ژانر
import requests\nr=requests.get("https://karbaladev.ir/api/genres/1/movies")\nprint(r.json())

آپارات

10 endpoint
GET /api/aparat/mostviewed
ویدیوهای پربازدید
import requests\nr=requests.get("https://karbaladev.ir/api/aparat/mostviewed")\nprint(r.json())
GET /api/aparat/search?q=آموزش
جستجوی ویدیو
import requests\nr=requests.get("https://karbaladev.ir/api/aparat/search",params={"q":"آموزش"})\nprint(r.json())
GET /api/aparat/categories
دسته‌بندی‌ها
import requests\nr=requests.get("https://karbaladev.ir/api/aparat/categories")\nprint(r.json())
GET /api/aparat/profile/alooty
پروفایل کاربر
import requests\nr=requests.get("https://karbaladev.ir/api/aparat/profile/alooty")\nprint(r.json())
GET /api/aparat/user/alooty/videos
ویدیوهای کاربر
import requests\nr=requests.get("https://karbaladev.ir/api/aparat/user/alooty/videos")\nprint(r.json())
GET /api/aparat/bytag/طنز
ویدیوهای تگ
import requests\nr=requests.get("https://karbaladev.ir/api/aparat/bytag/طنز")\nprint(r.json())
GET /api/aparat/category/7
ویدیوهای دسته
import requests\nr=requests.get("https://karbaladev.ir/api/aparat/category/7")\nprint(r.json())
GET /api/aparat/video/o96ix9z
اطلاعات ویدیو
import requests\nr=requests.get("https://karbaladev.ir/api/aparat/video/o96ix9z")\nprint(r.json())
GET /api/aparat/comments/o96ix9z
نظرات ویدیو
import requests\nr=requests.get("https://karbaladev.ir/api/aparat/comments/o96ix9z")\nprint(r.json())
GET /api/aparat/users/search?q=amir
جستجوی کاربر
import requests\nr=requests.get("https://karbaladev.ir/api/aparat/users/search",params={"q":"amir"})\nprint(r.json())

بازار مالی

4 endpoint
GET /api/gold
قیمت طلا و ارز
import requests\nr=requests.get("https://karbaladev.ir/api/gold")\nprint(r.json())
GET /api/crypto
قیمت رمزارزها
import requests\nr=requests.get("https://karbaladev.ir/api/crypto")\nprint(r.json())
GET /api/commodity
قیمت کامودیتی
import requests\nr=requests.get("https://karbaladev.ir/api/commodity")\nprint(r.json())
GET /api/usdt
قیمت تتر
import requests\nr=requests.get("https://karbaladev.ir/api/usdt")\nprint(r.json())

اطلاعات IP

4 endpoint
GET /api/ip
IP شما (JSON)
import requests\nr=requests.get("https://karbaladev.ir/api/ip")\nprint(r.json())
GET /api/ip/raw
IP شما (plain)
import requests\nr=requests.get("https://karbaladev.ir/api/ip/raw")\nprint(r.text)
GET /api/ip/hex
IP شما (HEX)
import requests\nr=requests.get("https://karbaladev.ir/api/ip/hex")\nprint(r.text)
GET /api/ip/info/8.8.8.8
اطلاعات IP
import requests\nr=requests.get("https://karbaladev.ir/api/ip/info/8.8.8.8")\nprint(r.json())

وب‌سرویس‌های متنوع

18 endpoint
GET /api/name
اسم تصادفی
import requests\nr=requests.get("https://karbaladev.ir/api/name")\nprint(r.json())
GET /api/hadith
حدیث تصادفی
import requests\nr=requests.get("https://karbaladev.ir/api/hadith")\nprint(r.json())
GET /api/saadi
شعر سعدی
import requests\nr=requests.get("https://karbaladev.ir/api/saadi")\nprint(r.json())
GET /api/jok
جوک تصادفی
import requests\nr=requests.get("https://karbaladev.ir/api/jok")\nprint(r.json())
GET /api/jok/khatere
خاطره خنده‌دار
import requests\nr=requests.get("https://karbaladev.ir/api/jok/khatere")\nprint(r.text)
GET /api/jok/pa-na-pa
جوک پ ن پ
import requests\nr=requests.get("https://karbaladev.ir/api/jok/pa-na-pa")\nprint(r.text)
GET /api/weather/Tehran
هواشناسی تهران
import requests\nr=requests.get("https://karbaladev.ir/api/weather/Tehran")\nprint(r.json())
GET /api/monasebat
مناسبت‌های امروز
import requests\nr=requests.get("https://karbaladev.ir/api/monasebat")\nprint(r.text)
GET /api/jaraem
جرایم رانندگی
import requests\nr=requests.get("https://karbaladev.ir/api/jaraem")\nprint(r.json())
GET /api/music/search?q=عشق
جستجوی آهنگ
import requests\nr=requests.get("https://karbaladev.ir/api/music/search",params={"q":"عشق"})\nprint(r.json())
GET /api/music/maddahi?q=محرم
جستجوی مداحی
import requests\nr=requests.get("https://karbaladev.ir/api/music/maddahi",params={"q":"محرم"})\nprint(r.json())
GET /api/morse?text=hello
متن به مورس
import requests\nr=requests.get("https://karbaladev.ir/api/morse",params={"text":"hello"})\nprint(r.text)
GET /api/morse/decode?morse=....
مورس به متن
import requests\nr=requests.get("https://karbaladev.ir/api/morse/decode",params={"morse":"...."})\nprint(r.text)
GET /api/proxy?type=mtproto
پروکسی تلگرام
import requests\nr=requests.get("https://karbaladev.ir/api/proxy",params={"type":"mtproto"})\nprint(r.json())
GET /api/timesync?time=2026-12-25|00:00
روزشمار
import requests\nr=requests.get("https://karbaladev.ir/api/timesync",params={"time":"2026-12-25|00:00"})\nprint(r.text)
GET /api/num?num=5000000
عدد به حروف
import requests\nr=requests.get("https://karbaladev.ir/api/num",params={"num":"5000000"})\nprint(r.text)
GET /api/owghat?city=تهران
اوقات شرعی
import requests\nr=requests.get("https://karbaladev.ir/api/owghat",params={"city":"تهران"})\nprint(r.json())
GET /api/password?length=16
تولید پسورد
import requests\nr=requests.get("https://karbaladev.ir/api/password",params={"length":"16"})\nprint(r.text)

سرویس‌های هسته

8 endpoint
GET /api/status
وضعیت سرور
import requests\nr=requests.get("https://karbaladev.ir/api/status")\nprint(r.json())
GET /api/ping
تست سلامت
import requests\nr=requests.get("https://karbaladev.ir/api/ping")\nprint(r.json())
GET /api/time
زمان سرور
import requests\nr=requests.get("https://karbaladev.ir/api/time")\nprint(r.json())
GET /api/quote
نقل قول
import requests\nr=requests.get("https://karbaladev.ir/api/quote")\nprint(r.json())
GET /api/about
درباره تیم
import requests\nr=requests.get("https://karbaladev.ir/api/about")\nprint(r.json())
GET /api/services
لیست خدمات
import requests\nr=requests.get("https://karbaladev.ir/api/services")\nprint(r.json())
GET /api/tech
تکنولوژی‌ها
import requests\nr=requests.get("https://karbaladev.ir/api/tech")\nprint(r.json())
GET /api/music-list
لیست آهنگ‌ها
import requests\nr=requests.get("https://karbaladev.ir/api/music-list")\nprint(r.json())