Tài liệu API KKPhim

Chào mừng bạn đến với tài liệu API của OPhim. Đây là hệ thống API RESTful cung cấp dữ liệu phim ảnh phong phú và được cập nhật liên tục.

Base URL	`https://phimapi.com`
Định dạng	`JSON`
Mã hóa	`UTF-8`
Phương thức	`GET`

Dữ liệu phim

Thông tin chi tiết phim
Hình ảnh HD từ TMDB
Thông tin diễn viên, đạo diễn
Từ khóa phim

Tìm kiếm & Lọc

Tìm kiếm theo từ khóa
Lọc theo thể loại, quốc gia
Sắp xếp theo nhiều tiêu chí
Phân trang linh hoạt

Bộ lọc & Sắp xếp

Áp dụng cho các endpoint danh sách (/v1/api/danh-sach/{slug}, /v1/the-loai/{slug}, /v1/quoc-gia/{slug}, /v1/nam/{year}, /v1/tim-kiem).

Tham số	Giá trị	Mô tả
`page`	integer	Trang hiện tại (mặc định 1).
`limit`	integer	Số phim mỗi trang (áp dụng ở tìm kiếm; mặc định 10 - tối đa 64).
`category`	slug	Lọc theo thể loại, ví dụ hanh-dong.
`country`	slug	Lọc theo quốc gia, ví dụ han-quoc.
`year`	number	Lọc theo năm phát hành, ví dụ 2024. Có thể theo dải, ví dụ 2014,2024.
`sort_field`	string	modified.time \| _id \| year (mặc định modified.time).
`sort_type`	string	desc \| asc (mặc định desc).
`sort_lang`	string	vietsub \| thuyet-minh \| long-tieng.

GET

Lấy danh sách phim mới cập nhật

Danh sách phim mới nhất theo định dạng cổ điển. Có 2 biến thể chi tiết hơn: thêm hậu tố -v2 và -v3 (bổ sung trường và ảnh IMDB/TMDB đầy đủ).

Language

curl --request GET \
  --url 'https://phimapi.com/danh-sach/phim-moi-cap-nhat' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/danh-sach/phim-moi-cap-nhat', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/danh-sach/phim-moi-cap-nhat')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/danh-sach/phim-moi-cap-nhat');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/danh-sach/phim-moi-cap-nhat',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/danh-sach/phim-moi-cap-nhat")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/danh-sach/phim-moi-cap-nhat"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/danh-sach/phim-moi-cap-nhat')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/danh-sach/phim-moi-cap-nhat")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/danh-sach/phim-moi-cap-nhat

Phương thức

GET

Mô tả

Danh sách phim mới nhất theo định dạng cổ điển. Có 2 biến thể chi tiết hơn: thêm hậu tố -v2 và -v3 (bổ sung trường và ảnh IMDB/TMDB đầy đủ).

Tham số	Kiểu	Bắt buộc	Mô tả
`page`	integer	Không	Trang hiện tại (mặc định 1).

Cấu trúc phản hồi (rút gọn)

{
  "status": true,
  "items": [
    { "_id": "…", "name": "…", "slug": "…", "origin_name": "…",
      "thumb_url": "…", "poster_url": "…", "year": 2024,
      "modified": { "time": "…" } }
  ],
  "pathImage": "https://phimapi.com/uploads/movies/",
  "pagination": { "totalItems": 100, "totalItemsPerPage": 24,
                  "currentPage": 1, "totalPages": 5 }
}

URL ví dụ

https://phimapi.com/danh-sach/phim-moi-cap-nhat

GET

Lấy danh sách phim của trang chủ

Đối với API này bạn sẽ được lấy những thông tin phim hiển thị ở trang chủ của KKPhim, bao giờ những phim được cập nhật hôm nay.

Language

curl --request GET \
  --url 'https://phimapi.com/v1/api/home' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/v1/api/home', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/v1/api/home')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/v1/api/home');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/v1/api/home',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/v1/api/home")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/v1/api/home"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/v1/api/home')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/v1/api/home")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/v1/api/home

Phương thức

GET

Mô tả

Đối với API này bạn sẽ được lấy những thông tin phim hiển thị ở trang chủ của KKPhim, bao giờ những phim được cập nhật hôm nay.

Tham số	Kiểu	Bắt buộc	Mô tả
`page`	integer	Không	Trang hiện tại (mặc định 1).

Cấu trúc phản hồi (rút gọn)

{
  "status": true,
  "items": [
    { "_id": "…", "name": "…", "slug": "…", "origin_name": "…",
      "thumb_url": "…", "poster_url": "…", "year": 2024,
      "modified": { "time": "…" } }
  ],
  "pathImage": "https://phimapi.com/uploads/movies/",
  "pagination": { "totalItems": 100, "totalItemsPerPage": 24,
                  "currentPage": 1, "totalPages": 5 }
}

URL ví dụ

https://phimapi.com/v1/api/home

GET

Phim mới — định dạng v1

Danh sách "Phim Mới" thuộc khối Version 1, kèm khối seoOnPage, breadCrumb, params. Không cần slug. Hỗ trợ toàn bộ bộ lọc chung.

Language

curl --request GET \
  --url 'https://phimapi.com/v1/api/danh-sach?page=1' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/v1/api/danh-sach?page=1', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/v1/api/danh-sach?page=1')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/v1/api/danh-sach?page=1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/v1/api/danh-sach?page=1',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/v1/api/danh-sach?page=1")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/v1/api/danh-sach?page=1"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/v1/api/danh-sach?page=1')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/v1/api/danh-sach?page=1")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/v1/api/danh-sach

Phương thức

GET

Mô tả

Danh sách "Phim Mới" thuộc khối Version 1, kèm khối seoOnPage, breadCrumb, params. Không cần slug. Hỗ trợ toàn bộ bộ lọc chung.

Tham số	Kiểu	Bắt buộc	Mô tả
`page`	integer	Không	Trang hiện tại (mặc định 1).
`limit`	integer	Không	Số phim mỗi trang (áp dụng ở tìm kiếm; mặc định 10 - tối đa 64).
`category`	slug	Không	Lọc theo thể loại, ví dụ hanh-dong.
`country`	slug	Không	Lọc theo quốc gia, ví dụ han-quoc.
`year`	number	Không	Lọc theo năm phát hành, ví dụ 2024. Có thể theo dải, ví dụ 2014,2024.
`sort_field`	string	Không	modified.time \| _id \| year (mặc định modified.time).
`sort_type`	string	Không	desc \| asc (mặc định desc).
`sort_lang`	string	Không	vietsub \| thuyet-minh \| long-tieng.

Cấu trúc phản hồi (rút gọn)

