API Documentation

Complete reference for our REST API. All endpoints return JSON responses.

Authentication

All API requests require authentication using X-API-KEY Authorization header.

GET/v1/validate

Validate api key is valid and can retrieve responses.

No parameters required for this endpoint.

curl -X POST \
  -H "X-API-KEY: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  https://api.cinema-watch.com/v1/validate

200Successful response

json

{
  "success": true
}

401Bad request

json

{
  "success": false,
  "error": "Unauthorized API Key"
}

GET/v1/movie/search

Retrieve a list of movies in the system based on search query.

Name	Type	Required	Default	Description
page	integer	Optional	1	Page number for pagination
limit	integer	Optional	10	Number of items per page (max 100)
search	string	Required		Search term to filter movies

curl -X GET \
  -H "X-API-KEY: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  https://api.cinema-watch.com/v1/movie/search

200Successful response

json

{
  "success": true,
  "data": [],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2
  }
}

401Bad request

json

{
  "success": false,
  "error": "Unauthorized API Key"
}

GET/v1/tv/search

Retrieve a list of tv shows in the system based on search query.

Name	Type	Required	Default	Description
page	integer	Optional	1	Page number for pagination
limit	integer	Optional	10	Number of items per page (max 100)
search	string	Required		Search term to filter tv shows

curl -X GET \
  -H "X-API-KEY: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  https://api.cinema-watch.com/v1/tv/search

200Successful response

json

{
  "success": true,
  "data": [],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2
  }
}

401Bad request

json

{
  "success": false,
  "error": "Unauthorized API Key"
}