🎬 即刻短剧API

专业的短剧内容管理接口平台 - API接口文档

🏠 基础信息

服务地址

基础URL: https://api.uuuka.com

API版本: v2.2.1

数据格式: JSON

字符编码: UTF-8

🌟 支持的内容类型

  • post - 短剧:热门短剧、微剧、网剧内容
  • dongman - 动漫:国产动漫、日漫、欧美动画
  • movie - 电影:院线电影、网络电影资源
  • tv - 电视剧:热播剧集、经典电视剧
  • xuexi - 学习资源:教育视频、技能培训内容
  • baidu - 百度短剧:百度短剧资源内容

🔐 认证说明

访问限制

当前API采用IP限流机制,每个IP每分钟最多请求100次。

如需更高频率访问,请联系技术支持获取API密钥。

⚠️ 安全提醒

请勿在搜索关键词中包含特殊字符:< > " ' & ; ( ) { } [ ]

关键词长度不能超过100个字符。

📺 内容管理接口

获取所有内容

GET /api/contents
GET /api/contents?page=1&limit=20
GET /api/contents?today&page=1&limit=20

请求参数

参数名 类型 必填 默认值 说明
page int 1 页码,范围:1-1000
limit int 20 每页数量,范围:1-100
today string - 查询今日更新,传入任意值即可(如:today)

响应示例

{ "success": true, "message": "获取成功", "data": { "items": [ { "title": "霸道总裁的小甜妻", "source_link": "https://example.com/drama1", "type": "post", "update_time": "2024-01-01 10:30:00" } ], "total": 1000, "page": 1, "limit": 20, "total_pages": 50 } }

按类型获取内容

GET /api/contents/{content_type}
GET /api/contents/post?page=1&limit=20&keyword=霸道总裁
GET /api/contents/post?today&page=1&limit=20

路径参数

参数名 类型 必填 说明
content_type string 内容类型:post/dongman/movie/tv/xuexi/baidu

查询参数

参数名 类型 必填 默认值 说明
page int 1 页码,范围:1-1000
limit int 20 每页数量,范围:1-100
keyword string - 搜索关键词,支持模糊搜索
today string - 查询今日更新,传入任意值即可(如:today)

响应示例

{ "success": true, "message": "获取成功", "data": { "items": [ { "title": "霸道总裁的小甜妻", "source_link": "https://example.com/drama1", "type": "post", "update_time": "2024-01-01 10:30:00" } ], "total": 50, "page": 1, "limit": 20, "total_pages": 3, "content_type": "post", "keyword": "霸道总裁" } }

获取指定类型的全部内容

GET /api/contents/{content_type}/all
GET /api/contents/post/all
GET /api/contents/movie/all

⚠️ 重要限制

此接口每分钟只能请求一次!如果请求过于频繁,将返回429错误,并提示剩余等待时间。

此接口返回指定类型的所有数据,不进行分页,数据量可能较大,请谨慎使用。

路径参数

参数名 类型 必填 说明
content_type string 内容类型:post/dongman/movie/tv/xuexi/baidu

响应示例

{ "success": true, "message": "获取全部内容成功", "data": { "items": [ { "title": "短剧标题1", "source_link": "https://example.com/drama1", "update_time": "2024-01-15 10:30:00", "type": "post" }, { "title": "短剧标题2", "source_link": "https://example.com/drama2", "update_time": "2024-01-15 09:20:00", "type": "post" } ], "total": 5000, "content_type": "post", "is_all_data": true } }

限流错误响应

{ "success": false, "message": "请求频率超过限制", "error": "全部内容接口每分钟只能请求一次,请等待 45 秒后重试", "error_code": "RATE_LIMIT_EXCEEDED" }

💡 使用示例

  • 获取全部短剧: GET /api/contents/post/all
  • 获取全部电影: GET /api/contents/movie/all
  • 获取全部动漫: GET /api/contents/dongman/all
  • 获取全部电视剧: GET /api/contents/tv/all
  • 获取全部学习资源: GET /api/contents/xuexi/all
  • 获取全部百度短剧: GET /api/contents/baidu/all

