API Documentation
SubVi API allows you to search, browse and download subtitles programmatically. Get started with your personal API key.
Authentication
All API requests require an API key. Include it as the X-API-Key header or api_key query parameter.
cURL
curl -H "X-API-Key: subvi_..." \
https://subvi.net/api/movies
https://subvi.net/api/movies
Base URL
https://subvi.net/api
Endpoints
GET
/movies
List all movies
Parameter
| page | integer | Optional | Description |
|---|---|---|---|
| Page number (default: 1) | |||
Example
{
"data": [
{
"id": 27205,
"title": "Inception",
"year": 2010,
"poster": "https://image.tmdb.org/t/p/w500/...",
"rating": 8.4,
"overview": "...",
"subtitles_count": 5,
"created_at": "2026-07-19T12:00:00.000000Z"
}
],
"meta": {
"current_page": 1,
"last_page": 5,
"per_page": 20,
"total": 100
}
}
GET
/movies/{tmdb_id}
Get movie details
Parameter
| tmdb_id | string | Required | Description |
|---|---|---|---|
| TMDB movie ID | |||
GET
/subtitles
List/search subtitles
Parameter
| Parameter | Type | Description | |
|---|---|---|---|
| movie_id | integer | Filter by TMDB movie ID | |
| language | string | Filter by language code (en, tr, fr...) | |
| q | string | Search by movie title | |
GET
/subtitles/{id}
Get subtitle details
| id | integer | Required | Description |
|---|---|---|---|
| Subtitle ID | |||
GET
/subtitles/{id}/download
Download subtitle file
Response: File download (application/octet-stream)
GET
/search/movies?q=
Search movies on TMDB
| q | string | Required | Description |
|---|---|---|---|
| Search query (min 2 characters) | |||
Errors
| Type | Description |
|---|---|
401 | Missing or invalid API key |
404 | Resource not found |
422 | Validation error |