{
    "status": "success",
    "message": "",
    "data": {
        "items": [
            {
                "tmdb": {
                    "id": "718789",
                    "type": "movie",
                    "season": null,
                    "vote_average": 6.887,
                    "vote_count": 3703
                },
                "imdb": {
                    "id": null,
                    "vote_average": 0,
                    "vote_count": 0
                },
                "modified": {
                    "time": "2026-01-23T09:07:25.000Z"
                },
                "_id": "54229abfcfa5649e7003b83dd4755294",
                "name": "Lightyear: Cảnh Sát Vũ Trụ",
                "slug": "lightyear-canh-sat-vu-tru",
                "origin_name": "Lightyear",
                "alternative_names": [],
                "type": "hoathinh",
                "thumb_url": "c34d0de9b0d8383ae31ac2d13e74a924.jpg",
                "poster_url": "c34d0de9b0d8383ae31ac2d13e74a924.jpg",
                "sub_docquyen": false,
                "chieurap": true,
                "time": "105 phút",
                "episode_current": "Full",
                "quality": "FHD",
                "lang": "Vietsub + Lồng Tiếng",
                "lang_key": [
                    "vs"
                ],
                "year": 2022,
                "category": [
                    {
                        "name": "Khoa Học",
                        "slug": "khoa-hoc",
                        "id": "6a4927308e6c3c87500b802e"
                    }
                ],
                "country": [
                    {
                        "name": "Âu Mỹ",
                        "slug": "au-my",
                        "id": "6a4927308e6c3c87500b8006"
                    }
                ],
                "last_episodes": [
                    {
                        "server_name": "Vietsub",
                        "is_ai": false,
                        "name": "Full"
                    }
                ]
            }
        ],
        "params": {
            "type_slug": "danh-sach",
            "slug": "",
            "filterCategory": [
                ""
            ],
            "filterCountry": [
                ""
            ],
            "filterYear": "",
            "filterType": "",
            "sortField": "modified.time",
            "sortType": "desc",
            "pagination": {
                "totalItems": 100,
                "totalItemsPerPage": 24,
                "currentPage": 1,
                "pageRanges": 5
            }
        }
    }
}

URL ví dụ

https://phimapi.com/v1/api/danh-sach?page=1

GET

Danh sách phim theo loại

Lấy phim theo danh sách, đây là API cũ của phiên bản trước đây. type nhận: phim-le, phim-bo, hoat-hinh, tv-shows, phim-chieu-rap.

Language

curl --request GET \
  --url 'https://phimapi.com/danh-sach/phim-bo' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/danh-sach/phim-bo', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/danh-sach/phim-bo')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/danh-sach/phim-bo');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/danh-sach/phim-bo',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/danh-sach/phim-bo")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/danh-sach/phim-bo"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/danh-sach/phim-bo')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/danh-sach/phim-bo")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/danh-sach/{type}

Phương thức

GET

Mô tả

Lấy phim theo danh sách, đây là API cũ của phiên bản trước đây. type nhận: phim-le, phim-bo, hoat-hinh, tv-shows, phim-chieu-rap.

Tham số	Kiểu	Bắt buộc	Mô tả
`type`	string	Có	phim-le \| phim-bo \| hoat-hinh \| tv-shows \| phim-chieu-rap.
`page`	integer	Không	Trang hiện tại.

Cấu trúc phản hồi (rút gọn)

{
    "status": true,
    "msg": "done",
    "items": [
        {
            "tmdb": {
                "id": "233968",
                "type": "tv",
                "season": 1,
                "vote_average": 9,
                "vote_count": 2
            },
            "imdb": {
                "id": null,
                "vote_average": 0,
                "vote_count": 0
            },
            "modified": {
                "time": "2025-06-26T08:57:10.000Z"
            },
            "_id": "5694b3b8e68d534f207261f9217afb73",
            "name": "A Mạch Tòng Quân",
            "slug": "a-mach-tong-quan",
            "origin_name": "Fighting For Love",
            "poster_url": "https://phimimg.com/upload/vod/20250626-1/e1e5b9…",
            "thumb_url": "https://phimimg.com/upload/vod/20250626-1/e1e5b9…",
            "year": 2024
        }
    ],
    "pagination": {
        "totalItems": 16,
        "totalItemsPerPage": 24,
        "currentPage": 1,
        "totalPages": 1
    }
}

URL ví dụ

https://phimapi.com/danh-sach/phim-bo

GET

Danh sách theo loại — bộ lọc đầy đủ

Giống trên nhưng theo định dạng v1 đầy đủ (seoOnPage, breadCrumb, params.pagination) và hỗ trợ mọi tham số ở Bộ lọc & Sắp xếp.

Language

curl --request GET \
  --url 'https://phimapi.com/v1/api/danh-sach/phim-le?country=han-quoc&year=2024' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/v1/api/danh-sach/phim-le?country=han-quoc&year=2024', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/v1/api/danh-sach/phim-le?country=han-quoc&year=2024')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/v1/api/danh-sach/phim-le?country=han-quoc&year=2024');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/v1/api/danh-sach/phim-le?country=han-quoc&year=2024',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/v1/api/danh-sach/phim-le?country=han-quoc&year=2024")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/v1/api/danh-sach/phim-le?country=han-quoc&year=2024"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/v1/api/danh-sach/phim-le?country=han-quoc&year=2024')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/v1/api/danh-sach/phim-le?country=han-quoc&year=2024")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/v1/api/danh-sach/{type}

Phương thức

GET

Mô tả

Giống trên nhưng theo định dạng v1 đầy đủ (seoOnPage, breadCrumb, params.pagination) và hỗ trợ mọi tham số ở Bộ lọc & Sắp xếp.

Tham số	Kiểu	Bắt buộc	Mô tả
`type`	string	Có	phim-le \| phim-bo \| hoat-hinh \| tv-shows.
`page`	integer	Không	Trang hiện tại (mặc định 1).
`limit`	integer	Không	Số phim mỗi trang (áp dụng ở tìm kiếm; mặc định 10 - tối đa 64).
`category`	slug	Không	Lọc theo thể loại, ví dụ hanh-dong.
`country`	slug	Không	Lọc theo quốc gia, ví dụ han-quoc.
`year`	number	Không	Lọc theo năm phát hành, ví dụ 2024. Có thể theo dải, ví dụ 2014,2024.
`sort_field`	string	Không	modified.time \| _id \| year (mặc định modified.time).
`sort_type`	string	Không	desc \| asc (mặc định desc).
`sort_lang`	string	Không	vietsub \| thuyet-minh \| long-tieng.

Cấu trúc phản hồi (rút gọn)

