Phim API

https://kkphim.com/tai-lieu-api
Admin
An API for movie website developers, providing endpoints to retrieve movie lists, detailed movie...
Tokens:5,391
Snippets:24
Trust Score:5.5
Update:1 year ago
Show doc for...
Tokens:
Raw
### GET /danh-sach/phim-moi-cap-nhat

Source: https://kkphim.com/tai-lieu-api/index

Retrieves a list of newly updated movies. Supports pagination.

```APIDOC
## GET /danh-sach/phim-moi-cap-nhat

### Description
Retrieves a list of newly updated movies, supporting pagination.

### Method
GET

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

#### Query Parameters
- **page** (integer) - Required - The page number to retrieve.
```

--------------------------------

### GET /image.php

Source: https://kkphim.com/tai-lieu-api/index

Converts an image URL to WEBP format for improved website performance and SEO.

```APIDOC
## Chuyển đổi ảnh sang WEBP

### Description
Converts a given image URL to the WEBP format. This can help improve website loading speed and SEO.

### Method
GET

### Endpoint
https://phimapi.com/image.php

### Parameters
#### Query Parameters
- **url** (string) - Required - The original URL of the image provided by KKPhim.

### Request Example
```
GET https://phimapi.com/image.php?url=https://phimimg.com/upload/vod/20250624-1/6295cf08845cf14b511410c7547d336a.jpg
```

### Response
#### Success Response (200)
- The response will be the image in WEBP format.

#### Response Example
(Binary data representing a WEBP image)
```
```

--------------------------------

### GET /v1/api/tim-kiem

Source: https://kkphim.com/tai-lieu-api/index

Searches for movies based on a keyword and applies various filters for refinement.

```APIDOC
## GET /v1/api/tim-kiem

### Description
Searches for movies based on a keyword and applies various filters for refinement.

### Method
GET

### Endpoint
https://phimapi.com/v1/api/tim-kiem

#### Query Parameters
- **keyword** (string) - Required - The search keyword.
- **page** (integer) - Optional - The page number to retrieve.
- **sort_field** (string) - Optional - The field to sort by. Options: modified.time, _id, year.
- **sort_type** (string) - Optional - The type of sort order. Options: asc, desc.
- **sort_lang** (string) - Optional - The language filter for sorting. Options: vietsub, thuyet-minh, long-tieng.
- **category** (string) - Optional - The category slug for filtering movies (use /the-loai to get slugs).
- **country** (string) - Optional - The country slug for filtering movies (use /quoc-gia to get slugs).
- **year** (integer) - Optional - The release year for filtering movies (e.g., 1970-current).
- **limit** (integer) - Optional - The maximum number of results per page (max 64).
```

--------------------------------

### GET /the-loai

Source: https://kkphim.com/tai-lieu-api/index

Retrieves a list of all available movie categories.

```APIDOC
## GET /the-loai

### Description
Retrieves a list of all available movie categories.

### Method
GET

### Endpoint
https://phimapi.com/the-loai
```

--------------------------------

### GET /danh-sach/phim-moi-cap-nhat-v2

Source: https://kkphim.com/tai-lieu-api/index

Retrieves a list of newly updated movies (V2), providing different results for various needs. Supports pagination.

```APIDOC
## GET /danh-sach/phim-moi-cap-nhat-v2

### Description
Retrieves a list of newly updated movies (V2), providing different results for various needs. Supports pagination.

### Method
GET

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

#### Query Parameters
- **page** (integer) - Required - The page number to retrieve.
```

--------------------------------

### GET /quoc-gia

Source: https://kkphim.com/tai-lieu-api/index

Retrieves a list of movie countries. Use this endpoint to get the slugs for country filtering in other endpoints.

```APIDOC
## Quốc gia phim

### Description
Retrieves a list of available countries for filtering movies.

### Method
GET

### Endpoint
https://phimapi.com/quoc-gia

### Parameters
None

### Request Example
```
GET https://phimapi.com/quoc-gia
```

### Response
#### Success Response (200)
- **countries** (array) - A list of country objects, each with a 'slug' and 'name'.

