AVDB Tài liệu API

⚡ Bắt đầu nhanh

Nhận phản hồi API đầu tiên trong vài giây. Không cần đăng ký hoặc API key.

1. LẤY PHIM MỚI NHẤT

2. LẤY PHIM THEO ID

3. TÌM THEO MÃ JAV

🔗 URL cơ sở

All API requests use the following base URLs. We provide two API formats:

🔓 Xác thực

📡 Standard API — Overview

The Standard API (/provide/vod) returns clean, developer-friendly JSON with simplified field names. This is the recommended API for most integrations.

Response Structure

{
    "code": 1,
    "msg": "Data list",
    "page": 1,
    "pagecount": 472,
    "limit": "1000",
    "total": 471707,
    "list": [ ... ],
    "class": [ ... ]        // Only in list mode
}

Video Object Fields (Detail Mode)

📋 Danh sách phim

Get a paginated list of all videos. Returns basic information (no descriptions or play URLs) with category index.

List Mode Fields

In list mode, each video only contains: id, name, origin_name, type_name, category, actor, director, movie_code, country, vod_time

Example: List with Category Filter

Get page 2 of Censored videos in list mode.

🎬 Chi tiết phim

Get full details of videos including descriptions, streaming URLs, and all metadata.

Parameters

Ví dụ

🔍 Tìm kiếm

Powerful search across multiple fields. Uses FULLTEXT search for fast performance on 471K+ records.

Ví dụ tìm kiếm

🔧 Filtering & Combining Parameters

You can combine multiple parameters to narrow results. All filters are applied with AND logic.

Ví dụ kết hợp

📦 Định dạng phản hồi

Here's a complete example response for a detail request:

{
    "code": 1,
    "msg": "Data list",
    "page": 1,
    "pagecount": 1,
    "limit": "1000",
    "total": 1,
    "list": [
        {
            "type_name": "Censored",
            "id": 134,
            "name": "WPSL-285 A Dirty Mouth Drooling Girl...",
            "slug": "wpsl-285",
            "origin_name": "WPSL-285 A Dirty Mouth...",
            "movie_code": "WPSL-285",
            "category": ["Slut", "Cosplay", "Kiss", "HD", "Censored"],
            "actor": ["Urara Kanon"],
            "director": ["Updating"],
            "poster_url": "https://...",
            "thumb_url": "https://...",
            "country": ["Japan"],
            "year": "2025",
            "quality": "HD",
            "time": "02:19:00",
            "description": "Full description text...",
            "episodes": {
                "server_name": "VIP #1",
                "server_data": {
                    "Full": {
                        "slug": "full",
                        "link_embed": "https://..."
                    }
                }
            }
        }
    ]
}

🔌 Maccms API — Overview

The Maccms-compatible API (/provide1/vod) returns raw field names that match the Maccms CMS database schema. Use this if you're collecting data into a Maccms-based website.

Ví dụ

📑 Maccms Field Reference

Key fields returned in the provide1 detail mode:

🌐 Multilingual API New

All API endpoints support 16 languages. Titles, descriptions, categories, and metadata are automatically translated. Simply add the language prefix to the URL.

Supported Languages

📂 Thể loại

Use the t parameter to filter videos by category type ID:

📄 Phân trang

The API returns paginated results. Use pg and pagesize to control pagination.

Pagination Example — Iterate All Pages

async function fetchAllVideos() {
    let page = 1, allVideos = [];
    while (true) {
        const url = `https://avdbapi.com/api.php/provide/vod?ac=detail&pg=${page}&pagesize=100`;
        const res = await fetch(url);
        const data = await res.json();
        allVideos.push(...data.list);
        if (page >= data.pagecount) break;
        page++;
    }
    return allVideos;  // 471K+ videos
}

📦 Định dạng XML

Both APIs support XML output format. Add at=xml to the URL or use the /at/xml path suffix.

💻 Ví dụ mã

Ready-to-use code snippets in popular languages.

# Get latest videos
curl "https://avdbapi.com/api.php/provide/vod?ac=detail"

# Search by JAV code
curl "https://avdbapi.com/api.php/provide/vod?ac=detail&wd=miaa-818"

# Get Vietnamese translation
curl "https://avdbapi.com/vi/api.php/provide/vod?ac=detail&ids=134"

# Get Censored videos, page 2, 50 per page
curl "https://avdbapi.com/api.php/provide/vod?ac=detail&t=1&pg=2&pagesize=50"

# Get XML format
curl "https://avdbapi.com/api.php/provide/vod/at/xml"

// Search for a specific JAV code
async function searchByCode(code) {
    const url = `https://avdbapi.com/api.php/provide/vod?ac=detail&wd=${code}`;
    const response = await fetch(url);
    const data = await response.json();

    if (data.list.length > 0) {
        const video = data.list[0];
        console.log(`Title: ${video.name}`);
        console.log(`Code: ${video.movie_code}`);
        console.log(`Actor: ${video.actor.join(', ')}`);
        console.log(`Categories: ${video.category.join(', ')}`);
        console.log(`Poster: ${video.poster_url}`);
    }
}