{
    "status": true,
    "msg": "done",
    "data": {
        "items": [
            {
                "tmdb": {
                    "id": "703451",
                    "type": "movie",
                    "season": null,
                    "vote_average": 6.278,
                    "vote_count": 828
                },
                "imdb": {
                    "id": null,
                    "vote_average": 0,
                    "vote_count": 0
                },
                "modified": {
                    "time": "2026-01-12T15:48:47.000Z"
                },
                "_id": "7647966b7343c29048673252e490f736",
                "name": "Chỗ em hay chỗ anh?",
                "slug": "cho-em-hay-cho-anh",
                "origin_name": "Your Place or Mine",
                "alternative_names": [],
                "type": "single",
                "thumb_url": "a5f56a6ca69f2134a75651dd246bf1c0.jpg",
                "poster_url": "a5f56a6ca69f2134a75651dd246bf1c0.jpg",
                "sub_docquyen": false,
                "chieurap": false,
                "time": "109 phút",
                "episode_current": "Full",
                "quality": "FHD",
                "lang": "Vietsub + Lồng Tiếng",
                "lang_key": [
                    "vs"
                ],
                "year": 2023,
                "category": [
                    {
                        "name": "Tình Cảm",
                        "slug": "tinh-cam",
                        "id": "6a4927308e6c3c87500b8016"
                    }
                ],
                "country": [
                    {
                        "name": "Âu Mỹ",
                        "slug": "au-my",
                        "id": "6a4927308e6c3c87500b8006"
                    }
                ],
                "last_episodes": [
                    {
                        "server_name": "Vietsub",
                        "is_ai": false,
                        "name": "Full"
                    }
                ]
            }
        ],
        "params": {
            "type_slug": "danh-sach",
            "slug": "phim-le",
            "filterCategory": [
                ""
            ],
            "filterCountry": [
                ""
            ],
            "filterYear": "",
            "filterType": "",
            "sortField": "modified.time",
            "sortType": "desc",
            "pagination": {
                "totalItems": 71,
                "totalItemsPerPage": 24,
                "currentPage": 1,
                "pageRanges": 5
            }
        }
    }
}

URL ví dụ

https://phimapi.com/v1/api/danh-sach/phim-le?country=han-quoc&year=2024

GET

Thông tin phim

Chi tiết một phim theo slug, gồm thông tin phim và danh sách tập (episodes tách ngoài movie).

Language

curl --request GET \
  --url 'https://phimapi.com/phim/ten-phim-slug' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/phim/ten-phim-slug', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/phim/ten-phim-slug')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/phim/ten-phim-slug');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/phim/ten-phim-slug',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/phim/ten-phim-slug")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/phim/ten-phim-slug"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/phim/ten-phim-slug')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/phim/ten-phim-slug")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/phim/{slug}

Phương thức

GET

Mô tả

Chi tiết một phim theo slug, gồm thông tin phim và danh sách tập (episodes tách ngoài movie).

Tham số	Kiểu	Bắt buộc	Mô tả
`slug`	string	Có	Slug của phim.

Cấu trúc phản hồi (rút gọn)

{
    "status": true,
    "msg": "",
    "movie": {
        "tmdb": {
            "id": "718789",
            "type": "movie",
            "season": null,
            "vote_average": 6.887,
            "vote_count": 3703
        },
        "imdb": {
            "id": null,
            "vote_average": 0,
            "vote_count": 0
        },
        "created": {
            "time": "2023-09-13T03:39:44.000Z"
        },
        "modified": {
            "time": "2026-01-23T09:07:25.000Z"
        },
        "_id": "54229abfcfa5649e7003b83dd4755294",
        "name": "Lightyear: Cảnh Sát Vũ Trụ",
        "slug": "lightyear-canh-sat-vu-tru",
        "origin_name": "Lightyear",
        "alternative_names": [],
        "content": "<p>Bộ phim kể về chuyến hành trình hành động kết h…",
        "type": "hoathinh",
        "status": "completed",
        "thumb_url": "https://phimimg.com/upload/vod/20260123-1/c34d0d…",
        "poster_url": "https://phimimg.com/upload/vod/20260123-1/c34d0d…",
        "is_copyright": false,
        "sub_docquyen": false,
        "chieurap": true,
        "is_published": true,
        "trailer_url": "https://www.youtube.com/watch?v=eMZVWnhGeEE",
        "time": "105 phút",
        "episode_current": "Full",
        "episode_total": 1,
        "quality": "FHD",
        "lang": "Vietsub + Lồng Tiếng",
        "lang_key": [
            "vs"
        ],
        "notify": "",
        "showtimes": "",
        "year": 2022,
        "view": 0,
        "actor": [
            "Chris Evans"
        ],
        "director": [
            "Angus MacLane"
        ],
        "category": [
            {
                "name": "Khoa Học",
                "slug": "khoa-hoc",
                "id": "6a4927308e6c3c87500b802e"
            }
        ],
        "country": [
            {
                "name": "Âu Mỹ",
                "slug": "au-my",
                "id": "6a4927308e6c3c87500b8006"
            }
        ]
    },
    "episodes": [
        {
            "server_name": "Vietsub",
            "is_ai": false,
            "server_data": [
                {
                    "name": "Full",
                    "slug": "full",
                    "filename": "Lightyear: Cảnh Sát Vũ Trụ - Lightyear - 2022 - FH…",
                    "link_embed": "https://player.phimapi.com/player/?url=https://s6.…",
                    "link_m3u8": "https://s6.kkphimplayer6.com/20260123/t2a4G3hc/ind…"
                }
            ]
        }
    ]
}

URL ví dụ

https://phimapi.com/phim/ten-phim-slug

GET

Thông tin phim theo ID

Như Format 1 nhưng tra cứu theo _id của phim thay vì slug.

Language

curl --request GET \
  --url 'https://phimapi.com/phim/id/665f0a1b2c3d4e5f' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/phim/id/665f0a1b2c3d4e5f', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/phim/id/665f0a1b2c3d4e5f')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/phim/id/665f0a1b2c3d4e5f');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/phim/id/665f0a1b2c3d4e5f',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/phim/id/665f0a1b2c3d4e5f")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/phim/id/665f0a1b2c3d4e5f"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/phim/id/665f0a1b2c3d4e5f')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/phim/id/665f0a1b2c3d4e5f")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/phim/id/{id}

Phương thức

GET

Mô tả

Như Format 1 nhưng tra cứu theo _id của phim thay vì slug.

Tham số	Kiểu	Bắt buộc	Mô tả
`id`	string	Có	_id của phim.

Cấu trúc phản hồi (rút gọn)