#### Response Example
```json
{
  "countries": [
    {
      "name": "Việt Nam",
      "slug": "viet-nam"
    },
    {
      "name": "Trung Quốc",
      "slug": "trung-quoc"
    }
  ]
}
```
```

--------------------------------

### GET /phim/{slug}

Source: https://kkphim.com/tai-lieu-api/index

Retrieves detailed information about a specific movie, including its episodes, using its slug.

```APIDOC
## GET /phim/{slug}

### Description
Retrieves detailed information about a specific movie, including its episodes, using its slug.

### Method
GET

### Endpoint
https://phimapi.com/phim/{slug}

#### Path Parameters
- **slug** (string) - Required - The unique slug of the movie.
```

--------------------------------

### GET /danh-sach/phim-moi-cap-nhat-v3

Source: https://kkphim.com/tai-lieu-api/index

Retrieves a list of newly updated movies (V3), providing different results for various needs. Supports pagination.

```APIDOC
## GET /danh-sach/phim-moi-cap-nhat-v3

### Description
Retrieves a list of newly updated movies (V3), providing different results for various needs. Supports pagination.

### Method
GET

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

#### Query Parameters
- **page** (integer) - Required - The page number to retrieve.
```

--------------------------------

### GET /v1/api/nam/{type_list}

Source: https://kkphim.com/tai-lieu-api/index

Retrieves a list of movies filtered by release year. Allows for pagination, sorting, and filtering by category, country, and language.

```APIDOC
## Năm

### Description
Retrieves a list of movies filtered by a specific release year. Supports various filtering and sorting options.

### Method
GET

### Endpoint
https://phimapi.com/v1/api/nam/{type_list}

### Parameters
#### Path Parameters
- **type_list** (integer) - Required - The release year to filter by (e.g., 2024).

#### Query Parameters
- **page** (integer) - Optional - The page number to retrieve. Use `totalPages` to determine the total number of available pages.
- **sort_field** (string) - Optional - The field to sort by. Options: `modified.time`, `_id`, `year`.
- **sort_type** (string) - Optional - The sort order. Options: `desc`, `asc`.
- **sort_lang** (string) - Optional - Filter by audio language. Options: `vietsub`, `thuyet-minh`, `long-tieng`.
- **category** (string) - Optional - Filter by movie category slug. Use `phimapi.com/the-loai` to get available slugs.
- **country** (string) - Optional - Filter by country slug. Use `phimapi.com/quoc-gia` to get available slugs.
- **limit** (integer) - Optional - The maximum number of results to return (max 64).

### Request Example
```
GET https://phimapi.com/v1/api/nam/2024?page=1&sort_field=_id&sort_type=asc&sort_lang=long-tieng&category=hanh-dong&country=trung-quoc&limit=10
```

### Response
#### Success Response (200)
- **items** (array) - A list of movie objects matching the criteria.
- **totalPages** (integer) - The total number of pages available for the given query.

#### Response Example
```json
{
  "items": [
    {
      "name": "Movie Title A",
      "year": 2024,
      "type_list": "trung-quoc",
      "category": "hanh-dong",
      "lang": "long-tieng"
    },
    {
      "name": "Movie Title B",
      "year": 2024,
      "type_list": "trung-quoc",
      "category": "hanh-dong",
      "lang": "long-tieng"
    }
  ],
  "totalPages": 45
}
```
```

--------------------------------

### GET /v1/api/quoc-gia/{type_list}

Source: https://kkphim.com/tai-lieu-api/index

Retrieves a list of movies filtered by country. Allows for pagination, sorting, and filtering by category, year, and language.

```APIDOC
## Chi tiết của quốc gia

### Description
Retrieves a list of movies filtered by a specific country. Supports various filtering and sorting options.

### Method
GET

### Endpoint
https://phimapi.com/v1/api/quoc-gia/{type_list}

### Parameters
#### Path Parameters
- **type_list** (string) - Required - The slug of the country to filter by. Use `phimapi.com/quoc-gia` to get available slugs.

