API Documentation

Authentication

All API requests require an API key passed via the X-Api-Key HTTP header.

curl -H "X-Api-Key: YOUR_API_KEY" https://moviebase.ikkazuma.com/api/v1/movie/popular

Request your API key from the administrator. Each key is tied to a consumer app name.

Base URL

https://moviebase.ikkazuma.com/api/v1

All endpoints below are relative to this base URL. All requests must be GET.

Parameter	Type	Description
`mediaType`	string	`movie` or `tv`
`timeWindow`	string	`day` or `week`
`page`	integer optional	Page number (default 1)

Movies

GET /movie/popular

Get a list of popular movies.

Parameter	Type	Description
`page`	integer optional	Page number
`region`	string optional	ISO 3166-1 country code

GET /movie/top_rated

Get a list of top rated movies.

GET /movie/now_playing

Get a list of movies currently in theatres.

GET /movie/upcoming

Get a list of upcoming movies.

GET /movie/{id}

Get detailed information about a movie.

Parameter	Type	Description
`id`	integer required	Movie ID

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/movie/550

GET /movie/{id}/{append}

Get movie detail with appended data (credits, videos, similar, recommendations, images, reviews).

Parameter	Type	Description
`append`	string required	One of: `credits`, `videos`, `similar`, `recommendations`, `images`, `reviews`, `keywords`

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/movie/550/credits

Blocked movies are silently removed from list results. Detail requests for blocked movies return 404.

TV Shows

GET /tv/popular

Get a list of popular TV shows.

Parameter	Type	Description
`page`	integer optional	Page number
`language`	string optional	ISO 639-1 language code

GET /tv/top_rated

Get a list of top rated TV shows.

GET /tv/on_the_air

Get a list of TV shows currently on the air.

GET /tv/airing_today

Get a list of TV shows airing today.

GET /tv/{id}

Get detailed information about a TV show.

Parameter	Type	Description
`id`	integer required	TV show ID

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/tv/1399

GET /tv/{id}/{append}

Get TV show detail with appended data.

Parameter	Type	Description
`append`	string required	One of: `credits`, `videos`, `similar`, `recommendations`, `images`, `reviews`, `keywords`

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/tv/1399/credits

GET /tv/{id}/season/{season}

Get detailed information about a specific TV season including episode list.

Parameter	Type	Description
`id`	integer required	TV show ID
`season`	integer required	Season number

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/tv/1399/season/1

Response fields: name, overview, poster_path, season_number, air_date, episodes[] (each with episode_number, name, overview, still_path, air_date)

Blocked TV shows are silently removed from list results. Detail requests for blocked shows return 404.

Search

GET /search/{type}?query=

Search for movies, TV shows, or both.

Parameter	Type	Description
`type`	string required	`movie`, `tv`, `person`, or `multi`
`query`	string required	Search query string
`page`	integer optional	Page number
`language`	string optional	ISO 639-1 language code
`year`	integer optional	Movie year filter
`first_air_date_year`	integer optional	TV year filter

curl -H "X-Api-Key: KEY" "https://moviebase.ikkazuma.com/api/v1/search/movie?query=Inception&page=1"

Genres

GET /genre/{type}/list

Get the list of official genres for movies or TV shows.

Parameter	Type	Description
`type`	string required	`movie` or `tv`
`language`	string optional	ISO 639-1 language code

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/genre/movie/list?language=en

Discover

GET /discover/{type}

Discover movies or TV shows by various filters.

Parameter	Type	Description
`type`	string required	`movie` or `tv`
`sort_by`	string optional	e.g. `popularity.desc`, `vote_average.desc`
`with_genres`	string optional	Comma-separated genre IDs
`page`	integer optional	Page number
`language`	string optional	ISO 639-1 language code

curl -H "X-Api-Key: KEY" "https://moviebase.ikkazuma.com/api/v1/discover/movie?sort_by=popularity.desc&with_genres=28,12"

Person

GET /person/{id}

Get detailed information about a person (actor, director, etc.).

Parameter	Type	Description
`id`	integer required	Person ID

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/person/1337

Response fields: name, biography, birthday, deathday, place_of_birth, profile_path (full URL), known_for_department, also_known_as[], popularity

GET /person/{id}/combined_credits

Get combined movie and TV filmography for a person (cast & crew).

Parameter	Type	Description
`id`	integer required	Person ID

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/person/1337/combined_credits

Response: { cast: [...], crew: [...] } — each entry includes id, title/name, character, department, job, poster_path, media_type