{
    "status": true,
    "msg": "",
    "movie": {
        "tmdb": {
            "id": "718789",
            "type": "movie",
            "season": null,
            "vote_average": 6.887,
            "vote_count": 3703
        },
        "imdb": {
            "id": null,
            "vote_average": 0,
            "vote_count": 0
        },
        "created": {
            "time": "2023-09-13T03:39:44.000Z"
        },
        "modified": {
            "time": "2026-01-23T09:07:25.000Z"
        },
        "_id": "54229abfcfa5649e7003b83dd4755294",
        "name": "Lightyear: Cảnh Sát Vũ Trụ",
        "slug": "lightyear-canh-sat-vu-tru",
        "origin_name": "Lightyear",
        "alternative_names": [],
        "content": "<p>Bộ phim kể về chuyến hành trình hành động kết h…",
        "type": "hoathinh",
        "status": "completed",
        "thumb_url": "https://phimimg.com/upload/vod/20260123-1/c34d0d…",
        "poster_url": "https://phimimg.com/upload/vod/20260123-1/c34d0d…",
        "is_copyright": false,
        "sub_docquyen": false,
        "chieurap": true,
        "is_published": true,
        "trailer_url": "https://www.youtube.com/watch?v=eMZVWnhGeEE",
        "time": "105 phút",
        "episode_current": "Full",
        "episode_total": 1,
        "quality": "FHD",
        "lang": "Vietsub + Lồng Tiếng",
        "lang_key": [
            "vs"
        ],
        "notify": "",
        "showtimes": "",
        "year": 2022,
        "view": 0,
        "actor": [
            "Chris Evans"
        ],
        "director": [
            "Angus MacLane"
        ],
        "category": [
            {
                "name": "Khoa Học",
                "slug": "khoa-hoc",
                "id": "6a4927308e6c3c87500b802e"
            }
        ],
        "country": [
            {
                "name": "Âu Mỹ",
                "slug": "au-my",
                "id": "6a4927308e6c3c87500b8006"
            }
        ]
    },
    "episodes": [
        {
            "server_name": "Vietsub",
            "is_ai": false,
            "server_data": [
                {
                    "name": "Full",
                    "slug": "full",
                    "filename": "Lightyear: Cảnh Sát Vũ Trụ - Lightyear - 2022 - FH…",
                    "link_embed": "https://player.phimapi.com/player/?url=https://s6.…",
                    "link_m3u8": "https://s6.kkphimplayer6.com/20260123/t2a4G3hc/ind…"
                }
            ]
        }
    ]
}

URL ví dụ

https://phimapi.com/phim/id/665f0a1b2c3d4e5f

GET

Thông tin phim theo TMDB

Tra cứu phim theo mã TheMovieDB. type là movie hoặc tv.

Language

curl --request GET \
  --url 'https://phimapi.com/tmdb/movie/299534' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/tmdb/movie/299534', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/tmdb/movie/299534')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/tmdb/movie/299534');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/tmdb/movie/299534',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/tmdb/movie/299534")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/tmdb/movie/299534"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/tmdb/movie/299534')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/tmdb/movie/299534")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/tmdb/{type}/{id}

Phương thức

GET

Mô tả

Tra cứu phim theo mã TheMovieDB. type là movie hoặc tv.

Tham số	Kiểu	Bắt buộc	Mô tả
`type`	string	Có	movie \| tv.
`id`	number	Có	ID của TMDB.

Cấu trúc phản hồi (rút gọn)

{
    "status": true,
    "msg": "",
    "movie": {
        "tmdb": {
            "id": "718789",
            "type": "movie",
            "season": null,
            "vote_average": 6.887,
            "vote_count": 3703
        },
        "imdb": {
            "id": null,
            "vote_average": 0,
            "vote_count": 0
        },
        "created": {
            "time": "2023-09-13T03:39:44.000Z"
        },
        "modified": {
            "time": "2026-01-23T09:07:25.000Z"
        },
        "_id": "54229abfcfa5649e7003b83dd4755294",
        "name": "Lightyear: Cảnh Sát Vũ Trụ",
        "slug": "lightyear-canh-sat-vu-tru",
        "origin_name": "Lightyear",
        "alternative_names": [],
        "content": "<p>Bộ phim kể về chuyến hành trình hành động kết h…",
        "type": "hoathinh",
        "status": "completed",
        "thumb_url": "https://phimimg.com/upload/vod/20260123-1/c34d0d…",
        "poster_url": "https://phimimg.com/upload/vod/20260123-1/c34d0d…",
        "is_copyright": false,
        "sub_docquyen": false,
        "chieurap": true,
        "is_published": true,
        "trailer_url": "https://www.youtube.com/watch?v=eMZVWnhGeEE",
        "time": "105 phút",
        "episode_current": "Full",
        "episode_total": 1,
        "quality": "FHD",
        "lang": "Vietsub + Lồng Tiếng",
        "lang_key": [
            "vs"
        ],
        "notify": "",
        "showtimes": "",
        "year": 2022,
        "view": 0,
        "actor": [
            "Chris Evans"
        ],
        "director": [
            "Angus MacLane"
        ],
        "category": [
            {
                "name": "Khoa Học",
                "slug": "khoa-hoc",
                "id": "6a4927308e6c3c87500b802e"
            }
        ],
        "country": [
            {
                "name": "Âu Mỹ",
                "slug": "au-my",
                "id": "6a4927308e6c3c87500b8006"
            }
        ]
    },
    "episodes": [
        {
            "server_name": "Vietsub",
            "is_ai": false,
            "server_data": [
                {
                    "name": "Full",
                    "slug": "full",
                    "filename": "Lightyear: Cảnh Sát Vũ Trụ - Lightyear - 2022 - FH…",
                    "link_embed": "https://player.phimapi.com/player/?url=https://s6.…",
                    "link_m3u8": "https://s6.kkphimplayer6.com/20260123/t2a4G3hc/ind…"
                }
            ]
        }
    ]
}

URL ví dụ

https://phimapi.com/tmdb/movie/299534

GET

Thông tin phim theo IMDB

Tra cứu phim theo ID IMDB.

Language

curl --request GET \
  --url 'https://phimapi.com/imdb/title/tt36596650' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/imdb/title/tt36596650', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/imdb/title/tt36596650')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/imdb/title/tt36596650');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/imdb/title/tt36596650',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/imdb/title/tt36596650")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/imdb/title/tt36596650"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/imdb/title/tt36596650')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/imdb/title/tt36596650")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/imdb/title/{id}

Phương thức

GET

Mô tả

Tra cứu phim theo ID IMDB.

Tham số	Kiểu	Bắt buộc	Mô tả
`type`	string	Có	movie \| tv.
`id`	number	Có	ID của IMDB.

Cấu trúc phản hồi (rút gọn)

{ "status": true, "msg": "", "movie": { … }, "episodes": [ … ] }

URL ví dụ

https://phimapi.com/imdb/title/tt36596650

GET

Thông tin phim (v1)

Chi tiết phim theo định dạng v1 (Format 2), bọc trong data kèm seoOnPage, breadCrumb, item (chứa cả episodes).

Language

curl --request GET \
  --url 'https://phimapi.com/v1/api/phim/ten-phim-slug' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/v1/api/phim/ten-phim-slug', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/v1/api/phim/ten-phim-slug')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/v1/api/phim/ten-phim-slug');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/v1/api/phim/ten-phim-slug',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/v1/api/phim/ten-phim-slug")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/v1/api/phim/ten-phim-slug"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/v1/api/phim/ten-phim-slug')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/v1/api/phim/ten-phim-slug")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/v1/api/phim/{slug}

Phương thức

GET

Mô tả

Chi tiết phim theo định dạng v1 (Format 2), bọc trong data kèm seoOnPage, breadCrumb, item (chứa cả episodes).

Tham số	Kiểu	Bắt buộc	Mô tả
`slug`	string	Có	Slug của phim.