#### Query Parameters
- **page** (integer) - Optional - The page number to retrieve. Use `totalPages` to determine the total number of available pages.
- **sort_field** (string) - Optional - The field to sort by. Options: `modified.time`, `_id`, `year`.
- **sort_type** (string) - Optional - The sort order. Options: `desc`, `asc`.
- **sort_lang** (string) - Optional - Filter by audio language. Options: `vietsub`, `thuyet-minh`, `long-tieng`.
- **category** (string) - Optional - Filter by movie category slug. Use `phimapi.com/the-loai` to get available slugs.
- **country** (string) - Optional - Filter by country slug. Use `phimapi.com/quoc-gia` to get available slugs.
- **year** (integer) - Optional - Filter by release year (1970 - current year).
- **limit** (integer) - Optional - The maximum number of results to return (max 64).

### Request Example
```
GET https://phimapi.com/v1/api/quoc-gia/trung-quoc?page=1&sort_field=_id&sort_type=asc&sort_lang=long-tieng&category=hanh-dong&year=2024&limit=10
```

### Response
#### Success Response (200)
- **items** (array) - A list of movie objects matching the criteria.
- **totalPages** (integer) - The total number of pages available for the given query.

#### Response Example
```json
{
  "items": [
    {
      "name": "Movie Title 1",
      "year": 2024,
      "type_list": "trung-quoc",
      "category": "hanh-dong",
      "lang": "long-tieng"
    },
    {
      "name": "Movie Title 2",
      "year": 2023,
      "type_list": "trung-quoc",
      "category": "hanh-dong",
      "lang": "long-tieng"
    }
  ],
  "totalPages": 50
}
```
```

--------------------------------

### GET /tmdb/{type}/{id}

Source: https://kkphim.com/tai-lieu-api/index

Retrieves movie information based on its TMDB ID. Supports both 'tv' and 'movie' types.

```APIDOC
## GET /tmdb/{type}/{id}

### Description
Retrieves movie information based on its TMDB ID. Supports both 'tv' and 'movie' types.

### Method
GET

### Endpoint
https://phimapi.com/tmdb/{type}/{id}

#### Path Parameters
- **type** (string) - Required - The type of media, either 'tv' (for series, including cartoons and TV shows) or 'movie'.
- **id** (integer) - Required - The TMDB ID of the movie or series.
```

--------------------------------

### GET /v1/api/the-loai/{type_list}

Source: https://kkphim.com/tai-lieu-api/index

Retrieves a list of movies filtered by a specific category slug, with various sorting and filtering options.

```APIDOC
## GET /v1/api/the-loai/{type_list}

### Description
Retrieves a list of movies filtered by a specific category slug, with various sorting and filtering options.

### Method
GET

### Endpoint
https://phimapi.com/v1/api/the-loai/{type_list}

#### Path Parameters
- **type_list** (string) - Required - The slug of the category to filter by (obtain from /the-loai endpoint).

#### Query Parameters
- **page** (integer) - Optional - The page number to retrieve.
- **sort_field** (string) - Optional - The field to sort by. Options: modified.time, _id, year.
- **sort_type** (string) - Optional - The type of sort order. Options: asc, desc.
- **sort_lang** (string) - Optional - The language filter for sorting. Options: vietsub, thuyet-minh, long-tieng.
- **country** (string) - Optional - The country slug for filtering movies (use /quoc-gia to get slugs).
- **year** (integer) - Optional - The release year for filtering movies (e.g., 1970-current).
- **limit** (integer) - Optional - The maximum number of results per page (max 64).
```

--------------------------------

### GET /v1/api/danh-sach/{type_list}

Source: https://kkphim.com/tai-lieu-api/index

Retrieves a comprehensive list of movies based on various filters like type, sorting, category, country, year, and limit.

```APIDOC
## GET /v1/api/danh-sach/{type_list}

### Description
Retrieves a comprehensive list of movies based on various filters like type, sorting, category, country, year, and limit.

### Method
GET

### Endpoint
https://phimapi.com/v1/api/danh-sach/{type_list}

#### Path Parameters
- **type_list** (string) - Required - The type of movie list to retrieve. Options: phim-bo, phim-le, tv-shows, hoat-hinh, phim-vietsub, phim-thuyet-minh, phim-long-tieng.