searchByCode('MIAA-818');

// Get Vietnamese translations
const viUrl = 'https://avdbapi.com/vi/api.php/provide/vod?ac=detail&ids=134';
fetch(viUrl).then(r => r.json()).then(data => {
    console.log(data.list[0].name);  // Vietnamese title
    console.log(data.lang);              // "vi"
});

import requests

# Search by actress
url = "https://avdbapi.com/api.php/provide/vod"
params = {
    "ac": "detail",
    "actor": "Yua Mikami",
    "pagesize": 20
}
response = requests.get(url, params=params)
data = response.json()

for video in data["list"]:
    print(f"{video['movie_code']} - {video['name']}")
    print(f"  Categories: {', '.join(video['category'])}")
    print(f"  Poster: {video['poster_url']}")
    print()

print(f"Total results: {data['total']}")
print(f"Pages: {data['pagecount']}")

<?php
// Fetch latest censored videos
$url = 'https://avdbapi.com/api.php/provide/vod?ac=detail&t=1&pagesize=20';
$json = file_get_contents($url);
$data = json_decode($json, true);

echo "Total: " . $data['total'] . " videos\n";

foreach ($data['list'] as $video) {
    echo $video['movie_code'] . " - " . $video['name'] . "\n";
    echo "  Actor: " . implode(', ', $video['actor']) . "\n";
    echo "  Poster: " . $video['poster_url'] . "\n\n";
}

// Maccms format for collection
$maccmsUrl = 'https://avdbapi.com/api.php/provide1/vod?ac=detail&h=24';
$maccmsData = json_decode(file_get_contents($maccmsUrl), true);
echo "Updated in 24h: " . $maccmsData['total'] . " videos\n";
?>

⚙️ Cài đặt CMS Maccms

Hướng dẫn từng bước để thêm API này làm nguồn thu thập trong CMS Maccms.

Bước 1: Thêm Nguồn Thu Thập Tùy Chỉnh

1. Login to your Maccms admin panel
2. Go to Collection → Custom Resources
3. Click Add
4. Enter the API URL:

Bước 2: Cấu Hình Tham Số

• Data format: JSON (default)
• If using XML, add &at=xml parameter
• Collection interval: Set to 1–6 hours for automatic updates
• Incremental mode: Use &h=24 to only collect videos updated in the last 24 hours

Bước 3: Thu Thập Tăng Dần

For daily updates, use the hours parameter to only fetch recently updated videos:

This fetches only videos added or updated in the last 24 hours, making collection faster and more efficient.

🎬 API Maccms — Chi tiết phim

Chế độ chi tiết đầy đủ trả về tất cả các trường vod_* bao gồm mô tả, URL phát và metadata. Cùng tham số với API Tiêu chuẩn.

Tham số (giống API Tiêu chuẩn)

Ví dụ

🔍 API Maccms — Tìm kiếm

Tất cả tham số tìm kiếm từ API Tiêu chuẩn đều hoạt động với provide1.

Ví dụ tìm kiếm

🔧 API Maccms — Bộ lọc kết hợp

Kết hợp tham số để có kết quả chính xác. Tất cả bộ lọc dùng logic AND.

Ví dụ kết hợp

📦 API Maccms — Định dạng phản hồi

Example response showing the raw vod_* field names used by Maccms CMS:

{
    "code": 1,
    "msg": "Data list",
    "page": 1,
    "pagecount": 1,
    "limit": "1000",
    "total": 1,
    "list": [
        {
            "vod_id": 134,
            "type_id": 1,
            "type_name": "Censored",
            "vod_name": "WPSL-285 A Dirty Mouth...",
            "vod_sub": "wpsl-285",
            "vod_en": "WPSL-285 A Dirty Mouth...",
            "vod_remarks": "WPSL-285",
            "vod_class": "Slut,Individual,Cosplay,Kiss,...",
            "vod_actor": "Urara Kanon",
            "vod_director": "",
            "vod_writer": "Waap Entertainment",
            "vod_area": "Japan",
            "vod_year": "2025",
            "vod_serial": "接吻しまくり淫口よだれ女",
            "vod_pic": "https://cdn-poster.avdb.pro/...",
            "vod_pic_thumb": "https://cdn-poster.avdb.pro/...",
            "vod_duration": "02:19:00",
            "vod_content": "Full description...",
            "vod_play_from": "VIP",
            "vod_play_url": "Full$https://surrit.com/...",
            "vod_hits": 85,
            "vod_time": "2025-04-08 03:38:35",
            // ... 60+ more vod_* fields
        }
    ]
}

⏱️ Giới hạn tốc độ

Để đảm bảo sử dụng công bằng, các giới hạn tốc độ sau được áp dụng:

❓ Câu hỏi thường gặp