Cấu trúc phản hồi (rút gọn)

{
    "status": "success",
    "message": "",
    "data": {
        "params": {
            "slug": "lightyear-canh-sat-vu-tru",
            "includeUnpublished": false
        },
        "item": {
            "tmdb": {
                "id": "718789",
                "type": "movie",
                "season": null,
                "vote_average": 6.887,
                "vote_count": 3703
            },
            "imdb": {
                "id": null,
                "vote_average": 0,
                "vote_count": 0
            },
            "created": {
                "time": "2023-09-13T03:39:44.000Z"
            },
            "modified": {
                "time": "2026-01-23T09:07:25.000Z"
            },
            "_id": "54229abfcfa5649e7003b83dd4755294",
            "name": "Lightyear: Cảnh Sát Vũ Trụ",
            "slug": "lightyear-canh-sat-vu-tru",
            "origin_name": "Lightyear",
            "alternative_names": [],
            "content": "<p>Bộ phim kể về chuyến hành trình hành động kết h…",
            "type": "hoathinh",
            "status": "completed",
            "thumb_url": "upload/vod/20260123-1/c34d0de9b0d8383ae31ac2d13e74…",
            "poster_url": "upload/vod/20260123-1/c34d0de9b0d8383ae31ac2d13e74…",
            "is_copyright": false,
            "sub_docquyen": false,
            "chieurap": true,
            "is_published": true,
            "trailer_url": "https://www.youtube.com/watch?v=eMZVWnhGeEE",
            "time": "105 phút",
            "episode_current": "Full",
            "episode_total": 1,
            "quality": "FHD",
            "lang": "Vietsub + Lồng Tiếng",
            "lang_key": [
                "vs"
            ],
            "notify": "",
            "showtimes": "",
            "year": 2022,
            "view": 0,
            "actor": [
                "Chris Evans"
            ],
            "director": [
                "Angus MacLane"
            ],
            "category": [
                {
                    "name": "Khoa Học",
                    "slug": "khoa-hoc",
                    "id": "6a4927308e6c3c87500b802e"
                }
            ],
            "country": [
                {
                    "name": "Âu Mỹ",
                    "slug": "au-my",
                    "id": "6a4927308e6c3c87500b8006"
                }
            ],
            "episodes": [
                {
                    "server_name": "Vietsub",
                    "is_ai": false,
                    "server_data": [
                        {
                            "name": "Full",
                            "slug": "full",
                            "filename": "Lightyear: Cảnh Sát Vũ Trụ - Lightyear - 2022 - FH…",
                            "link_embed": "https://player.phimapi.com/player/?url=https://s6.…",
                            "link_m3u8": "https://s6.kkphimplayer6.com/20260123/t2a4G3hc/ind…"
                        }
                    ]
                }
            ]
        }
    }
}

URL ví dụ

https://phimapi.com/v1/api/phim/ten-phim-slug

GET

Hình ảnh của phim

Danh sách hình ảnh (poster, backdrop…) của phim.

Language

curl --request GET \
  --url 'https://phimapi.com/v1/api/phim/ten-phim-slug/images' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/v1/api/phim/ten-phim-slug/images', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/v1/api/phim/ten-phim-slug/images')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/v1/api/phim/ten-phim-slug/images');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/v1/api/phim/ten-phim-slug/images',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/v1/api/phim/ten-phim-slug/images")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/v1/api/phim/ten-phim-slug/images"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/v1/api/phim/ten-phim-slug/images')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/v1/api/phim/ten-phim-slug/images")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/v1/api/phim/{slug}/images

Phương thức

GET

Mô tả

Danh sách hình ảnh (poster, backdrop…) của phim.

Tham số	Kiểu	Bắt buộc	Mô tả
`slug`	string	Có	Slug của phim.

Cấu trúc phản hồi (rút gọn)

{
    "success": true,
    "message": "success",
    "status_code": 200,
    "data": {
        "tmdb_id": 718789,
        "tmdb_type": "movie",
        "slug": "lightyear-canh-sat-vu-tru",
        "imdb_id": null,
        "image_sizes": {
            "backdrop": {
                "original": "https://image.tmdb.org/t/p/original",
                "w1280": "https://image.tmdb.org/t/p/w1280",
                "w300": "https://image.tmdb.org/t/p/w300",
                "w780": "https://image.tmdb.org/t/p/w780"
            },
            "poster": {
                "original": "https://image.tmdb.org/t/p/original",
                "w154": "https://image.tmdb.org/t/p/w154",
                "w185": "https://image.tmdb.org/t/p/w185",
                "w342": "https://image.tmdb.org/t/p/w342",
                "w500": "https://image.tmdb.org/t/p/w500",
                "w780": "https://image.tmdb.org/t/p/w780",
                "w92": "https://image.tmdb.org/t/p/w92"
            }
        },
        "images": []
    }
}

URL ví dụ

https://phimapi.com/v1/api/phim/ten-phim-slug/images

GET

Diễn viên & ê-kíp

Danh sách diễn viên, đạo diễn và nhân sự của phim.

Language

curl --request GET \
  --url 'https://phimapi.com/v1/api/phim/ten-phim-slug/peoples' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/v1/api/phim/ten-phim-slug/peoples', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/v1/api/phim/ten-phim-slug/peoples')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/v1/api/phim/ten-phim-slug/peoples');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/v1/api/phim/ten-phim-slug/peoples',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/v1/api/phim/ten-phim-slug/peoples")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/v1/api/phim/ten-phim-slug/peoples"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/v1/api/phim/ten-phim-slug/peoples')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/v1/api/phim/ten-phim-slug/peoples")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/v1/api/phim/{slug}/peoples

Phương thức

GET

Mô tả

Danh sách diễn viên, đạo diễn và nhân sự của phim.

Tham số	Kiểu	Bắt buộc	Mô tả
`slug`	string	Có	Slug của phim.

Cấu trúc phản hồi (rút gọn)

{
    "success": true,
    "message": "success",
    "status_code": 200,
    "data": {
        "tmdb_id": 718789,
        "tmdb_type": "movie",
        "slug": "lightyear-canh-sat-vu-tru",
        "imdb_id": null,
        "profile_sizes": {
            "h632": "https://image.tmdb.org/t/p/h632",
            "original": "https://image.tmdb.org/t/p/original",
            "w185": "https://image.tmdb.org/t/p/w185",
            "w45": "https://image.tmdb.org/t/p/w45"
        },
        "peoples": []
    }
}

URL ví dụ

https://phimapi.com/v1/api/phim/ten-phim-slug/peoples

GET

Từ khóa của phim

Danh sách từ khóa (keywords) gắn với phim.

Language

