No authentication required
All endpoints are public. Base URL:
https://movieapi.nasotc.com
General
Home data, health check, genres
GET
/home
Banner + platform sections
▼
Returns the homepage banner items and curated operating sections.
Example Response 200
{
"status": 200,
"results": {
"banner": { "items": [...] },
"platformList": [...],
"operatingList": [...]
}
}
GET
/health
Server health & cache stats
▼
Example Response 200
{
"status": "healthy",
"version": "3.0.0",
"cache": {
"movie_entries": 13,
"server_entries": 8
}
}
GET
/genres
All available genres
▼
Example Response 200
{
"data": {
"genres": ["Action", "Comedy", "Drama", ...]
}
}
Movies
Browse, filter, and discover titles
GET
/movies
Browse with filters
▼
Query Parameters
| Param | Type | Default | Description |
|---|---|---|---|
| page | int | 1 | Page number optional |
| limit | int | 20 | Results per page (max 100) optional |
| type | string | — | movie or series optional |
| genre | string | — | e.g. Action, Drama optional |
| year | int | — | Release year optional |
| country | string | — | Country name optional |
Example 200
{
"data": {
"movies": [{
"id": "12345",
"title": "Inception",
"type": "movie",
"year": "2010",
"imdb_rating": "8.8",
"poster_url": "https://...",
"detail_path": "movie/inception-2010"
}],
"total": 1200,
"has_more": true
}
}
GET
/movies/top-rated
Sorted by IMDB score
▼
Query Parameters
| Param | Type | Default | Description |
|---|---|---|---|
| limit | int | 20 | Results optional |
| type | string | — | movie or series optional |
| min_rating | float | 7.5 | Minimum IMDB rating optional |
GET
/movies/new-releases
Latest titles by release date
▼
Query Parameters
| Param | Type | Default | Description |
|---|---|---|---|
| limit | int | 20 | optional |
| type | string | — | movie or series optional |
GET
/movies/featured
Daily curated mix
▼
Returns a daily-shuffled mix of trending, top-rated, and new releases. Seed changes every 24 hours.
Query Parameters
| Param | Type | Default |
|---|---|---|
| limit | int | 20 |
GET
/movies/similar/{detail_path}
Genre-matched similar titles
▼
Path Parameters
| Param | Description |
|---|---|
| detail_path | The movie's detail_path from any listing required |
Query Parameters
| Param | Default |
|---|---|
| limit | 12 |
Trending
Hot right now
GET
/trending
Currently trending titles
▼
Query Parameters
| Param | Default |
|---|---|
| page | 1 |
| limit | 20 |
GET
/recent
Recently added titles
▼
Query Parameters
| Param | Default |
|---|---|
| page | 1 |
| limit | 20 |
GET
/ranking
Platform ranking list
▼
Query Parameters
| Param | Default |
|---|---|
| id | "" |
| page | 1 |
| limit | 20 |
Search
Full-text and autocomplete
GET
/movies/search
Full-text movie search
▼
Query Parameters
| Param | Type | Description |
|---|---|---|
| q | string | Search keyword required |
| page | int | Page number optional |
| limit | int | Results per page optional |
Example
GET /movies/search?q=batman&limit=20
GET
/movies/suggest
Autocomplete suggestions
▼
Query Parameters
| Param | Description |
|---|---|
| q | Partial search keyword required |
Example Response
{"data": {"suggestions": ["Batman Begins", "Batman v Superman"]}}
GET
/popular-searches
Trending search terms
▼
Example Response
{"data": {"searches": ["Avengers", "Oppenheimer"]}}
Streaming
Stream info, players, and embed servers
GET
/play/{detail_path}
Stream + servers (combined)
▼
Recommended endpoint — returns stream metadata AND ranked embed servers in one request. Both halves are cached so repeat calls are instant.
Path Parameters
| Param | Description |
|---|---|
| detail_path | Movie/series detail_path required |
Query Parameters
| Param | Default | Description |
|---|---|---|
| ep | 1 | Episode number (series only) |
| season | 1 | Season number (series only) |
Example Response 200
{
"data": {
"stream": {
"title": "Inception",
"imdb_id": "tt1375666",
"is_series": false,
"seasons": [],
"trailer": { "url": "https://..." }
},
"servers": {
"working_count": 4,
"servers": [{
"label": "Server 1",
"url": "https://vidsrc.to/embed/movie/tt1375666",
"ok": true,
"latency_ms": 312
}]
}
}
}
GET
/servers
Ranked embed servers by IMDB ID
▼
Query Parameters
| Param | Type | Description |
|---|---|---|
| imdb_id | string | e.g. tt1375666 required |
| type | string | movie or tv required |
| season | int | Season (TV only) optional |
| episode | int | Episode (TV only) optional |
GET
/stream/{detail_path}
Stream metadata only
▼
Returns stream metadata without server probing. Use /play/{detail_path} for a combined response.
IMDB & Related
Lookup and recommendations
GET
/imdb/lookup
Resolve title to IMDB ID
▼
Query Parameters
| Param | Type | Description |
|---|---|---|
| title | string | Movie/series title required |
| year | string | Release year optional |
| type | string | movie, series, tv optional |
Example
GET /imdb/lookup?title=inception&year=2010&type=movie
{ "data": { "imdb_id": "tt1375666" } }