GET /person/{id}/movie_credits

Get movie credits only for a person (cast & crew).

Parameter	Type	Description
`id`	integer required	Person ID

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/person/1337/movie_credits

Response: { cast: [...], crew: [...] }

GET /person/{id}/tv_credits

Get TV credits only for a person (cast & crew).

Parameter	Type	Description
`id`	integer required	Person ID

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/person/1337/tv_credits

Response: { cast: [...], crew: [...] }

GET /person/{id}/external_ids

Get social media and external IDs for a person.

Parameter	Type	Description
`id`	integer required	Person ID

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/person/1337/external_ids

Response fields: imdb_id, facebook_id, instagram_id, twitter_id, tiktok_id, youtube_id, wikidata_id

Person content is not subject to block filtering. profile_path images are auto-rewritten to full URLs.

Watch Providers

GET /movie/{id}/watch-providers

Get streaming/watch providers for a movie.

Parameter	Type	Description
`id`	integer required	Movie ID

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/movie/550/watch-providers

Response: { id, results: { "US": { link, flatrate[], rent[], buy[], free[] }, "GB": {...}, ... } }

Results are keyed by country code. Pick your target region: results["US"]. Each country object contains:

link — JustWatch page URL
flatrate[] — Flat-rate streaming providers
rent[] — Rental providers
buy[] — Purchase providers
free[] — Free streaming providers

Each provider entry has: logo_path (full URL), provider_name, provider_id

GET /tv/{id}/watch-providers

Get streaming/watch providers for a TV show.

Parameter	Type	Description
`id`	integer required	TV show ID

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/tv/1399/watch-providers

Response: Same format as movie — results keyed by country code. Pick your region: results["ID"]. Contains flatrate[], rent[], buy[], free[] provider lists.

Torrent Endpoints

GET /torrent/search?query=&cat=

Search torrents across all active sources. Results sorted by seeders (descending).

Parameter	Type	Description
`query`	string required	Search keyword
`cat`	integer optional	Category code: `0`=All, `201`=Movies, `207`=HD Movies, `205`=TV, `208`=HD TV

curl -H "X-Api-Key: KEY" "https://moviebase.ikkazuma.com/api/v1/torrent/search?query=Squid+Game&cat=205"

Response fields: id, name, info_hash, seeders, leechers, size, size_formatted, magnet, source_id, category, status

GET /torrent/{sourceId}/{torrentId}

Get detailed info for a specific torrent including description and screenshots.

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/torrent/1/83072737

GET /torrent/{sourceId}/{torrentId}/files

Get the file listing for a specific torrent.

curl -H "X-Api-Key: KEY" https://moviebase.ikkazuma.com/api/v1/torrent/1/83072737/files

Response: Array of { name, size, size_formatted }

Image URLs

Image paths are automatically rewritten to full URLs with optimal sizes:

Field	Size	Example
`poster_path`	w500	`https://image.tmdb.org/t/p/w500/...`
`backdrop_path`	w1280	`https://image.tmdb.org/t/p/w1280/...`
`logo_path`	w500	`https://image.tmdb.org/t/p/w500/...`
`profile_path`	w500	`https://image.tmdb.org/t/p/w500/...`
`still_path`	w1280	`https://image.tmdb.org/t/p/w1280/...`
`file_path`	w500	`https://image.tmdb.org/t/p/w500/...`

This applies recursively to nested objects (e.g. production_companies[].logo_path, credits.cast[].profile_path).

Parameter	Type	Description
`position`	string optional	Filter by position: `header`, `sidebar`, `footer`, `overlay`, `content_top`, `content_bottom`

Field	Type	Description
`id`	integer	Advertisement ID
`name`	string	Ad label for identification
`type`	string	`direct_link`, `banner`, `popup_under`, or `redirection`
`content_type`	string	`url` (direct link/redirect URL) or `code` (raw HTML/JS snippet)
`position`	string	Display slot
`banner_shape`	string\|null	`horizontal`, `vertical`, `box`, `strip`, or `null`
`snippet`	string	Ad tag, script, or URL to serve
`provider`	string\|null	Provider name
`sort_order`	integer	Sort priority within position

Curations

AI-generated or manually curated collections of movies or TV shows. Each curation has a content_type (movie or tv) that determines the media type of items.

List Curations

GET /curations

Get all active curations, paginated.

Parameter	Type	Description
`per_page`	integer optional	Results per page (default 10, max 50)
`content_type`	string optional	Filter by type: `movie` or `tv`