#### Query Parameters
- **page** (integer) - Optional - The page number to retrieve.
- **sort_field** (string) - Optional - The field to sort by. Options: modified.time, _id, year.
- **sort_type** (string) - Optional - The type of sort order. Options: asc, desc.
- **sort_lang** (string) - Optional - The language filter for sorting. Options: vietsub, thuyet-minh, long-tieng.
- **category** (string) - Optional - The category slug for filtering movies (use /the-loai to get slugs).
- **country** (string) - Optional - The country slug for filtering movies (use /quoc-gia to get slugs).
- **year** (integer) - Optional - The release year for filtering movies (e.g., 1970-current).
- **limit** (integer) - Optional - The maximum number of results per page (max 64).
```

--------------------------------

### Get Detailed Country Movie List - phimapi.com API

Source: https://kkphim.com/tai-lieu-api/index

Fetches a detailed list of movies filtered by country, with options for pagination, sorting, and filtering by category, year, and language. The 'type_list' parameter specifies the country slug.

```http
GET https://phimapi.com/v1/api/quoc-gia/{type_list}?page={page} &sort_field={sort_field} &sort_type={sort_type} &sort_lang={sort_lang} &category={category} &country={country} &year={year} &limit={limit}
```

```http
GET https://phimapi.com/v1/api/quoc-gia/trung-quoc?page=1 &sort_field=_id &sort_type=asc &sort_lang=long-tieng &category=hanh-dong &year=2024 &limit=10
```

--------------------------------

### Get Movie Countries List - phimapi.com API

Source: https://kkphim.com/tai-lieu-api/index

Retrieves a list of movie countries from the phimapi.com API. No specific parameters are required for the base request.

```http
GET https://phimapi.com/quoc-gia
```

--------------------------------

### Get Movie Years List - phimapi.com API

Source: https://kkphim.com/tai-lieu-api/index

Retrieves a list of movies filtered by release year. This endpoint allows for pagination, sorting, and filtering by category, country, and language.

```http
GET https://phimapi.com/v1/api/nam/{type_list}?page={page} &sort_field={sort_field} &sort_type={sort_type} &sort_lang={sort_lang} &category={category} &country={country} &limit={limit}
```

```http
GET https://phimapi.com/v1/api/nam/2024?page=1 &sort_field=_id &sort_type=asc &sort_lang=long-tieng &category=hanh-dong &country=trung-quoc &limit=10
```

--------------------------------

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

Source: https://kkphim.com/tai-lieu-api/index

Truy xuất danh sách phim mới cập nhật từ API. Hỗ trợ nhiều phiên bản (V1, V2, V3) với các kết quả khác nhau. Tham số 'page' dùng để phân trang.

```HTTP
GET https://phimapi.com/danh-sach/phim-moi-cap-nhat?page=**${page}**
GET https://phimapi.com/danh-sach/phim-moi-cap-nhat-v2?page=**1**
GET https://phimapi.com/danh-sach/phim-moi-cap-nhat-v3?page=**1**
```

--------------------------------

### Convert Image to WEBP - phimapi.com API

Source: https://kkphim.com/tai-lieu-api/index

Converts an image URL to the WEBP format. This is useful for optimizing website image loading speed and SEO. The 'url' parameter should be the original image link from KKPhim.

```http
GET https://phimapi.com/image.php?url={liên kết ảnh từ KKPhim}
```

```http
GET https://phimapi.com/image.php?url=https://phimimg.com/upload/vod/20250624-1/6295cf08845cf14b511410c7547d336a.jpg
```

--------------------------------

### Lấy thông tin phim và tập phim (API)

Source: https://kkphim.com/tai-lieu-api/index

Truy xuất thông tin chi tiết của một bộ phim và danh sách các tập phim của nó bằng cách sử dụng slug của phim. Ví dụ sử dụng slug 'ngoi-truong-xac-song'.

```HTTP
GET https://phimapi.com/phim/**{slug}**
Ví dụ: https://kkphim.com/phim/ngoi-truong-xac-song GET https://phimapi.com/phim/**ngoi-truong-xac-song**
```

--------------------------------

### Tìm kiếm phim theo từ khóa (API)

Source: https://kkphim.com/tai-lieu-api/index

Thực hiện tìm kiếm phim dựa trên từ khóa. Cho phép tùy chỉnh kết quả bằng cách sắp xếp, lọc theo ngôn ngữ, thể loại, quốc gia, năm phát hành và giới hạn số lượng kết quả.

```HTTP
GET https://phimapi.com/v1/api/tim-kiem?keyword=**{keyword}**?page=**{page}** &sort_field=**{sort_field}** &sort_type=**{sort_type}** &sort_lang=**{sort_lang}** &category=**{category}** &country=**{country}** &year=**{year}** &limit=**{limit}**
Ví dụ: GET https://phimapi.com/v1/api/tim-kiem?keyword=**Thước** &page=**1** &sort_field=**_id** &sort_type=**asc** &sort_lang=**long-tieng** &category=**hanh-dong** &country=**trung-quoc** &year=**2024** &limit=**10**
```

--------------------------------

### Lấy chi tiết phim theo thể loại (API)

Source: https://kkphim.com/tai-lieu-api/index

Truy xuất danh sách phim thuộc một thể loại cụ thể. Cho phép tùy chỉnh kết quả bằng cách lọc theo trang, sắp xếp, ngôn ngữ, quốc gia, năm phát hành và giới hạn số lượng phim. Tham số 'type_list' là slug của thể loại.

```HTTP
GET https://phimapi.com/v1/api/the-loai/**{type_list}**?page=**{page}** &sort_field=**{sort_field}** &sort_type=**{sort_type}** &sort_lang=**{sort_lang}** &country=**{country}** &year=**{year}** &limit=**{limit}**
Ví dụ: GET https://phimapi.com/v1/api/the-loai/**hanh-dong**?page=**1** &sort_field=**_id** &sort_type=**asc** &sort_lang=**long-tieng** &country=**trung-quoc** &year=**2024** &limit=**10**
```

--------------------------------

### Lấy danh sách tất cả thể loại phim (API)

Source: https://kkphim.com/tai-lieu-api/index

Truy xuất danh sách tất cả các thể loại phim có sẵn trên hệ thống. Endpoint này không yêu cầu tham số và trả về danh sách các thể loại.

```HTTP
GET https://phimapi.com/**the-loai**
```

--------------------------------

### Lấy thông tin phim dựa trên TMDB ID (API)

Source: https://kkphim.com/tai-lieu-api/index

Truy xuất thông tin phim hoặc TV show dựa trên TMDB ID. Yêu cầu chỉ định loại ('tv' hoặc 'movie') và ID tương ứng. Chỉ áp dụng cho các phim có hỗ trợ TMDB ID trong hệ thống KKPhim.

```HTTP
GET https://phimapi.com/tmdb/**{type}** /**{id}**
Ví dụ: GET https://phimapi.com/tmdb/**tv & movie**/**280945**
```

--------------------------------

### Lấy danh sách phim tổng hợp theo tiêu chí (API)

Source: https://kkphim.com/tai-lieu-api/index

Truy xuất danh sách phim tổng hợp với khả năng lọc theo loại danh sách, trang, trường sắp xếp, loại sắp xếp, ngôn ngữ, thể loại, quốc gia, năm và giới hạn. Hỗ trợ các loại danh sách như 'phim-bo', 'phim-le', 'tv-shows', v.v.

```HTTP
GET https://phimapi.com/v1/api/danh-sach/**{type_list}**?page=**{page}** &sort_field=**{sort_field}** &sort_type=**{sort_type}** &sort_lang=**{sort_lang}** &category=**{category}** &country=**{country}** &year=**{year}** &limit=**{limit}**
Ví dụ: GET https://phimapi.com/v1/api/danh-sach/**phim-bo**?page=**1** &sort_field=**_id** &sort_type=**asc** &sort_lang=**long-tieng** &category=**hanh-dong** &country=**trung-quoc** &year=**2024** &limit=**10**
```
Tokens:
Raw