โšก v2.0.0 ยท REST API ยท JSON Responses

Movie API

A blazing fast REST API for movies & TV shows. Search, browse trending content, and get detailed metadata โ€” all in JSON.

BASE URL /api/v2
4
Endpoints
GET
Method
JSON
Response Format
500K+
Titles Available
๐Ÿ”

Advanced Search

Search across thousands of movies and TV series with real-time results.

๐Ÿ“Š

Trending Content

Get what's trending this week across movies and TV shows.

๐ŸŽญ

Rich Metadata

Full cast, trailers, ratings, genres, runtime, and more.

โšก

Fast Responses

Optimized API with response times under 300ms.

๐Ÿ” Authentication

If an API key is configured, include it as a Bearer token in every request header:

Authorization: Bearer YOUR_API_KEY

API Endpoints

GET /api/v2/homepage Homepage content

Returns trending, popular movies, popular TV shows, and top rated movies all in one call.

Example Request

GET /api/v2/homepage

Example Response

{
  "status": 200,
  "success": true,
  "results": {
    "trending": [...],
    "popularMovies": [...],
    "popularTV": [...],
    "topRated": [...]
  }
}
GET /api/v2/trending Trending this week

Get trending movies and TV series based on current popularity.

Parameters

NameTypeDescription
pageinteger optionalPage number (default: 1)

Example Request

GET /api/v2/trending?page=1

Example Response

{
  "status": 200,
  "success": true,
  "page": 1,
  "totalPages": 500,
  "results": [
    {
      "id": 85552,
      "title": "Euphoria",
      "type": "tv",
      "poster": "https://image.tmdb.org/t/p/w500/...",
      "rating": 8.3,
      "genres": ["Drama"]
    }
  ]
}
GET /api/v2/search/{query} Search movies & TV

Search for movies and TV series by title. Returns paginated results with detailed information.

Parameters

NameTypeDescription
querystringSearch query (movie or TV series title)
pageinteger optionalPage number (default: 1)

Example Request

GET /api/v2/search/Black%20Panther?page=1
GET /api/v2/info/{id} Full movie/show details

Get detailed information about a specific movie or TV series including cast, trailer, and metadata.

Parameters

NameTypeDescription
idintegerMovie or TV series ID (from search results)

Example Request

GET /api/v2/info/299536

Example Response

{
  "status": 200,
  "success": true,
  "result": {
    "id": 299536,
    "title": "Avengers: Infinity War",
    "type": "movie",
    "poster": "https://image.tmdb.org/t/p/w500/...",
    "backdrop": "https://image.tmdb.org/t/p/w1280/...",
    "rating": 8.2,
    "runtime": 149,
    "genres": ["Action", "Adventure"],
    "cast": [...],
    "trailer": "https://www.youtube.com/watch?v=..."
  }
}

Code Examples

JavaScript
const BASE = '/api/v2'; async function search(query) { const res = await fetch(`${BASE}/search/${query}?page=1`); return res.json(); } async function getInfo(id) { const res = await fetch(`${BASE}/info/${id}`); return res.json(); }