🎬 Movies API Documentation

📚 Available Endpoints

🔎 Query Parameters

The following query parameters can be used to filter and sort the movie results:

• title — Search for movie title (partial match). Example: ?title=Inception
• min_vote_average — Minimum average vote or rating given by viewers. Example: ?min_vote_average=7.5
• min_vote_count — Minimum total count of votes received for the movie. Example: ?min_vote_count=1000
• status — The status of the movie (e.g., Released, Rumored, Post Production). Example: ?status=Released
• release_date — Date when the movie was released (format: YYYY-MM-DD). Example: ?release_date=2021-12-25
• min_revenue — Minimum total revenue generated by the movie. Example: ?min_revenue=1000000
• min_runtime — Minimum duration of the movie in minutes. Example: ?min_runtime=120
• adult — Indicates if the movie is suitable only for adult audiences. Example: ?adult=true
• has_backdrop — Only return movies with a backdrop image. Example: ?has_backdrop=true
• sort_by — Sort by title, vote_average, vote_count, release_date, revenue, or runtime. Example: ?sort_by=vote_average
• sort_order — Sort order: asc or desc (default: asc). Example: ?sort_order=desc
• limit — Limit the number of results (default: 20, max: 100). Example: ?limit=10

📄 Example Requests

📦 Response Format

The API returns a JSON array of movie objects. Each movie object contains the following fields:

{
    "id": 12345,
    "title": "Inception",
    "vote_average": 8.3,
    "vote_count": 12345,
    "status": "Released",
    "release_date": "2010-07-16",
    "revenue": 829895144,
    "runtime": 148,
    "adult": false,
    "backdrop_path": "https://example.com/backdrop.jpg"
}

🧪 Live API Tester

🔒 Privacy Policy

We value your privacy. Please read our Privacy Policy to understand how we collect, use, and protect your personal information.

Read our Privacy Policy

📜 Terms of Service

By using our API, you agree to our Terms of Service. Please review them to understand your rights and responsibilities.

Read our Terms of Service