TV Endpoint

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

Base URL

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

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/tv

Query Parameters

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

Example Request

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

Response

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

{
  "related": [
    {
      "tmdb_id": 123,
      "tmdb_poster_path": "/path/to/poster",
      "tmdb_backdrop_path": "/path/to/backdrop",
      "name": "Show Name",
      "original_name": "Original Name",
      "first_air_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.