۱۰ API رایگان فیلم برتر برای توسعه‌دهندگان (2026)

۱۰ API رایگان برتر فیلم برای توسعه‌دهندگان در ۲۰۲۶

داری یک اپ فیلم، موتور پیشنهاد یا داشبورد سرگرمی می‌سازی؟ به یک API فیلم قابل اعتماد نیاز داری. این راهنما ۱۰ API بهترین فیلم و سریال رایگان موجود در ۲۰۲۶ را با مثال‌های کد برای هر کدام پوشش می‌دهد.

مقایسه سریع

API	سطح رایگان	محدودیت نرخ	سریال	تصاویر	امتیازات
TMDB	نامحدود	۴۰ درخواست/۱۰ثانیه	بله	بله	بله
OMDB	۱,۰۰۰ درخواست/روز	۱,۰۰۰/روز	بله	پوستر	بله (IMDb)
TVmaze	نامحدود	۲۰ درخواست/۱۰ثانیه	بله	بله	بله
Trakt	۱,۰۰۰ درخواست/روز	۱,۰۰۰/روز	بله	خیر	بله
JustWatch	غیررسمی	متغیر	بله	بله	بله
Watchmode	۱,۰۰۰ درخواست/ماه	متغیر	بله	بله	بله
Movie of the Night	۱۰,۰۰۰ درخواست/ماه	متغیر	بله	بله	بله
IMDb (غیررسمی)	متغیر	متغیر	بله	بله	بله
Streaming Availability	۱۰۰ درخواست/روز	۱۰۰/روز	بله	بله	بله
Kitsu	نامحدود	متوسط	انیمه	بله	بله

۱. TMDB (پایگاه داده فیلم) — بهترین در کل

TMDB استاندارد طلایی برای APIهای فیلم رایگان است. جامع‌ترین پایگاه داده، مستندات عالی و سطح رایگان سخاوتمندانه دارد.

ویژگی‌های کلیدی:

• ۹۰۰,۰۰۰+ فیلم و ۱۶۰,۰۰۰+ سریال تلویزیونی
• تصاویر و پوسترهای با رزولوشن بالا
• جزئیات بازیگران، عوامل و تولید
• موجود به ۴۰+ زبان
• داده‌های community-driven

دریافت کلید API

1. در themoviedb.org حساب رایگان بساز
2. به Settings > API برو و یک کلید API درخواست کن
3. «Developer» را برای دسترسی رایگان انتخاب کن

مثال کد

import requests

API_KEY = "your_tmdb_api_key"
BASE_URL = "https://api.themoviedb.org/3"

# Search for a movie
response = requests.get(f"{BASE_URL}/search/movie", params={
    "api_key": API_KEY,
    "query": "Inception",
    "language": "en-US"
})

results = response.json()["results"]
for movie in results[:3]:
    print(f"{movie['title']} ({movie['release_date'][:4]}) - Rating: {movie['vote_average']}")

// Node.js / fetch
const API_KEY = "your_tmdb_api_key";

const response = await fetch(
  `https://api.themoviedb.org/3/search/movie?api_key=${API_KEY}&query=Inception`
);
const data = await response.json();

data.results.slice(0, 3).forEach(movie => {
  console.log(`${movie.title} (${movie.release_date.slice(0, 4)}) - ${movie.vote_average}`);
});

دریافت فیلم‌های ترند

# Get this week's trending movies
response = requests.get(f"{BASE_URL}/trending/movie/week", params={
    "api_key": API_KEY
})

trending = response.json()["results"]
for movie in trending[:5]:
    print(f"Trending: {movie['title']} - {movie['vote_average']}/10")

۲. OMDB (پایگاه داده باز فیلم) — بهترین برای داده‌های IMDb

OMDB دسترسی مستقیم به امتیازات IMDb، نمرات Rotten Tomatoes و داده‌های Metacritic را در یک فراخوانی API می‌دهد.

سطح رایگان: ۱,۰۰۰ درخواست در روز

مثال کد

import requests

API_KEY = "your_omdb_api_key"  # Get free key at omdbapi.com

# Search by title
response = requests.get("https://www.omdbapi.com/", params={
    "apikey": API_KEY,
    "t": "The Dark Knight",
    "type": "movie"
})

movie = response.json()
print(f"Title: {movie['Title']}")
print(f"IMDb Rating: {movie['imdbRating']}")
print(f"Rotten Tomatoes: {movie['Ratings'][1]['Value']}")
print(f"Metacritic: {movie['Metascore']}")

const response = await fetch(
  `https://www.omdbapi.com/?apikey=YOUR_KEY&t=The+Dark+Knight&type=movie`
);
const movie = await response.json();

console.log(`${movie.Title} - IMDb: ${movie.imdbRating}, RT: ${movie.Ratings[1]?.Value}`);

۳. TVmaze — بهترین برای داده‌های سریال

