Movie Endpoint

Welcome to the documentation for the WatchThis Movie and Show Recommending API. This API allows you to fetch details about specific shows or movies and recommends related shows based on genres and vote averages.

Base URL

The base URL for the WatchThis API is: https://watchthis.api.com/api/v1/movie

Authentication

To use the WatchThis API, you need to include your RapidAPI key in the headers of your HTTP requests. Add the following header to your requests:

X-RapidAPI-Key: YOUR-API-KEY

Endpoint

• GET /api/v1/movie

Query Parameters

• ids (Required): Comma-separated list of show IDs (TMDB).

Example Request

curl -X GET "https://watchthis.api.com/api/v1/movie?ids=123,456" -H "X-RapidAPI-Key: YOUR-API-KEY"

Response

The API will respond with a JSON object containing an array of related shows. Each show object includes details such as tmdb_id, tmdb_poster_path, tmdb_backdrop_path, title, original_title, release_date, vote_average, and match_score.

{
  "related": [
    {
      "tmdb_id": 123,
      "tmdb_poster_path": "/path/to/poster",
      "tmdb_backdrop_path": "/path/to/backdrop",
      "title": "Show Title",
      "original_title": "Original Title",
      "release_date": "2022-01-01",
      "vote_average": 8.5,
      "match_score": 75
    },
    // ... more related shows
  ]
}

• match_score are the factor on how wee rank the results.

Error Handling

If there is an issue with the request or the server, the API will respond with an appropriate HTTP status code and an error message in the JSON format:

{
  "error": "Internal Server Error"
}

For more detailed error messages, refer to the console log on the server.

Developer Notes

• API Key Security: Keep your RapidAPI key secure and do not expose it publicly.
• Rate Limiting: The WatchThis API is subject to rate limiting as per RapidAPI's policies. Check the RapidAPI documentation for rate limit details.
• Feedback and Support: If you have any questions, encounter issues, or want to provide feedback, visit the RapidAPI community forums.