📋 注意事项

  • 此接口返回所有数据,不进行分页,数据量可能非常大
  • 建议仅在需要完整数据时使用,日常查询请使用分页接口
  • 接口结果会缓存1小时,提高响应速度
  • 限流基于IP地址,每个IP每分钟只能请求一次(全局限流,不区分内容类型)
  • 即使用户请求不同的内容类型(如先请求post/all,再请求movie/all),也会受到限流限制

获取今日更新内容

GET /api/contents/{content_type}?today
GET /api/contents/post?today
GET /api/contents/post?today&page=1&limit=20

📅 功能说明

此接口用于查询指定内容类型在今日更新的所有内容。通过添加 today 参数即可筛选出今日更新的数据。

使用场景:获取最新更新的短剧、动漫、电影等内容,方便用户查看今日新增资源。

路径参数

参数名 类型 必填 说明
content_type string 内容类型:post/dongman/movie/tv/xuexi/baidu

查询参数

参数名 类型 必填 默认值 说明
today string - 查询今日更新,传入任意值即可(如:today)
page int 1 页码,范围:1-1000
limit int 20 每页数量,范围:1-100

响应示例

{ "success": true, "message": "获取今日数据成功", "data": { "items": [ { "title": "今日更新的短剧标题", "source_link": "https://example.com/drama1", "update_time": "2024-01-15 10:30:00", "type": "post" } ], "total": 50, "page": 1, "limit": 20, "total_pages": 3, "content_type": "post", "today": true } }

💡 使用示例

  • 获取今日短剧: GET /api/contents/post?today
  • 获取今日动漫(分页): GET /api/contents/dongman?today&page=1&limit=10
  • 获取所有类型今日更新: GET /api/contents?today

获取支持的内容类型

GET /api/types
GET /api/types

响应示例

{ "success": true, "message": "获取成功", "data": { "supported_types": { "post": { "name": "短剧", "description": "热门短剧、微剧、网剧内容" }, "dongman": { "name": "动漫", "description": "国产动漫、日漫、欧美动画" }, "movie": { "name": "电影", "description": "院线电影、网络电影资源" }, "tv": { "name": "电视剧", "description": "热播剧集、经典电视剧" }, "xuexi": { "name": "学习资源", "description": "教育视频、技能培训内容" }, "baidu": { "name": "百度短剧", "description": "百度短剧资源内容" } }, "total_types": 6 } }

🔍 搜索接口

搜索内容

GET /api/search
GET /api/search?keyword=霸道总裁&content_type=post&page=1&limit=20

请求参数

参数名 类型 必填 默认值 说明
keyword string - 搜索关键词,长度:1-100字符
content_type string - 内容类型过滤
page int 1 页码,范围:1-1000
limit int 20 每页数量,范围:1-100

响应示例

{ "success": true, "message": "搜索成功", "data": { "items": [ { "title": "霸道总裁的小甜妻", "source_link": "https://example.com/drama1", "type": "post", "update_time": "2024-01-01 10:30:00" } ], "total": 25, "page": 1, "limit": 20, "total_pages": 2, "keyword": "霸道总裁", "content_type": "post" } }

🔧 系统接口

系统状态

GET /api/status
GET /api/status

响应示例

{ "success": true, "message": "API服务正常运行", "data": { "service": "即刻短剧API", "version": "2.2.1", "status": "running", "environment": "production", "features": [ "短剧内容管理", "智能搜索引擎", "安全防护系统", "实时数据同步", "移动端优化" ] } }

健康检查

GET /api/health
GET /api/health

响应示例

{ "success": true, "message": "服务健康", "data": { "status": "healthy", "database": "connected", "timestamp": "2024-01-01T12:00:00Z" } }

❌ 错误码说明

状态码 错误码 说明 解决方案
200 - 请求成功 -
400 BAD_REQUEST 请求参数错误 检查请求参数格式和取值范围
404 RESOURCE_NOT_FOUND 请求的资源不存在 检查请求URL是否正确
429 RATE_LIMIT_EXCEEDED 请求频率超过限制 稍后重试或联系技术支持
500 INTERNAL_SERVER_ERROR 服务器内部错误 稍后重试或联系技术支持

错误响应格式

{ "success": false, "message": "错误描述", "error_code": "ERROR_CODE", "error": "详细错误信息", "suggestion": "解决建议" }

💡 使用示例