TVmaze در داده‌های سریال با اطلاعات عمیق در سطح اپیزود، برنامه‌ریزی و داده‌های بازیگر تخصص دارد. برای استفاده پایه نیازی به کلید API ندارد.

مثال کد

import requests

# No API key needed for basic endpoints
response = requests.get("https://api.tvmaze.com/search/shows", params={
    "q": "Breaking Bad"
})

shows = response.json()
for item in shows[:3]:
    show = item["show"]
    print(f"{show['name']} - Rating: {show['rating']['average']}")
    print(f"  Genres: {', '.join(show['genres'])}")
    print(f"  Status: {show['status']}")

دریافت برنامه اپیزودها

# Get today's TV schedule for the US
response = requests.get("https://api.tvmaze.com/schedule", params={
    "country": "US"
})

episodes = response.json()
for ep in episodes[:5]:
    show_name = ep["show"]["name"]
    print(f"{show_name} - S{ep['season']}E{ep['number']}: {ep['name']}")

۴. Trakt — بهترین برای تاریخچه تماشا و پیشنهادات

Trakt بر تاریخچه تماشای کاربر، لیست‌ها و ویژگی‌های اجتماعی تمرکز دارد. برای ساختن موتورهای پیشنهاد شخصی‌سازی‌شده عالی است.

سطح رایگان: ۱,۰۰۰ فراخوانی API در روز

import requests

headers = {
    "Content-Type": "application/json",
    "trakt-api-version": "2",
    "trakt-api-key": "your_client_id"
}

# Get trending movies
response = requests.get(
    "https://api.trakt.tv/movies/trending",
    headers=headers
)

trending = response.json()
for item in trending[:5]:
    movie = item["movie"]
    print(f"{movie['title']} ({movie['year']}) - Watchers: {item['watchers']}")

۵. JustWatch (غیررسمی) — بهترین برای موجودیت پخش جریانی

JustWatch ردیابی می‌کند کدام فیلم‌ها و سریال‌ها روی کدام پلتفرم‌های streaming موجودند. در حالی که API رسمی رایگان وجود ندارد، کتابخانه‌های نگهداری‌شده توسط جامعه دسترسی را فراهم می‌کنند.

# Using the justwatch-python package
# pip install justwatch
from justwatch import JustWatch

jw = JustWatch(country="US")
results = jw.search_for_item(query="Dune")

for item in results["items"][:3]:
    title = item["title"]
    offers = item.get("offers", [])
    platforms = set(o["package_short_name"] for o in offers)
    print(f"{title} - Available on: {', '.join(platforms)}")

۶. Watchmode — بهترین برای داده‌های منبع streaming

Watchmode داده‌های ساختاریافته‌ای درباره اینکه کدام سرویس‌های streaming هر عنوان را دارند، از جمله deep link های مستقیم، فراهم می‌کند.

سطح رایگان: ۱,۰۰۰ فراخوانی API در ماه

import requests

API_KEY = "your_watchmode_key"

response = requests.get(f"https://api.watchmode.com/v1/search/", params={
    "apiKey": API_KEY,
    "search_field": "name",
    "search_value": "Stranger Things"
})

results = response.json()["title_results"]
for title in results[:3]:
    print(f"{title['name']} ({title['year']}) - Type: {title['type']}")

۷. Movie of the Night API — بهترین برای کشف

Movie of the Night بر کشف محتوا با پیشنهادات curated و فیلتر کردن تمرکز دارد.

سطح رایگان: ۱۰,۰۰۰ درخواست در ماه

import requests

headers = {"x-rapidapi-key": "your_rapidapi_key"}

response = requests.get(
    "https://movie-of-the-night.p.rapidapi.com/search",
    headers=headers,
    params={"query": "sci-fi", "type": "movie"}
)

for movie in response.json()[:5]:
    print(f"{movie['title']} - Streaming on: {', '.join(movie.get('services', []))}")

۸. API های غیررسمی IMDb — بهترین برای داده‌های خام IMDb

چندین API غیررسمی IMDb روی RapidAPI موجود هستند که داده‌های IMDb را scrape یا mirror می‌کنند.

import requests

headers = {
    "x-rapidapi-key": "your_rapidapi_key",
    "x-rapidapi-host": "imdb8.p.rapidapi.com"
}

response = requests.get(
    "https://imdb8.p.rapidapi.com/auto-complete",
    headers=headers,
    params={"q": "Oppenheimer"}
)

results = response.json()["d"]
for item in results[:3]:
    print(f"{item['l']} ({item.get('y', 'N/A')}) - {item.get('s', '')}")

هشدار: API های غیررسمی ممکن است بدون اطلاع قبلی خراب شوند. برای اپلیکیشن‌های تولیدی از TMDB یا OMDB استفاده کن.

