PHPackages                             martincamen/jellyseerr-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. martincamen/jellyseerr-php

ActiveLibrary[API Development](/categories/api)

martincamen/jellyseerr-php
==========================

PHP SDK for Jellyseerr/Seerr REST API

0.1.0(3mo ago)011MITPHPPHP ^8.3

Since Jan 21Pushed 3mo agoCompare

[ Source](https://github.com/MartinCamen/jellyseerr-php)[ Packagist](https://packagist.org/packages/martincamen/jellyseerr-php)[ Docs](https://github.com/martincamen/jellyseerr-php)[ RSS](/packages/martincamen-jellyseerr-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (7)Versions (2)Used By (1)

Jellyseerr PHP SDK
==================

[](#jellyseerr-php-sdk)

A PHP SDK for the Jellyseerr/Overseerr REST API.

Important

This project is still being developed and breaking changes might occur even between patch versions.

The aim is to follow semantic versioning as soon as possible.

Ecosystem
---------

[](#ecosystem)

PackageDescription[radarr-php](https://github.com/martincamen/radarr-php)PHP SDK for Radarr[sonarr-php](https://github.com/martincamen/sonarr-php)PHP SDK for Sonarr[jellyseerr-php](https://github.com/martincamen/jellyseerr-php)PHP SDK for Jellyseerr[laravel-radarr](https://github.com/martincamen/laravel-radarr)Laravel integration for Radarr[laravel-sonarr](https://github.com/martincamen/laravel-sonarr)Laravel integration for Sonarr[laravel-jellyseerr](https://github.com/martincamen/laravel-jellyseerr)Laravel integration for JellyseerrRequirements
------------

[](#requirements)

- PHP 8.3+

Installation
------------

[](#installation)

```
composer require martincamen/jellyseerr-php
```

Quick Start
-----------

[](#quick-start)

```
use MartinCamen\Jellyseerr\JellySeerr;

$jellyseerr = JellySeerr::create(
    host: 'localhost',
    port: 5055,
    apiKey: 'your-api-key',
    useHttps: false,
);

// Get all media requests
$requests = $jellyseerr->requests()->all();

// Search for movies and series
$results = $jellyseerr->search()->search('Breaking Bad');

// Get movie details by TMDB ID
$movie = $jellyseerr->movies()->find(27205);

// Get system status
$status = $jellyseerr->system()->status();
```

Usage
-----

[](#usage)

### Requests

[](#requests)

Manage media requests (approve, decline, create, etc.):

```
use MartinCamen\Jellyseerr\Data\Options\RequestOptions;
use MartinCamen\Jellyseerr\Data\Responses\MediaRequest;
use MartinCamen\Jellyseerr\Data\Responses\RequestPage;

// Get all requests (paginated)
/** @var RequestPage $requests */
$requests = $jellyseerr->requests()->all();

foreach ($requests as $request) {
    echo $request->id;
    echo $request->status->value;
    echo $request->requestedBy?->displayName;
}

// Get requests with filtering
$options = RequestOptions::make()
    ->withFilter('pending')
    ->withTake(50);
$requests = $jellyseerr->requests()->all($options);

// Get a specific request
/** @var MediaRequest $request */
$request = $jellyseerr->requests()->find(1);

// Get request counts by status
$counts = $jellyseerr->requests()->count();
echo "Pending: {$counts->pending}";
echo "Approved: {$counts->approved}";
echo "Total: {$counts->total}";

// Create a movie request
$request = $jellyseerr->requests()->movie(tmdbId: 27205);

// Create a series request (all seasons)
$request = $jellyseerr->requests()->series(tmdbId: 1396);

// Create a series request (specific seasons)
$request = $jellyseerr->requests()->series(tmdbId: 1396, seasons: [1, 2, 3]);

// Create a 4K request
$request = $jellyseerr->requests()->movie(tmdbId: 27205, is4k: true);

// Approve a pending request
$request = $jellyseerr->requests()->approve(1);

// Decline a pending request
$request = $jellyseerr->requests()->decline(1);

// Retry a failed request
$request = $jellyseerr->requests()->retry(1);

// Delete a request
$jellyseerr->requests()->delete(1);
```

### Movies

[](#movies)

Get movie details and related content:

```
use MartinCamen\Jellyseerr\Data\Responses\MovieDetails;
use MartinCamen\Jellyseerr\Data\Responses\SearchPage;

// Get movie details by TMDB ID
/** @var MovieDetails $movie */
$movie = $jellyseerr->movies()->find(27205);

echo $movie->title;
echo $movie->overview;
echo $movie->releaseDate;
echo $movie->status;

// Get movie recommendations
/** @var SearchPage $recommendations */
$recommendations = $jellyseerr->movies()->recommendations(27205);

foreach ($recommendations as $result) {
    echo $result->title;
    echo $result->mediaType;
}

// Get similar movies
$similar = $jellyseerr->movies()->similar(27205);
```

### Series

[](#series)

Get series details and related content:

```
use MartinCamen\Jellyseerr\Data\Responses\SeriesDetails;
use MartinCamen\Jellyseerr\Data\Responses\SearchPage;

// Get series details by TMDB ID
/** @var SeriesDetails $series */
$series = $jellyseerr->series()->find(1396);

echo $series->name;
echo $series->overview;
echo $series->firstAirDate;
echo $series->status;
echo $series->numberOfSeasons;

// Get series recommendations
/** @var SearchPage $recommendations */
$recommendations = $jellyseerr->series()->recommendations(1396);

// Get similar series
$similar = $jellyseerr->series()->similar(1396);

// Get season details
$season = $jellyseerr->series()->season(tmdbId: 1396, seasonId: 1);
```

### Search

[](#search)

Search and discover content:

```
use MartinCamen\Jellyseerr\Data\Responses\SearchPage;

// Search for movies and series
/** @var SearchPage $results */
$results = $jellyseerr->search()->search('Inception');

foreach ($results as $result) {
    echo $result->title;
    echo $result->mediaType; // 'movie' or 'tv'
    echo $result->id; // TMDB ID
}

// Paginated search
$page2 = $jellyseerr->search()->search('Inception', page: 2);

// Discover movies
$movies = $jellyseerr->search()->discoverMovies();

// Discover series
$series = $jellyseerr->search()->discoverSeries();

// Get trending content
$trending = $jellyseerr->search()->trending();

// Get upcoming movies
$upcoming = $jellyseerr->search()->upcoming();
```

### Users

[](#users)

Manage users and their requests:

```
use MartinCamen\Jellyseerr\Data\Responses\User;
use MartinCamen\Jellyseerr\Data\Responses\UserPage;

// Get all users (paginated)
/** @var UserPage $users */
$users = $jellyseerr->users()->all();

foreach ($users as $user) {
    echo $user->id;
    echo $user->displayName;
    echo $user->email;
}

// Get all users with pagination
$users = $jellyseerr->users()->all(['take' => 50, 'skip' => 0]);

// Get a specific user
/** @var User $user */
$user = $jellyseerr->users()->find(1);

// Get the currently authenticated user
$me = $jellyseerr->users()->me();

// Get a user's requests
$requests = $jellyseerr->users()->requests(userId: 1);

// Get a user's watchlist
$watchlist = $jellyseerr->users()->watchlist(userId: 1);
```

### System

[](#system)

Get system status and settings:

```
use MartinCamen\Jellyseerr\Data\Responses\SystemSummary;

// Get system status
/** @var SystemSummary $status */
$status = $jellyseerr->system()->status();

echo $status->version;
echo $status->commitTag;

// Get appdata path information
$appdata = $jellyseerr->system()->appdata();

// Get public settings (no auth required)
$settings = $jellyseerr->system()->publicSettings();
```

Request Options
---------------

[](#request-options)

The SDK provides typed request option classes:

```
use MartinCamen\Jellyseerr\Data\Options\RequestOptions;

// Create options with fluent builder
$options = RequestOptions::make()
    ->withFilter('pending')      // all, pending, approved, processing, available
    ->withSort('added')          // added, modified
    ->withRequestedBy(1)         // filter by user ID
    ->withTake(50)               // page size
    ->withSkip(0);               // offset

$requests = $jellyseerr->requests()->all($options);

// Or pass array directly
$requests = $jellyseerr->requests()->all([
    'filter' => 'pending',
    'take'   => 50,
]);
```

Error Handling
--------------

[](#error-handling)

The SDK throws specific exceptions for different error types:

```
use MartinCamen\ArrCore\Exceptions\AuthenticationException;
use MartinCamen\ArrCore\Exceptions\ConnectionException;
use MartinCamen\ArrCore\Exceptions\NotFoundException;
use MartinCamen\ArrCore\Exceptions\ValidationException;

try {
    $movie = $jellyseerr->movies()->find(999999999);
} catch (AuthenticationException $e) {
    // Invalid API key
} catch (NotFoundException $e) {
    // Movie not found
} catch (ConnectionException $e) {
    // Could not connect to server
} catch (ValidationException $e) {
    // Validation error
    print_r($e->getErrors());
}
```

Testing
-------

[](#testing)

The SDK provides testing utilities for easy mocking:

```
use PHPUnit\Framework\Attributes\Test;
use MartinCamen\Jellyseerr\Testing\Factories\MovieDetailsFactory;
use MartinCamen\Jellyseerr\Testing\Factories\RequestFactory;
use MartinCamen\Jellyseerr\Testing\Factories\SearchResultFactory;
use MartinCamen\Jellyseerr\Testing\JellyseerrFake;

class MyTest extends TestCase
{
    #[Test]
    public function itDisplaysRequests(): void
    {
        $fake = new JellyseerrFake();

        $requests = $fake->requests()->all();

        $this->assertNotEmpty($requests);
        $fake->assertCalled('requests');
    }

    #[Test]
    public function itSearchesForMovies(): void
    {
        $fake = new JellyseerrFake();

        $results = $fake->search()->search('Inception');

        $fake->assertCalled('search');
    }
}
```

### Using Factories

[](#using-factories)

```
use MartinCamen\Jellyseerr\Testing\Factories\MovieDetailsFactory;
use MartinCamen\Jellyseerr\Testing\Factories\RequestFactory;
use MartinCamen\Jellyseerr\Testing\Factories\SearchResultFactory;
use MartinCamen\Jellyseerr\Testing\Factories\SeriesDetailsFactory;
use MartinCamen\Jellyseerr\Testing\Factories\SystemStatusFactory;
use MartinCamen\Jellyseerr\Testing\Factories\UserFactory;

// Create movie details data
$movie = MovieDetailsFactory::make(27205);
$movie = MovieDetailsFactory::make(27205, [
    'title'       => 'Inception',
    'releaseDate' => '2010-07-16',
]);

// Create series details data
$series = SeriesDetailsFactory::make(1396);
$series = SeriesDetailsFactory::make(1396, [
    'name'            => 'Breaking Bad',
    'numberOfSeasons' => 5,
]);

// Create request data
$request = RequestFactory::make(1);
$requests = RequestFactory::makeMany(5);

// Create search result data
$results = SearchResultFactory::makeMany(10);
$movies = SearchResultFactory::makeMovies(5);
$series = SearchResultFactory::makeSeries(5);

// Create user data
$user = UserFactory::make(1);

// Create system status data
$status = SystemStatusFactory::make();
$status = SystemStatusFactory::make([
    'version'   => '2.0.0',
    'commitTag' => 'abc123',
]);
```

Architecture
------------

[](#architecture)

The SDK follows a layered architecture:

```
JellySeerr (Public SDK)
  ↓
Action Classes (RequestActions, MovieActions, etc.)
  ↓
Endpoint Classes (RequestEndpoint, MediaEndpoint, etc.)
  ↓
HTTP Client

```

- **`JellySeerr`**: The public entry point returning action classes
- **Action Classes**: Type-safe methods for each domain (`requests()->all()`, `movies()->find(1)`)
- **Endpoint Classes**: Low-level API calls using Jellyseerr's native terminology
- **Response Types**: Typed DTOs from the SDK (`MovieDetails`, `RequestPage`, etc.)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance78

Regular maintenance activity

Popularity1

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

117d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8720813?v=4)[Martin Camen](/maintainers/MartinCamen)[@MartinCamen](https://github.com/MartinCamen)

---

Top Contributors

[![MartinCamen](https://avatars.githubusercontent.com/u/8720813?v=4)](https://github.com/MartinCamen "MartinCamen (1 commits)")

---

Tags

apisdkrequestsjellyseerrmedia-serveroverseerrseerr

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/martincamen-jellyseerr-php/health.svg)

```
[![Health](https://phpackages.com/badges/martincamen-jellyseerr-php/health.svg)](https://phpackages.com/packages/martincamen-jellyseerr-php)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[hubspot/api-client

Hubspot API client

23414.2M16](/packages/hubspot-api-client)[mailchimp/transactional

458.9M16](/packages/mailchimp-transactional)[resend/resend-php

Resend PHP library.

564.7M21](/packages/resend-resend-php)[checkout/checkout-sdk-php

Checkout.com SDK for PHP

553.3M7](/packages/checkout-checkout-sdk-php)[crowdin/crowdin-api-client

PHP client library for Crowdin API v2

611.5M5](/packages/crowdin-crowdin-api-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)