🎬 ProMovieDB API

Version: 1.0.0
License: Apache 2.0
Base URL: https://api.promoviedb.com

🧩 Overview

The ProMovieDB API provides developers with powerful endpoints to access movie, TV, and people data, including trending charts, detailed metadata, and search capabilities.
It is designed to make it easy to integrate entertainment data into your apps, dashboards, and services.

⚠️ Important: You must apply for an API key before using the API.
Each request must include your API key as a query parameter.

🔐 Authentication

All requests require an api_key parameter.

Example:

If the API key is missing or invalid, the server returns a 401 Unauthorized response.

🗂️ API Categories

Category	Description
Movie	Get movie lists such as Now Playing, Upcoming, Popular, and Top Rated.
TV	Get popular, airing today, and top-rated TV shows.
People	Get popular people and their detailed profiles.
Search	Search across movies, TV shows, and people.
Trending	Retrieve trending movies, TV shows, and people (daily or weekly).
Detail	Retrieve detailed metadata for a movie, TV show, or person by ID.

🚀 Example Requests

Get Popular Movies

Search for a Movie or TV Show

Get Movie Details

⚙️ Common Parameters

Parameter	Type	Required	Description
`api_key`	string	✅	Your API key
`language`	string	❌	ISO 639-1 code (default: `en`)
`page`	integer	❌	Page number (default: `1`)
`include_adult`	boolean	❌	Include adult content (default: `false`)

📦 Example Response

{
  "page": 1,
  "results": [
    {
      "id": 550,
      "title": "Fight Club",
      "release_date": "1999-10-15",
      "popularity": 83.7,
      "vote_average": 8.4
    }
  ],
  "total_pages": 500,
  "total_results": 10000
}

⚠️ Error Codes

Status	Meaning
`200`	✅ Success
`400`	❌ Invalid request
`401`	🔒 Missing or invalid API key
`404`	🚫 Resource not found
`500`	💥 Internal server error

🧠 Best Practices

Cache responses where possible to minimize API calls.

Always handle pagination with page parameters.

Use the language parameter to localize content.

Monitor response status and respect rate limits.

🧰 Technical Summary

Base URL: https://api.promoviedb.com/v1

Authentication: api_key query parameter

Response Format: JSON

API Style: RESTful

📞 Support

If you have questions, require higher rate limits, or need technical support, please contact:

📧 Email: [email protected]

Introduction

🎬 ProMovieDB API#

🧩 Overview#

🔐 Authentication#

🗂️ API Categories#

🚀 Example Requests#

Get Popular Movies#

Search for a Movie or TV Show#

Get Movie Details#

⚙️ Common Parameters#

📦 Example Response#

⚠️ Error Codes#

🧠 Best Practices#

🧰 Technical Summary#

📞 Support#