۹. Streaming Availability API — بهترین برای جستجوی چند پلتفرمی

این API داده‌های streaming را در ۱۵۰+ سرویس در ۶۰+ کشور جمع می‌کند.

سطح رایگان: ۱۰۰ درخواست در روز روی RapidAPI

import requests

headers = {
    "x-rapidapi-key": "your_rapidapi_key",
    "x-rapidapi-host": "streaming-availability.p.rapidapi.com"
}

response = requests.get(
    "https://streaming-availability.p.rapidapi.com/shows/search/filters",
    headers=headers,
    params={
        "country": "us",
        "catalogs": "netflix",
        "genres": "action",
        "order_by": "rating",
        "output_language": "en"
    }
)

for show in response.json()["shows"][:5]:
    print(f"{show['title']} - Rating: {show.get('rating', 'N/A')}")

۱۰. Kitsu — بهترین برای انیمه

Kitsu بهترین API رایگان برای داده‌های انیمه و مانگا است. نیازی به کلید API ندارد.

import requests

response = requests.get("https://kitsu.io/api/edge/anime", params={
    "filter[text]": "Attack on Titan",
    "page[limit]": 5
})

for anime in response.json()["data"]:
    attrs = anime["attributes"]
    print(f"{attrs['canonicalTitle']} - Rating: {attrs['averageRating']}")
    print(f"  Episodes: {attrs['episodeCount']}, Status: {attrs['status']}")

چطور API مناسب را انتخاب کنی

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

• داری یک اپ فیلم عمومی می‌سازی؟ با TMDB شروع کن — همه چیز دارد.
• به امتیازات IMDb/RT نیاز داری؟ از OMDB به عنوان مکمل استفاده کن.
• داری قابلیت «کجا تماشا کنیم» می‌سازی؟ از Streaming Availability یا Watchmode استفاده کن.
• برنامه‌ریزی سریال؟ TVmaze بی‌رقیب است.
• اپ انیمه؟ Kitsu برای این هدف ساخته شده.
• موتور پیشنهاد؟ داده‌های TMDB را با رفتار کاربر Trakt ترکیب کن.

ساخت یک اپ فیلم کامل

برای اکثر پروژه‌ها، می‌خواهی دو یا سه API را ترکیب کنی:

import requests

class MovieService:
    def __init__(self, tmdb_key, omdb_key):
        self.tmdb_key = tmdb_key
        self.omdb_key = omdb_key

    def get_movie_details(self, title):
        # Get rich data from TMDB
        tmdb = requests.get("https://api.themoviedb.org/3/search/movie", params={
            "api_key": self.tmdb_key,
            "query": title
        }).json()["results"][0]

        # Get ratings from OMDB
        omdb = requests.get("https://www.omdbapi.com/", params={
            "apikey": self.omdb_key,
            "t": title
        }).json()

        return {
            "title": tmdb["title"],
            "overview": tmdb["overview"],
            "poster": f"https://image.tmdb.org/t/p/w500{tmdb['poster_path']}",
            "tmdb_rating": tmdb["vote_average"],
            "imdb_rating": omdb.get("imdbRating"),
            "rotten_tomatoes": next(
                (r["Value"] for r in omdb.get("Ratings", [])
                 if r["Source"] == "Rotten Tomatoes"), None
            ),
        }

# Usage
service = MovieService("tmdb_key", "omdb_key")
movie = service.get_movie_details("Dune: Part Two")
print(movie)

اضافه کردن ویژگی‌های مبتنی بر هوش مصنوعی

می‌خواهی فراتر از داده‌های پایه فیلم بروی؟ می‌توانی از API های هوش مصنوعی برای افزودن ویژگی‌های هوشمند به اپ فیلم‌ات استفاده کنی:

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

Hypereal AI API هایی برای تولید تصویر، ساخت ویدیو و text-to-speech ارائه می‌دهد که با داده‌های فیلم به‌خوبی جفت می‌شوند. برای توسعه‌دهندگان ایرانی هم بدون موانع جغرافیایی در دسترس است. مثلاً می‌توانی تنوع‌های پوستر فیلم سفارشی بسازی یا ویدیوهای نقد با روایت هوش مصنوعی ایجاد کنی. برای آزمایش اعتبارهای رایگان ثبت‌نام کن.

نتیجه‌گیری

TMDB برای اکثر موارد استفاده برنده واضح است — رایگان، جامع و مستند خوب دارد. آن را با OMDB برای داده‌های امتیازدهی و یک API موجودیت streaming برای ویژگی «کجا تماشا کنیم» تکمیل کن.

همه ۱۰ API در این فهرست سطوح رایگانی کافی برای توسعه و تولید در مقیاس کوچک ارائه می‌دهند. با TMDB شروع کن، بقیه را به‌نیاز اضافه کن، و یک stack داده فیلم کامل بدون خرج یک دلار خواهی داشت.