API 接口文档

用于短剧搜索、今日上新、剧集列表、单集解析和批量解析。下面的示例链接都可以直接点开试用。

API 地址:https://orz.icicic.icu/api/api.php
返回首页

接口说明

  • 搜索接口保留分页,按 page 翻页。
  • 上新接口当前返回当天全量结果,前端不需要再自己翻页拼接。
  • 上新接口传 all_time=true 时返回全部时间分页结果,每页固定 20 条,字段和上新一致但不含发布时间和时长。
  • 上新 action 支持 today_newmj_today_newaiju_today_new

返回结构示例

{ "code": 200, "msg": "解析成功", "time": "2026-04-14 18:20:00", "data": [ { "book_id": 7626291792958213182, "title": "妈妈的外卖", "author": "短剧版权3155673834", "type": "校园,家庭?20?", "episode_cnt": 20, "publish_time": "2026-04-14 16:11:04", "duration": "58分钟", "cover": "...", "intro": "...", "record_number": "..." } ], "count": 499 }

密钥验证说明

如何使用接口密钥

解析视频接口(video_id、video_ids)需要验证接口密钥。接口密钥固定以 api- 开头,和软件下载器密钥不通用。

方式一:GET参数传递(推荐)

在请求URL中添加 apiKey 参数(参数名大小写不敏感,推荐写法为 apiKey):

GET /api.php?type=video_id&video_id=xxx&apiKey=api-YOUR_INTERFACE_KEY
https://orz.icicic.icu/api/api.php?type=video_id&video_id=7625142218017229849&level=1080p&fast=1&apiKey=api-YOUR_INTERFACE_KEY

方式二:请求头Authorization

在HTTP请求头中添加 Authorization 字段:

Authorization: Bearer api-YOUR_INTERFACE_KEY

示例(使用curl):

curl -H "Authorization: Bearer api-YOUR_INTERFACE_KEY" "https://orz.icicic.icu/api/api.php?type=video_id&video_id=xxx"

注意事项

  • 每个视频解析消耗 1积分
  • 积分用户:从账户积分中扣除
  • VIP用户:在有效期内免费解析
  • 请妥善保管您的接口密钥,不要泄露给他人
  • 软件密钥只能用于 HG Downloader 软件端的 api_key 参数,不能调用本文档接口
  • 接口密钥只能用于本文档接口的 apiKey 参数,不能作为软件授权密钥使用

接口密钥购买

接口套餐价格

下面是接口文档专用密钥价格,购买后得到 api- 开头的接口密钥。接口密钥和软件密钥不通用。

套餐价格有效天数说明操作
接口周付 ¥299.00 7 天 接口调试和短期接入使用
接口月付 ¥1,050.00 30 天 适合小规模稳定调用
接口季付 ¥2,980.00 90 天 适合持续项目接入
接口半年付 ¥5,000.00 180 天 适合长期项目部署
接口年付 ¥9,000.00 365 天 接口商业接入年付套餐
购买软件密钥

接口列表

GET /api.php?name=关键词&tab_type=11&page=1

搜索接口

搜索短剧或漫剧。这个接口保留分页。

参数说明
name搜索关键词
tab_type11 短剧,19 漫剧
page页码,从 1 开始
https://orz.icicic.icu/api/api.php?name=%E5%A6%88%E5%A6%88&tab_type=11&page=1
搜索接口调用
GET /api.php?type=days_7_to_date&action=today_new&page=1

今日上新接口

获取短剧、漫剧、AI 真人剧的上新列表。

参数说明
type固定为 days_7_to_date
actiontoday_new 短剧上新,mj_today_new 漫剧上新,aiju_today_new AI 系列真人上新
page页码,默认 1
all_timetrue 时返回全部时间分页结果
https://orz.icicic.icu/api/api.php?type=days_7_to_date&action=today_new&page=1
今日上新调用
curl -L "https://orz.icicic.icu/api/api.php?type=days_7_to_date&action=today_new&page=1"
切换 action 可调用漫剧 mj_today_new 或 AI 真人剧 aiju_today_new。
GET /api.php?type=rank&selected_items=排行榜selector_item_id

排行榜接口

根据 selected_items 获取排行榜列表。

参数说明
type固定为 rank
selected_items排行榜类型,默认推荐榜:ranklist_hot_sc,其他排行榜类型看接口返回selector_item_id字段
https://orz.icicic.icu/api/api.php?type=rank&selected_items=ranklist_hot_sc&page=1
排行榜接口调用
curl -L "https://orz.icicic.icu/api/api.php?type=rank&selected_items=ranklist_hot_sc&page=1"
GET /api.php?type=bookid&book_id=书籍ID

书籍详情接口

根据 book_id 获取整部剧的分集列表。

参数说明
type固定为 bookid
book_id短剧或漫剧的书籍 ID
https://orz.icicic.icu/api/api.php?type=bookid&book_id=7626291792958213182
剧集详情调用
curl -L "https://orz.icicic.icu/api/api.php?type=bookid&book_id=7626291792958213182"
GET /api.php?type=video_id&video_id=视频ID&level=1080p&fast=1

单视频解析接口 需密钥

解析单个视频地址。需要提供接口密钥。

参数说明
type固定为 video_id
video_id单集视频 ID
level清晰度,如 720p1080p
fast1 启用快速模式
apiKey接口密钥(GET参数方式,固定 api- 前缀)
https://orz.icicic.icu/api/api.php?type=video_id&video_id=7625142218017229849&level=1080p&fast=1&apiKey=api-YOUR_INTERFACE_KEY
单集解析调用
curl -L "https://orz.icicic.icu/api/api.php?type=video_id&video_id=7625142218017229849&level=1080p&fast=1&apiKey=api-YOUR_INTERFACE_KEY"
把 api-YOUR_INTERFACE_KEY 换成 api- 开头的接口密钥。
GET /api.php?type=video_ids&video_ids=1,2,3&level=1080p&fast=1

批量解析接口 需密钥

批量解析多个视频地址,适合下载前预解析。需要提供接口密钥。

参数说明
type固定为 video_ids
video_ids多个 video_id,用英文逗号分隔
level清晰度
fast1 启用快速模式
apiKey接口密钥(GET参数方式,固定 api- 前缀)
https://orz.icicic.icu/api/api.php?type=video_ids&video_ids=7618120805276191806,7618120703685971006,7618120786200513598&level=1080p&fast=1&apiKey=api-YOUR_INTERFACE_KEY
批量解析调用
curl -L "https://orz.icicic.icu/api/api.php?type=video_ids&video_ids=7618120805276191806,7618120703685971006,7618120786200513598&level=1080p&fast=1&apiKey=api-YOUR_INTERFACE_KEY"
批量接口适合下载器或后端服务预解析多集。

在线试用

把任意接口地址粘进下面输入框,点击后会在新标签页直接返回 JSON。

建议先试:短剧上新、漫剧上新、AI 上新、全部时间分页、单集解析和批量解析。
已复制