curl --request GET \
  --url 'https://phimapi.com/v1/api/phim/ten-phim-slug/keywords' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/v1/api/phim/ten-phim-slug/keywords', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/v1/api/phim/ten-phim-slug/keywords')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/v1/api/phim/ten-phim-slug/keywords');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/v1/api/phim/ten-phim-slug/keywords',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/v1/api/phim/ten-phim-slug/keywords")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/v1/api/phim/ten-phim-slug/keywords"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/v1/api/phim/ten-phim-slug/keywords')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/v1/api/phim/ten-phim-slug/keywords")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/v1/api/phim/{slug}/keywords

Phương thức

GET

Mô tả

Danh sách từ khóa (keywords) gắn với phim.

Tham số	Kiểu	Bắt buộc	Mô tả
`slug`	string	Có	Slug của phim.

Cấu trúc phản hồi (rút gọn)

{
    "success": true,
    "message": "success",
    "status_code": 200,
    "data": {
        "tmdb_id": 718789,
        "tmdb_type": "movie",
        "slug": "lightyear-canh-sat-vu-tru",
        "imdb_id": null,
        "keywords": []
    }
}

URL ví dụ

https://phimapi.com/v1/api/phim/ten-phim-slug/keywords

GET

Danh sách thể loại

Lấy toàn bộ thể loại (tên + slug). Cũng có bản v1: /v1/api/the-loai.

Language

curl --request GET \
  --url 'https://phimapi.com/the-loai' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/the-loai', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/the-loai')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/the-loai');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/the-loai',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/the-loai")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/the-loai"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/the-loai')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/the-loai")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/the-loai

Phương thức

GET

Mô tả

Lấy toàn bộ thể loại (tên + slug). Cũng có bản v1: /v1/api/the-loai.

Cấu trúc phản hồi (rút gọn)

{
    "status": "success",
    "message": "",
    "data": {
        "items": [
            {
                "_id": "6a4927308e6c3c87500b802a",
                "name": "Bí Ẩn",
                "slug": "bi-an"
            }
        ]
    }
}

URL ví dụ

https://phimapi.com/the-loai

GET

Phim theo thể loại

Danh sách phim thuộc một thể loại, hỗ trợ bộ lọc chung.

Language

curl --request GET \
  --url 'https://phimapi.com/v1/api/the-loai/hanh-dong?page=1' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/v1/api/the-loai/hanh-dong?page=1', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/v1/api/the-loai/hanh-dong?page=1')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/v1/api/the-loai/hanh-dong?page=1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/v1/api/the-loai/hanh-dong?page=1',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/v1/api/the-loai/hanh-dong?page=1")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/v1/api/the-loai/hanh-dong?page=1"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/v1/api/the-loai/hanh-dong?page=1')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/v1/api/the-loai/hanh-dong?page=1")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/v1/api/the-loai/{slug}

Phương thức

GET

Mô tả

Danh sách phim thuộc một thể loại, hỗ trợ bộ lọc chung.

Tham số	Kiểu	Bắt buộc	Mô tả
`slug`	string	Có	Slug thể loại.
`page`	integer	Không	Trang hiện tại (mặc định 1).
`limit`	integer	Không	Số phim mỗi trang (áp dụng ở tìm kiếm; mặc định 10 - tối đa 64).
`category`	slug	Không	Lọc theo thể loại, ví dụ hanh-dong.
`country`	slug	Không	Lọc theo quốc gia, ví dụ han-quoc.
`year`	number	Không	Lọc theo năm phát hành, ví dụ 2024. Có thể theo dải, ví dụ 2014,2024.
`sort_field`	string	Không	modified.time \| _id \| year (mặc định modified.time).
`sort_type`	string	Không	desc \| asc (mặc định desc).
`sort_lang`	string	Không	vietsub \| thuyet-minh \| long-tieng.

Cấu trúc phản hồi (rút gọn)

{
    "status": true,
    "msg": "done",
    "data": {
        "items": [
            {
                "tmdb": {
                    "id": "718789",
                    "type": "movie",
                    "season": null,
                    "vote_average": 6.887,
                    "vote_count": 3703
                },
                "imdb": {
                    "id": null,
                    "vote_average": 0,
                    "vote_count": 0
                },
                "modified": {
                    "time": "2026-01-23T09:07:25.000Z"
                },
                "_id": "54229abfcfa5649e7003b83dd4755294",
                "name": "Lightyear: Cảnh Sát Vũ Trụ",
                "slug": "lightyear-canh-sat-vu-tru",
                "origin_name": "Lightyear",
                "alternative_names": [],
                "type": "hoathinh",
                "thumb_url": "c34d0de9b0d8383ae31ac2d13e74a924.jpg",
                "poster_url": "c34d0de9b0d8383ae31ac2d13e74a924.jpg",
                "sub_docquyen": false,
                "chieurap": true,
                "time": "105 phút",
                "episode_current": "Full",
                "quality": "FHD",
                "lang": "Vietsub + Lồng Tiếng",
                "lang_key": [
                    "vs"
                ],
                "year": 2022,
                "category": [
                    {
                        "name": "Khoa Học",
                        "slug": "khoa-hoc",
                        "id": "6a4927308e6c3c87500b802e"
                    }
                ],
                "country": [
                    {
                        "name": "Âu Mỹ",
                        "slug": "au-my",
                        "id": "6a4927308e6c3c87500b8006"
                    }
                ],
                "last_episodes": [
                    {
                        "server_name": "Vietsub",
                        "is_ai": false,
                        "name": "Full"
                    }
                ]
            }
        ],
        "params": {
            "type_slug": "the-loai",
            "slug": "khoa-hoc",
            "filterCategory": [
                "khoa-hoc"
            ],
            "filterCountry": [
                ""
            ],
            "filterYear": "",
            "filterType": "",
            "sortField": "modified.time",
            "sortType": "desc",
            "pagination": {
                "totalItems": 23,
                "totalItemsPerPage": 24,
                "currentPage": 1,
                "pageRanges": 5
            }
        }
    }
}

URL ví dụ

https://phimapi.com/v1/api/the-loai/hanh-dong?page=1

GET

Danh sách quốc gia

Lấy toàn bộ quốc gia (tên + slug). Cũng có bản v1: /v1/api/quoc-gia.

Language

curl --request GET \
  --url 'https://phimapi.com/quoc-gia' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/quoc-gia', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/quoc-gia')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/quoc-gia');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/quoc-gia',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/quoc-gia")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/quoc-gia"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/quoc-gia')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/quoc-gia")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/quoc-gia

Phương thức

GET

Mô tả

Lấy toàn bộ quốc gia (tên + slug). Cũng có bản v1: /v1/api/quoc-gia.

Cấu trúc phản hồi (rút gọn)

{
    "status": "success",
    "message": "",
    "data": {
        "items": [
            {
                "_id": "6a4927308e6c3c87500b8008",
                "name": "Anh",
                "slug": "anh"
            }
        ]
    }
}

URL ví dụ

https://phimapi.com/quoc-gia

GET

Phim theo quốc gia

Danh sách phim thuộc một quốc gia, hỗ trợ bộ lọc chung.

Language

