Files

1.3 KiB

Jellyseerr API Reference

Base URL

https://your-jellyseerr-server.com/api/v1

Authentication

Use API key in header:

X-Api-Key: your-api-key

Key Endpoints

GET /search?query={query}

Returns movies and TV shows matching the query.

Response:

{
  "results": [
    {
      "id": 12345,
      "mediaType": "movie" | "tv",
      "title": "Movie Title",
      "name": "TV Show Name",
      "releaseDate": "2020-01-01",
      "firstAirDate": "2020-01-01",
      "overview": "Description",
      "mediaInfo": {
        "status": 0-5
      }
    }
  ]
}

Request Media

POST /request
Content-Type: application/json

Movie Request:

{
  "mediaId": 12345,
  "mediaType": "movie"
}

TV Request (all seasons):

{
  "mediaId": 12345,
  "mediaType": "tv",
  "seasons": "all"
}

TV Request (specific seasons):

{
  "mediaId": 12345,
  "mediaType": "tv",
  "seasons": [1, 2, 3]
}

Media Status Codes

  • 0: NOT_REQUESTED
  • 1: PENDING
  • 2: PROCESSING
  • 3: PARTIALLY_AVAILABLE
  • 4: AVAILABLE
  • 5: AVAILABLE (alternative)

Get Status

GET /status

Returns server status and version info.

Rate Limits

Standard rate limits apply. Be respectful with API usage.

Documentation

Full API docs: https://github.com/Fallenbagel/jellyseerr