JavaScript/Ajax 示例

JavaScript/Ajax
// 获取短剧列表
fetch('/api/contents/post?page=1&limit=10')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('获取成功:', data.data.items);
    } else {
      console.error('获取失败:', data.message);
    }
  })
  .catch(error => {
    console.error('请求错误:', error);
  });

// 获取今日更新的短剧
fetch('/api/contents/post?today&page=1&limit=10')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('今日更新:', data.data.items);
    }
  });

// 获取百度短剧
fetch('/api/contents/baidu?page=1&limit=20')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('百度短剧:', data.data.items);
    }
  });

// 搜索百度短剧
fetch('/api/contents/baidu?keyword=关键词&page=1&limit=20')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('搜索结果:', data.data.items);
    }
  });

// 获取全部短剧(每分钟只能请求一次)
fetch('/api/contents/post/all')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('全部短剧:', data.data.items);
      console.log('总数:', data.data.total);
    } else if (data.error_code === 'RATE_LIMIT_EXCEEDED') {
      console.error('请求过于频繁:', data.error);
    }
  });

// 搜索内容
fetch('/api/search?keyword=霸道总裁&content_type=post')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('搜索结果:', data.data.items);
    }
  });
                    

Python 示例

Python
import requests

# 基础URL
base_url = "https://api.uuuka.com"

# 获取短剧列表
response = requests.get(f"{base_url}/api/contents/post", params={
    'page': 1,
    'limit': 10,
    'keyword': '霸道总裁'
})

if response.status_code == 200:
    data = response.json()
    if data['success']:
        print("获取成功:", data['data']['items'])
    else:
        print("获取失败:", data['message'])
else:
    print("请求失败:", response.status_code)

# 获取百度短剧
baidu_response = requests.get(f"{base_url}/api/contents/baidu", params={
    'page': 1,
    'limit': 20
})

if baidu_response.status_code == 200:
    baidu_data = baidu_response.json()
    if baidu_data['success']:
        print("百度短剧:", baidu_data['data']['items'])

# 搜索百度短剧
baidu_search = requests.get(f"{base_url}/api/contents/baidu", params={
    'keyword': '关键词',
    'page': 1,
    'limit': 20
})

if baidu_search.status_code == 200:
    search_data = baidu_search.json()
    if search_data['success']:
        print("搜索结果:", search_data['data']['items'])

# 获取全部短剧(每分钟只能请求一次)
all_response = requests.get(f"{base_url}/api/contents/post/all")

if all_response.status_code == 200:
    all_data = all_response.json()
    if all_data['success']:
        print("全部短剧:", all_data['data']['items'])
        print("总数:", all_data['data']['total'])
    elif all_data.get('error_code') == 'RATE_LIMIT_EXCEEDED':
        print("请求过于频繁:", all_data['error'])

# 获取今日更新的短剧
today_response = requests.get(f"{base_url}/api/contents/post", params={
    'today': 'today',
    'page': 1,
    'limit': 10
})

if today_response.status_code == 200:
    today_data = today_response.json()
    if today_data['success']:
        print("今日更新:", today_data['data']['items'])
        print("今日更新总数:", today_data['data']['total'])

# 搜索内容
search_response = requests.get(f"{base_url}/api/search", params={
    'keyword': '霸道总裁',
    'content_type': 'post',
    'page': 1,
    'limit': 20
})

if search_response.status_code == 200:
    search_data = search_response.json()
    print("搜索结果:", search_data['data']['items'])
                    

cURL 示例

cURL
# 获取所有内容
curl -X GET "https://api.uuuka.com/api/contents?page=1&limit=20"

# 获取指定类型内容
curl -X GET "https://api.uuuka.com/api/contents/post?page=1&limit=10&keyword=霸道总裁"

# 获取百度短剧
curl -X GET "https://api.uuuka.com/api/contents/baidu?page=1&limit=20"
curl -X GET "https://api.uuuka.com/api/contents/baidu?keyword=关键词&page=1&limit=20"

# 获取指定类型的全部内容(每分钟只能请求一次)
curl -X GET "https://api.uuuka.com/api/contents/post/all"
curl -X GET "https://api.uuuka.com/api/contents/movie/all"
curl -X GET "https://api.uuuka.com/api/contents/dongman/all"
curl -X GET "https://api.uuuka.com/api/contents/baidu/all"

