PHPackages                             onursimsek/opensubtitles-api - 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. [HTTP & Networking](/categories/http)
4. /
5. onursimsek/opensubtitles-api

ActiveLibrary[HTTP & Networking](/categories/http)

onursimsek/opensubtitles-api
============================

OpenSubtitles REST API SDK for PHP

v2.0.1(2y ago)72322MITPHP

Since Dec 16Pushed 2y ago1 watchersCompare

[ Source](https://github.com/onursimsek/opensubtitles-api)[ Packagist](https://packagist.org/packages/onursimsek/opensubtitles-api)[ RSS](/packages/onursimsek-opensubtitles-api/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (2)Dependencies (3)Versions (5)Used By (0)

OpenSubtitles SDK
=================

[](#opensubtitles-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/1bcb51065d13fb263d44c7b50ee756855d33374479f5f2a25b715f42000dbc47/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f6e757273696d73656b2f6f70656e7375627469746c65732d6170692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/onursimsek/opensubtitles-api)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Tests](https://github.com/onursimsek/opensubtitles-api/workflows/tests/badge.svg)](https://github.com/onursimsek/opensubtitles-api/actions)[![Quality Score](https://camo.githubusercontent.com/74681865cb2ba137e23df9436af6757d8803431c9c534ab00d08d654bbd18cd6/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6f6e757273696d73656b2f6f70656e7375627469746c65732d6170692e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/onursimsek/opensubtitles-api)[![Total Downloads](https://camo.githubusercontent.com/857c1095a45b429856506e3585b00cd74e9bd35bf530c9c0ee83dcca6034e8ce/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f6e757273696d73656b2f6f70656e7375627469746c65732d6170692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/onursimsek/opensubtitles-api)

OpenSubtitle.com REST API SDK for PHP

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

[](#installation)

You can install the package via composer:

```
composer require onursimsek/opensubtitles-api
```

Usage
-----

[](#usage)

Create a new instance with api key

```
$client = new OpenSubtitles();
```

### Auth

[](#auth)

```
// Login
$auth = $client->authentication->login(['username' => $username, 'password' => $password]);
// You can use short way
// $client->login($username, $password);

// Logout
$client->authentication->logout($auth->token);
```

### Find Subtitles

[](#find-subtitles)

```
// Find subtitles (for all parameters: https://opensubtitles.stoplight.io/docs/opensubtitles-api/open_api.json/paths/~1api~1v1~1subtitles/get)
$subtitles = $client->find([
    'id' => '',
    'query' => '',
    'imdb_id' => '',
    ...
]);

foreach ($subtitles->data as $subtitle) {
    echo $subtitle->id . PHP_EOL;
    echo $subtitle->attributes->language . PHP_EOL;
    echo $subtitle->attributes->feature_details->title . PHP_EOL;
    echo $subtitle->attributes->files[0]->file_id . PHP_EOL;
}

// Find subtitles by title
$subtitles = $client->subtitle->findByTitle('How i met your mother');

// Find subtitles by movie hash
$hash = (new \OpenSubtitles\Hash())->make(__DIR__ . '/../breakdance.avi');
$subtitles = $client->subtitle->findByMovieHash($hash);
```

### Download Subtitle

[](#download-subtitle)

```
$download = $client->download->download($auth->token, $subtitle->attributes->files[0]->file_id);

file_put_contents($subtitle->attributes->feature_details->title . $response->file_name, file_get_contents($response->link));
```

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 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

Every ~351 days

Total

4

Last Release

961d ago

Major Versions

v1.1 → v2.02023-11-04

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1241396?v=4)[Onur Şimşek](/maintainers/onursimsek)[@onursimsek](https://github.com/onursimsek)

---

Top Contributors

[![onursimsek](https://avatars.githubusercontent.com/u/1241396?v=4)](https://github.com/onursimsek "onursimsek (17 commits)")

---

Tags

apisdkrestsubtitleopensubtitles

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/onursimsek-opensubtitles-api/health.svg)

```
[![Health](https://phpackages.com/badges/onursimsek-opensubtitles-api/health.svg)](https://phpackages.com/packages/onursimsek-opensubtitles-api)
```

###  Alternatives

[jlevers/selling-partner-api

PHP client for Amazon's Selling Partner API

4335.4M2](/packages/jlevers-selling-partner-api)[xeroapi/xero-php-oauth2

Xero official PHP SDK for oAuth2 generated with OpenAPI spec 3

1054.6M18](/packages/xeroapi-xero-php-oauth2)[onesignal/onesignal-php-api

A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com

34199.5k2](/packages/onesignal-onesignal-php-api)[zenditplatform/zendit-php-sdk

PHP client for Zendit API

1194.4k](/packages/zenditplatform-zendit-php-sdk)[huaweicloud/huaweicloud-sdk-php

Huawei Cloud SDK for PHP

1830.2k2](/packages/huaweicloud-huaweicloud-sdk-php)

PHPackages © 2026

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