curl --request GET \
  --url 'https://phimapi.com/v1/api/quoc-gia/han-quoc?year=2024' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/v1/api/quoc-gia/han-quoc?year=2024', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/v1/api/quoc-gia/han-quoc?year=2024')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/v1/api/quoc-gia/han-quoc?year=2024');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/v1/api/quoc-gia/han-quoc?year=2024',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/v1/api/quoc-gia/han-quoc?year=2024")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/v1/api/quoc-gia/han-quoc?year=2024"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/v1/api/quoc-gia/han-quoc?year=2024')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/v1/api/quoc-gia/han-quoc?year=2024")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/v1/api/quoc-gia/{slug}

Phương thức

GET

Mô tả

Danh sách phim thuộc một quốc gia, hỗ trợ bộ lọc chung.

Tham số	Kiểu	Bắt buộc	Mô tả
`slug`	string	Có	Slug quốc gia.
`page`	integer	Không	Trang hiện tại (mặc định 1).
`limit`	integer	Không	Số phim mỗi trang (áp dụng ở tìm kiếm; mặc định 10 - tối đa 64).
`category`	slug	Không	Lọc theo thể loại, ví dụ hanh-dong.
`country`	slug	Không	Lọc theo quốc gia, ví dụ han-quoc.
`year`	number	Không	Lọc theo năm phát hành, ví dụ 2024. Có thể theo dải, ví dụ 2014,2024.
`sort_field`	string	Không	modified.time \| _id \| year (mặc định modified.time).
`sort_type`	string	Không	desc \| asc (mặc định desc).
`sort_lang`	string	Không	vietsub \| thuyet-minh \| long-tieng.

Cấu trúc phản hồi (rút gọn)

{
    "status": true,
    "msg": "done",
    "data": {
        "items": [
            {
                "tmdb": {
                    "id": "718789",
                    "type": "movie",
                    "season": null,
                    "vote_average": 6.887,
                    "vote_count": 3703
                },
                "imdb": {
                    "id": null,
                    "vote_average": 0,
                    "vote_count": 0
                },
                "modified": {
                    "time": "2026-01-23T09:07:25.000Z"
                },
                "_id": "54229abfcfa5649e7003b83dd4755294",
                "name": "Lightyear: Cảnh Sát Vũ Trụ",
                "slug": "lightyear-canh-sat-vu-tru",
                "origin_name": "Lightyear",
                "alternative_names": [],
                "type": "hoathinh",
                "thumb_url": "c34d0de9b0d8383ae31ac2d13e74a924.jpg",
                "poster_url": "c34d0de9b0d8383ae31ac2d13e74a924.jpg",
                "sub_docquyen": false,
                "chieurap": true,
                "time": "105 phút",
                "episode_current": "Full",
                "quality": "FHD",
                "lang": "Vietsub + Lồng Tiếng",
                "lang_key": [
                    "vs"
                ],
                "year": 2022,
                "category": [
                    {
                        "name": "Khoa Học",
                        "slug": "khoa-hoc",
                        "id": "6a4927308e6c3c87500b802e"
                    }
                ],
                "country": [
                    {
                        "name": "Âu Mỹ",
                        "slug": "au-my",
                        "id": "6a4927308e6c3c87500b8006"
                    }
                ],
                "last_episodes": [
                    {
                        "server_name": "Vietsub",
                        "is_ai": false,
                        "name": "Full"
                    }
                ]
            }
        ],
        "params": {
            "type_slug": "quoc-gia",
            "slug": "au-my",
            "filterCategory": [
                ""
            ],
            "filterCountry": [
                "au-my"
            ],
            "filterYear": "",
            "filterType": "",
            "sortField": "modified.time",
            "sortType": "desc",
            "pagination": {
                "totalItems": 51,
                "totalItemsPerPage": 24,
                "currentPage": 1,
                "pageRanges": 5
            }
        }
    }
}

URL ví dụ

https://phimapi.com/v1/api/quoc-gia/han-quoc?year=2024

GET

Danh sách năm phát hành

Lấy danh sách năm phát hành, từ năm hiện tại về 1911 (mới nhất trước).

Language

curl --request GET \
  --url 'https://phimapi.com/nam-phat-hanh' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/nam-phat-hanh', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/nam-phat-hanh')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/nam-phat-hanh');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/nam-phat-hanh',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/nam-phat-hanh")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/nam-phat-hanh"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/nam-phat-hanh')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/nam-phat-hanh")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/nam-phat-hanh

Phương thức

GET

Mô tả

Lấy danh sách năm phát hành, từ năm hiện tại về 1911 (mới nhất trước).

Cấu trúc phản hồi (rút gọn)

{ "status": "success",
  "data": { "items": [ { "year": 2026 }, { "year": 2025 } ] } }

URL ví dụ

https://phimapi.com/nam-phat-hanh

GET

Phim theo năm phát hành

Danh sách phim theo năm phát hành, hỗ trợ bộ lọc chung.

Language

curl --request GET \
  --url 'https://phimapi.com/v1/api/nam/2024?category=hoat-hinh' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/v1/api/nam/2024?category=hoat-hinh', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/v1/api/nam/2024?category=hoat-hinh')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/v1/api/nam/2024?category=hoat-hinh');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/v1/api/nam/2024?category=hoat-hinh',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/v1/api/nam/2024?category=hoat-hinh")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/v1/api/nam/2024?category=hoat-hinh"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/v1/api/nam/2024?category=hoat-hinh')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/v1/api/nam/2024?category=hoat-hinh")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/v1/api/nam/{year}

Phương thức

GET

Mô tả

Danh sách phim theo năm phát hành, hỗ trợ bộ lọc chung.

Tham số	Kiểu	Bắt buộc	Mô tả
`year`	number	Có	Năm phát hành.
`page`	integer	Không	Trang hiện tại (mặc định 1).
`limit`	integer	Không	Số phim mỗi trang (áp dụng ở tìm kiếm; mặc định 10 - tối đa 64).
`category`	slug	Không	Lọc theo thể loại, ví dụ hanh-dong.
`country`	slug	Không	Lọc theo quốc gia, ví dụ han-quoc.
`year`	number	Không	Lọc theo năm phát hành, ví dụ 2024. Có thể theo dải, ví dụ 2014,2024.
`sort_field`	string	Không	modified.time \| _id \| year (mặc định modified.time).
`sort_type`	string	Không	desc \| asc (mặc định desc).
`sort_lang`	string	Không	vietsub \| thuyet-minh \| long-tieng.

Cấu trúc phản hồi (rút gọn)

