SparkScrape API Documentation

Welcome to the SparkScrape API. This service provides access to movie and TV show ratings from various sources including TMDB, Metacritic, Rotten Tomatoes, and CSFD.

GET

/movie/download/:tmdb_id

Get download information for a movie by its TMDB ID.

:tmdb_id (integer, required) - The TMDB ID of the movie

Example: GET /movie/download/550

GET

/tv/download/:tmdb_id

Get download information for a TV show by its TMDB ID.

:tmdb_id (integer, required) - The TMDB ID of the TV show

Example: GET /tv/download/1399

GET

/:category/:tmdb_id

Get detailed information about a movie or TV show from multiple sources.

:category (string, required) - Either "movie" or "tv"

:tmdb_id (integer, required) - The TMDB ID of the content

Examples:
GET /movie/550 (for movies)
GET /tv/1399 (for TV shows)

Response Format

All endpoints return JSON responses with the following structure:

{
    "download_url": "string",  // Only for download endpoints
    "file_size": "string",     // Only for download endpoints
    "tmdb": { ... },          // TMDB data
    "metacritic": { ... },    // Metacritic ratings
    "rotten_tomatoes": { ... }, // Rotten Tomatoes ratings
    "csfd": { ... },          // CSFD ratings
    "ai_score": number        // Calculated AI score
}

Rate Limiting

The API enforces rate limiting to ensure fair usage. Please be considerate of the service and implement appropriate caching on the client side.