curl -H "X-Api-Key: KEY" "https://moviebase.ikkazuma.com/api/v1/curations?content_type=movie&per_page=5"

Response:

{
  "data": [
    {
      "id": 1,
      "title": "Sad Movies for Gloomy Sunday",
      "slug": "sad-movies-for-gloomy-sunday",
      "content_type": "movie",
      "cover_image": "https://image.tmdb.org/t/p/w1280/...",
      "description": "A curated collection of melancholic films...",
      "prompt": "sad movies for gloomy sunday",
      "movie_ids": [550, 278, 13],
      "is_active": true,
      "mode": "manual",
      "sort_order": 0,
      "created_at": "2026-09-01T00:00:00.000000Z",
      "updated_at": "2026-09-01T00:00:00.000000Z"
    }
  ],
  "links": { "..." },
  "meta": { "..." }
}

Fields:

Field	Type	Description
`id`	integer	Curation ID
`title`	string	Curation title
`slug`	string	URL-safe slug (unique)
`content_type`	string	`movie` or `tv`
`cover_image`	string\|null	Backdrop image URL
`description`	string	Collection description
`prompt`	string	Original generation prompt
`movie_ids`	array	Array of media item IDs
`mode`	string	`manual` or `auto`
`created_at`	string	ISO 8601 timestamp

Get Curation Detail

GET /curations/{slug}

Get a single curation with full item details.

Parameter	Type	Description
`slug`	string required	Curation slug

curl -H "X-Api-Key: KEY" "https://moviebase.ikkazuma.com/api/v1/curations/sad-movies-for-gloomy-sunday"

Response:

{
  "id": 1,
  "title": "Sad Movies for Gloomy Sunday",
  "description": "A curated collection of melancholic films...",
  "slug": "sad-movies-for-gloomy-sunday",
  "content_type": "movie",
  "cover_image": "https://image.tmdb.org/t/p/w1280/...",
  "prompt": "sad movies for gloomy sunday",
  "items": [
    {
      "id": 550,
      "title": "Fight Club",
      "overview": "An insomniac office worker...",
      "release_date": "1999-10-15",
      "poster_path": "https://image.tmdb.org/t/p/w500/...",
      "backdrop_path": "https://image.tmdb.org/t/p/w1280/...",
      "media_type": "movie",
      ...
    }
  ],
  "created_at": "2026-09-01T00:00:00Z"
}

Fields:

Field	Type	Description
`id`	integer	Curation ID
`title`	string	Curation title
`slug`	string	URL-safe slug
`content_type`	string	`movie` or `tv`
`items`	array	Array of media objects. Each item includes a `media_type` field matching the curation's `content_type`.
`items[].id`	integer	Media item ID
`items[].title`	string	Movie title (or `name` for TV)
`items[].media_type`	string	`movie` or `tv`

Only active curations are returned. Items are fetched from upstream media API and may include fields like poster, backdrop, overview, vote_average, etc. The media_type field on each item matches the curation's content_type.

Error Responses

Status	Body	Cause
401	`{"error": "Missing API key"}`	No `X-Api-Key` header provided
401	`{"error": "Invalid API key"}`	Key not found or inactive
404	`{"error": "Not found"}`	Blocked item or non-existent resource
422	`{"error": "..."}`	Validation error (e.g. missing required param)
502	`{"error": "Service unavailable"}`	Upstream API unavailable or no key configured

Additional Notes

Caching: Media metadata responses are cached for 24 hours. Subsequent identical requests return cached data instantly.
Rate Limiting: Requests are rate-limited. If you receive a 429 response, wait before retrying.
Block Filtering: Admin-managed block list filters content from all list and search results.
Torrent Sorting: Torrent results are sorted by seeders (highest first) across all configured sources.
Magnet Links: Each torrent result includes a ready-to-use magnet link.
Data Attribution: Movie and TV metadata is provided by The Movie Database (TMDB). This product uses the TMDB API but is not endorsed or certified by TMDB.
Watch Providers: Streaming availability data is provided by JustWatch.

Contents

Authentication

Base URL

Movies

TV Shows

Search

Genres

Discover

Person

Watch Providers

Torrent Endpoints

Image URLs

Advertisements

Curations

List Curations

Get Curation Detail

Error Responses

Additional Notes

API Documentation

Contents

Authentication

Base URL

Trending

Movies

TV Shows

Search

Genres

Discover

Person

Watch Providers

Torrent Endpoints

Image URLs

Advertisements

Curations

List Curations

Get Curation Detail

Error Responses

Additional Notes