AVDB API文档

⚡ 快速开始

几秒内获取首次API响应。无需注册或API密钥。

1. 获取最新视频

2. 按ID获取视频

3. 按番号搜索

🔗 基础URL

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

🔓 认证

📡 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)

📋 视频列表

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.

🎬 视频详情

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

Parameters

示例

🔍 搜索

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

搜索示例

🔧 Filtering & Combining Parameters

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

组合示例

📦 响应格式

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.

示例

📑 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

📂 分类

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

📄 分页

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
}

📦 XML格式

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

💻 代码示例

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";
?>

⚙️ Maccms CMS设置

Step-by-step guide for adding this API as a collection source in Maccms CMS.

步骤1：添加自定义采集源

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

步骤2：配置参数

• 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

步骤3：增量采集

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.

🎬 Maccms API — 视频详情

Full detail mode returns all vod_* fields including descriptions, play URLs, and metadata. Same parameters as Standard API.

Parameters (same as Standard API)

示例

🔍 Maccms API — 搜索

All search parameters from the Standard API work with provide1 too.

搜索示例

🔧 Maccms API — 组合过滤

Combine parameters for precise results. All filters are AND logic.

组合示例

📦 Maccms API — 响应格式

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
        }
    ]
}

⏱️ 速率限制

To ensure fair usage for all users, the following rate limits apply:

❓ 常见问题