# 获取今日更新内容
curl -X GET "https://api.uuuka.com/api/contents/post?today"
curl -X GET "https://api.uuuka.com/api/contents/post?today&page=1&limit=20"

# 获取所有类型今日更新
curl -X GET "https://api.uuuka.com/api/contents?today&page=1&limit=20"

# 搜索内容
curl -X GET "https://api.uuuka.com/api/search?keyword=霸道总裁&content_type=post&page=1&limit=20"

# 获取系统状态
curl -X GET "https://api.uuuka.com/api/status"

# 健康检查
curl -X GET "https://api.uuuka.com/api/health"
                    

💡 百度热搜短剧演员榜API | 接口地址:https://baidu.uuuka.com

接口文档 | 接口地址:https://baidu.uuuka.com | 演示地址:https://hot.uuuka.com

JavaScript/Ajax
// 获取短剧列表

"description":"基于百度热搜榜数据的短剧演员排行榜API服务"

"authentication":"Bearer Token (IP绑定)"

"get_hot_dramas":"https://baidu.uuuka.com/api/drama-actors/hot-dramas"     热剧排行

"get_all_actors":"https://baidu.uuuka.com/api/drama-actors",               演员排行

"get_female_actors":"https://baidu.uuuka.com/api/drama-actors/female",     女性演员

"get_male_actors":"https://baidu.uuuka.com/api/drama-actors/male"          男性演员



// Token获取方式,扫描右小角图片公众号回复"token",修改绑定IP回复 "tokenip"
// Token获取方式,扫描右小角图片公众号回复"token",修改绑定IP回复 "tokenip"
// Token获取方式,扫描右小角图片公众号回复"token",修改绑定IP回复 "tokenip"
// Token获取方式,扫描右小角图片公众号回复"token",修改绑定IP回复 "tokenip"
// Token获取方式,扫描右小角图片公众号回复"token",修改绑定IP回复 "tokenip"
// Token获取方式,扫描右小角图片公众号回复"token",修改绑定IP回复 "tokenip"

                    

💡 夸克热搜榜数据API | 接口地址:https://baidu.uuuka.com

接口文档 | 接口地址:https://baidu.uuuka.com | 演示地址:https://hot.uuuka.com

JavaScript/Ajax
// 获取短剧列表

"description":"基于夸克热搜榜数据的排行榜API服务"

"https://baidu.uuuka.com/api/quark/xxxxx/hot?start=1&hit=10 "          start起始页不能改变,hit根绝数据来决定可支持更大数值!

"authentication":"Bearer Token (IP绑定)"

"get_hot_dramas":"https://baidu.uuuka.com/api/quark/drama/hot"         短剧排行

"get_all_actors":"https://baidu.uuuka.com/api/quark/movie/hot"         电影排行

"get_female_actors":"https://baidu.uuuka.com/api/quark/tv/hot"         电视剧排行

"get_male_actors":"https://baidu.uuuka.com/api/quark/anime/hot"        动漫排行

"get_male_actors":"https://baidu.uuuka.com/api/quark/variety/hot"      综艺排行



// Token获取方式,扫描右小角图片公众号回复"token",修改绑定IP回复 "tokenip"
// Token获取方式,扫描右小角图片公众号回复"token",修改绑定IP回复 "tokenip"
// Token获取方式,扫描右小角图片公众号回复"token",修改绑定IP回复 "tokenip"
// Token获取方式,扫描右小角图片公众号回复"token",修改绑定IP回复 "tokenip"
// Token获取方式,扫描右小角图片公众号回复"token",修改绑定IP回复 "tokenip"

                    

📞 技术支持

联系方式

技术支持邮箱: uchatrun@gmail.com

商务合作邮箱: uchatrun@gmail.com

API版本: v2.2.1

最后更新: 2025年6月

⚠️ 重要提醒

  • 请合理使用API,避免频繁请求导致服务器压力
  • 搜索关键词请避免使用特殊字符
  • 建议在生产环境中使用HTTPS协议
  • 如遇到问题,请及时联系技术支持

📱 微信公众号

微信公众号二维码

扫码关注获取最新动态