IHaveMovie API

RESTful API for accessing movie data and user interactions

Version 1.0.0 JSON API Rate Limited

Quick Start

curl -H "Accept: application/json" https://ihavemovie.com/api/movies

All API responses are in JSON format. Include Accept: application/json header for best compatibility.

Rate Limiting

API requests are limited to 100 requests per hour per IP address. Rate limit information is included in response headers:

  • X-RateLimit-Limit: Maximum requests per hour
  • X-RateLimit-Remaining: Requests remaining in current window
  • X-RateLimit-Reset: Time when rate limit resets

Authentication

Some endpoints require user authentication. Authentication is session-based:

  1. Login through the web interface at /pages/login.php
  2. Session cookies will be automatically included in subsequent API requests
  3. Admin operations require admin privileges

Movies Endpoints

GET /api/movies

Get all movies with pagination support.

Query Parameters:
  • limit - Number of items per page (max 100, default 20)
  • offset - Number of items to skip (default 0)
  • page - Page number (alternative to offset)
curl https://ihavemovie.com/api/movies?limit=10&page=2

GET /api/movies/{id}

Get detailed information about a specific movie.

Query Parameters:
  • include - Additional data to include (genres, cast, reviews)
curl https://ihavemovie.com/api/movies/1?include=genres,cast

GET /api/movies/search

Search movies by title, description, genre, or year.

Query Parameters:
  • q - Search query (title, description)
  • genre - Genre ID filter
  • year - Release year filter
  • limit - Results per page (default 20)
  • offset - Results to skip (default 0)
curl "https://ihavemovie.com/api/movies/search?q=action&year=2023"

GET /api/movies/featured

Get featured movies

GET /api/movies/trending

Get trending movies

GET /api/movies/popular

Get popular movies

GET /api/movies/top-rated

Get top rated movies

Admin Only Operations

POST /api/movies - Create new movie
PUT /api/movies/{id} - Update movie
DELETE /api/movies/{id} - Delete movie

Response Examples

Movie List Response

{
  "data": [
    {
      "id": 1,
      "title": "The Shawshank Redemption",
      "release_date": "1994-09-23",
      "vote_average": 8.7,
      "poster_path": "/q6y0Go1tsGEsmtFryDOJo3dEmqu.jpg",
      "poster_url": "https://image.tmdb.org/t/p/w500/q6y0Go1tsGEsmtFryDOJo3dEmqu.jpg"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 1000,
    "has_more": true
  }
}

Error Response

{
  "error": "Movie not found"
}

HTTP Status Codes

Success Codes

  • 200 OK - Request successful
  • 201 Created - Resource created

Error Codes

  • 400 Bad Request - Invalid request
  • 401 Unauthorized - Authentication required
  • 403 Forbidden - Insufficient permissions
  • 404 Not Found - Resource not found
  • 429 Too Many Requests - Rate limit exceeded
  • 500 Internal Server Error - Server error

Try it Out

You can test the API endpoints directly using curl, Postman, or any HTTP client. Here are some example requests you can try:

curl -H "Accept: application/json" https://ihavemovie.com/api/movies/featured
curl -H "Accept: application/json" "https://ihavemovie.com/api/movies/search?q=action"
curl -H "Accept: application/json" https://ihavemovie.com/api/movies/1