{
    "status": true,
    "msg": "done",
    "data": {
        "items": [
            {
                "tmdb": {
                    "id": "718789",
                    "type": "movie",
                    "season": null,
                    "vote_average": 6.887,
                    "vote_count": 3703
                },
                "imdb": {
                    "id": null,
                    "vote_average": 0,
                    "vote_count": 0
                },
                "modified": {
                    "time": "2026-01-23T09:07:25.000Z"
                },
                "_id": "54229abfcfa5649e7003b83dd4755294",
                "name": "Lightyear: Cảnh Sát Vũ Trụ",
                "slug": "lightyear-canh-sat-vu-tru",
                "origin_name": "Lightyear",
                "alternative_names": [],
                "type": "hoathinh",
                "thumb_url": "c34d0de9b0d8383ae31ac2d13e74a924.jpg",
                "poster_url": "c34d0de9b0d8383ae31ac2d13e74a924.jpg",
                "sub_docquyen": false,
                "chieurap": true,
                "time": "105 phút",
                "episode_current": "Full",
                "quality": "FHD",
                "lang": "Vietsub + Lồng Tiếng",
                "lang_key": [
                    "vs"
                ],
                "year": 2022,
                "category": [
                    {
                        "name": "Khoa Học",
                        "slug": "khoa-hoc",
                        "id": "6a4927308e6c3c87500b802e"
                    }
                ],
                "country": [
                    {
                        "name": "Âu Mỹ",
                        "slug": "au-my",
                        "id": "6a4927308e6c3c87500b8006"
                    }
                ],
                "last_episodes": [
                    {
                        "server_name": "Vietsub",
                        "is_ai": false,
                        "name": "Full"
                    }
                ]
            }
        ],
        "params": {
            "type_slug": "nam",
            "slug": "2022",
            "filterCategory": [
                ""
            ],
            "filterCountry": [
                ""
            ],
            "filterYear": "2022",
            "filterType": "",
            "sortField": "modified.time",
            "sortType": "desc",
            "pagination": {
                "totalItems": 7,
                "totalItemsPerPage": 24,
                "currentPage": 1,
                "pageRanges": 5
            }
        }
    }
}

URL ví dụ

https://phimapi.com/v1/api/nam/2024?category=hoat-hinh

GET

Tìm kiếm phim

Tìm phim theo từ khóa; khớp cả tên tiếng Việt và tên gốc. Hỗ trợ bộ lọc chung và limit.

Language

curl --request GET \
  --url 'https://phimapi.com/v1/api/tim-kiem?keyword=avengers&limit=10' \
  --header 'accept: application/json'

const res = await fetch('https://phimapi.com/v1/api/tim-kiem?keyword=avengers&limit=10', {
  headers: { accept: 'application/json' }
});
const data = await res.json();
console.log(data);

fetch('https://phimapi.com/v1/api/tim-kiem?keyword=avengers&limit=10')
  .then(r => r.json())
  .then(data => console.log(data));

$ch = curl_init('https://phimapi.com/v1/api/tim-kiem?keyword=avengers&limit=10');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['accept: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);

import requests

resp = requests.get(
    'https://phimapi.com/v1/api/tim-kiem?keyword=avengers&limit=10',
    headers={'accept': 'application/json'},
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, _ := http.Get("https://phimapi.com/v1/api/tim-kiem?keyword=avengers&limit=10")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://phimapi.com/v1/api/tim-kiem?keyword=avengers&limit=10"))
    .header("accept", "application/json")
    .GET().build();
HttpResponse<String> res =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

require 'net/http'
require 'json'

uri = URI('https://phimapi.com/v1/api/tim-kiem?keyword=avengers&limit=10')
res = Net::HTTP.get(uri)
puts JSON.parse(res)

let url = URL(string: "https://phimapi.com/v1/api/tim-kiem?keyword=avengers&limit=10")!
let task = URLSession.shared.dataTask(with: url) { data, _, _ in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()

Endpoint

/v1/api/tim-kiem?keyword=[keyword]

Phương thức

GET

Mô tả

Tìm phim theo từ khóa; khớp cả tên tiếng Việt và tên gốc. Hỗ trợ bộ lọc chung và limit.

Tham số	Kiểu	Bắt buộc	Mô tả
`keyword`	string	Có	Từ khóa tìm kiếm.
`limit`	integer	Không	Số phim mỗi trang (mặc định 10).
`page`	integer	Không	Trang hiện tại (mặc định 1).
`limit`	integer	Không	Số phim mỗi trang (áp dụng ở tìm kiếm; mặc định 10 - tối đa 64).
`category`	slug	Không	Lọc theo thể loại, ví dụ hanh-dong.
`country`	slug	Không	Lọc theo quốc gia, ví dụ han-quoc.
`year`	number	Không	Lọc theo năm phát hành, ví dụ 2024. Có thể theo dải, ví dụ 2014,2024.
`sort_field`	string	Không	modified.time \| _id \| year (mặc định modified.time).
`sort_type`	string	Không	desc \| asc (mặc định desc).
`sort_lang`	string	Không	vietsub \| thuyet-minh \| long-tieng.

Cấu trúc phản hồi (rút gọn)

{
    "status": "success",
    "message": "",
    "data": {
        "items": [
            {
                "tmdb": {
                    "id": "718789",
                    "type": "movie",
                    "season": null,
                    "vote_average": 6.887,
                    "vote_count": 3703
                },
                "imdb": {
                    "id": null,
                    "vote_average": 0,
                    "vote_count": 0
                },
                "modified": {
                    "time": "2026-01-23T09:07:25.000Z"
                },
                "_id": "54229abfcfa5649e7003b83dd4755294",
                "name": "Lightyear: Cảnh Sát Vũ Trụ",
                "slug": "lightyear-canh-sat-vu-tru",
                "origin_name": "Lightyear",
                "alternative_names": [],
                "type": "hoathinh",
                "thumb_url": "c34d0de9b0d8383ae31ac2d13e74a924.jpg",
                "poster_url": "c34d0de9b0d8383ae31ac2d13e74a924.jpg",
                "sub_docquyen": false,
                "chieurap": true,
                "time": "105 phút",
                "episode_current": "Full",
                "quality": "FHD",
                "lang": "Vietsub + Lồng Tiếng",
                "lang_key": [
                    "vs"
                ],
                "year": 2022,
                "category": [
                    {
                        "name": "Khoa Học",
                        "slug": "khoa-hoc",
                        "id": "6a4927308e6c3c87500b802e"
                    }
                ],
                "country": [
                    {
                        "name": "Âu Mỹ",
                        "slug": "au-my",
                        "id": "6a4927308e6c3c87500b8006"
                    }
                ],
                "last_episodes": [
                    {
                        "server_name": "Vietsub",
                        "is_ai": false,
                        "name": "Full"
                    }
                ]
            }
        ],
        "params": {
            "type_slug": "tim-kiem",
            "keyword": "canh",
            "filterCategory": [
                ""
            ],
            "filterCountry": [
                ""
            ],
            "filterYear": "",
            "filterType": "",
            "sortField": "modified.time",
            "sortType": "desc",
            "includeUnpublished": false,
            "pagination": {
                "totalItems": 6,
                "totalItemsPerPage": 24,
                "currentPage": 1,
                "pageRanges": 5
            }
        }
    }
}

URL ví dụ

https://phimapi.com/v1/api/tim-kiem?keyword=avengers&limit=10