/ 接口详情
反切小说
番茄小说接口，支持搜索、目录、章节内容、有声书、短剧、评论、榜单、分类、TTS 等。
接口信息
GET / POST
api.vsaa.cn/api/book/fanqie/index.php
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| action | string | 是 | 操作：search/search_page/search_tab/search_suggest/search_cue/directory/content/newfull/book_detail/multi_detail/hot_search/rank/category/homepage/bookmall_tab/new_category_front/new_category_landing/audio_detail/audio/tones/tone_info/streamtts_item/ttsinfo/book_comment/item_comment/comment_reply/comment/urge_update/recommend_book/recommend/lastpage_recommend/author_book/user_basic_info/read_progress/shelf/video_detail/video_info/shortplay/device_register/download/rpc/debug_api/debug_play/debug_raw/play/down | search |
| q | string | 否 | 搜索词（search/search_page/search_tab/search_suggest） | 烟雨楼 |
| query | string | 否 | 搜索词别名（search/search_page/search_tab/search_suggest） | 凡人修仙 |
| tab_type | string | 否 | 内容类型（search_tab/search：1综合 2听书 3书籍 4社区 5全文 6用户 8漫画 11短剧 13买书 19漫剧） | 3 |
| offset | string | 否 | 偏移量（search/search_page/search_tab/directory/comment系列/new_category_landing/author_book） | 0 |
| limit | string | 否 | 数量（search 1-30 / hot_search / search_cue 1-20 / new_category_landing / shortplay配合all用） | 10 |
| count | string | 否 | 数量（directory/comment） | 5 |
| search_id | string | 否 | 搜索会话ID（search_page/search_tab 翻页时回传上一页响应的值，URL编码） | 202610051244589836D608EDE34B1FE99E |
| passback | string | 否 | 翻页透传游标（search_page/search_tab，配合search_id使用） | 10 |
| book_id | string | 否 | 书籍ID（directory/content/newfull/book_detail/audio_detail/audio/tone_info/ttsinfo/book_comment/recommend_book/lastpage_recommend/comment/shelf等） | 6883748331202284558 |
| book_ids | string | 否 | 书籍ID列表（multi_detail，逗号分隔） | 6883748331202284558,7233717404444920893 |
| item_id | string | 否 | 章节ID（content/newfull/audio_detail/tone_info/ttsinfo/streamtts_item/item_comment/urge_update/comment） | 6883749008234250760 |
| item_ids | string | 否 | 章节ID，多个用逗号分隔（audio/content/newfull） | 6883749008234250760 |
| tone_id | string | 否 | 音色ID（audio/streamtts_item，留空自动匹配该章节可用音色） | 96 |
| req_type | string | 否 | 音频请求类型（audio，默认2） | 2 |
| sort | string | 否 | 评论排序（book_comment/item_comment：smart_hot热门 / time最新） | smart_hot |
| service_id | string | 否 | 评论类型（comment_reply：0章评 1段评 2书评 3伪书评 4新版章评 5话题评） | 2 |
| need_reply | string | 否 | 是否带回复（item_comment：1=带） | 1 |
| comment_id | string | 否 | 评论ID（comment_reply） | 6821354989014368270 |
| group_id | string | 否 | 评论组ID（comment_reply） | 7123456789012345678 |
| user_id | string | 否 | 用户ID（author_book/user_basic_info） | 104785017204 |
| book_types | string | 否 | 阅读进度书籍类型（read_progress） | 1 |
| shelf_action | string | 否 | 书架操作（shelf） | list |
| rank_type | string | 否 | 榜单类型（rank） | 1 |
| category_id | string | 否 | 分类ID（rank/new_category_landing） | 0 |
| genre_type | string | 否 | 频道类型（new_category_landing：0男生 1女生） | 0 |
| query_gender | string | 否 | 性别筛选（new_category_landing） | 0 |
| session_id | string | 否 | 书城会话ID（bookmall_tab翻页） | 7123456789012345678 |
| series_id | string | 否 | 短剧/漫剧剧集ID（video_detail） | 7664807332483697726 |
| vids | string | 否 | 视频ID列表（video_info，逗号分隔） | 7664807332483697726 |
| is_encrypt | string | 否 | 是否加密请求（video_info） | 0 |
| video_id | string | 否 | 短剧剧集ID，15-20位数字（shortplay） | 7664807332483697726 |
| chapter_id | string | 否 | 短剧章节ID，指定集（shortplay） | 7664808905486126104 |
| all | string | 否 | 遍历全部集返回每集试看URL（shortplay） | 1 |
| encrypt_did | string | 否 | 加密设备ID（shortplay） | |
| encrypt_uid | string | 否 | 加密用户ID（shortplay） | |
| url | string | 否 | 媒体URL（play/down，来自audio/content返回） | https://... |
| cek | string | 否 | 解密key（play/down） | efcf7dd24c9bbe904af478c4ccfe602f |
| filename | string | 否 | 保存文件名（down） | ch1.mp3 |
| batch_size | string | 否 | 批量下载并发数（download） | 3 |
| max_chapters | string | 否 | 最大章节数（download） | 10 |
| output_dir | string | 否 | 输出目录（download） | ./downloads |
| rotate | string | 否 | 强制换新设备（device_register） | 1 |
| register | string | 否 | 0=跳过registerkey会话注册（device_register） | 0 |
| applog | string | 否 | 1=执行AppLog设备注册（device_register，通常返回device_id:0） | 1 |
| platform | string | 否 | 设备平台（device_register） | android |
| path | string | 否 | API路径（rpc/debug_api，须以/reading/开头） | /reading/bookapi/search/page/v:version/ |
| method | string | 否 | 请求方法（debug_api：GET/POST） | GET |
| body | string | 否 | POST请求体JSON（debug_api） | {} |
| sentence_template | string | 否 | 句子模板（tts） | |
| task_id | string | 否 | TTS任务ID（tts/streamtts_item内部轮询用） | |
| is_exempt | string | 否 | 豁免标识（tone_info） | 0 |
| timeout | string | 否 | 上游请求超时秒数（通用，默认30） | 30 |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "action",
"type": "string",
"required": true,
"description": "操作：search/search_page/search_tab/search_suggest/search_cue/directory/content/newfull/book_detail/multi_detail/hot_search/rank/category/homepage/bookmall_tab/new_category_front/new_category_landing/audio_detail/audio/tones/tone_info/streamtts_item/ttsinfo/book_comment/item_comment/comment_reply/comment/urge_update/recommend_book/recommend/lastpage_recommend/author_book/user_basic_info/read_progress/shelf/video_detail/video_info/shortplay/device_register/download/rpc/debug_api/debug_play/debug_raw/play/down",
"example": "search"
},
{
"name": "q",
"type": "string",
"required": false,
"description": "搜索词（search/search_page/search_tab/search_suggest）",
"example": "烟雨楼"
},
{
"name": "query",
"type": "string",
"required": false,
"description": "搜索词别名（search/search_page/search_tab/search_suggest）",
"example": "凡人修仙"
},
{
"name": "tab_type",
"type": "string",
"required": false,
"description": "内容类型（search_tab/search：1综合 2听书 3书籍 4社区 5全文 6用户 8漫画 11短剧 13买书 19漫剧）",
"example": "3"
},
{
"name": "offset",
"type": "string",
"required": false,
"description": "偏移量（search/search_page/search_tab/directory/comment系列/new_category_landing/author_book）",
"example": "0"
},
{
"name": "limit",
"type": "string",
"required": false,
"description": "数量（search 1-30 / hot_search / search_cue 1-20 / new_category_landing / shortplay配合all用）",
"example": "10"
},
{
"name": "count",
"type": "string",
"required": false,
"description": "数量（directory/comment）",
"example": "5"
},
{
"name": "search_id",
"type": "string",
"required": false,
"description": "搜索会话ID（search_page/search_tab 翻页时回传上一页响应的值，URL编码）",
"example": "202610051244589836D608EDE34B1FE99E"
},
{
"name": "passback",
"type": "string",
"required": false,
"description": "翻页透传游标（search_page/search_tab，配合search_id使用）",
"example": "10"
},
{
"name": "book_id",
"type": "string",
"required": false,
"description": "书籍ID（directory/content/newfull/book_detail/audio_detail/audio/tone_info/ttsinfo/book_comment/recommend_book/lastpage_recommend/comment/shelf等）",
"example": "6883748331202284558"
},
{
"name": "book_ids",
"type": "string",
"required": false,
"description": "书籍ID列表（multi_detail，逗号分隔）",
"example": "6883748331202284558,7233717404444920893"
},
{
"name": "item_id",
"type": "string",
"required": false,
"description": "章节ID（content/newfull/audio_detail/tone_info/ttsinfo/streamtts_item/item_comment/urge_update/comment）",
"example": "6883749008234250760"
},
{
"name": "item_ids",
"type": "string",
"required": false,
"description": "章节ID，多个用逗号分隔（audio/content/newfull）",
"example": "6883749008234250760"
},
{
"name": "tone_id",
"type": "string",
"required": false,
"description": "音色ID（audio/streamtts_item，留空自动匹配该章节可用音色）",
"example": "96"
},
{
"name": "req_type",
"type": "string",
"required": false,
"description": "音频请求类型（audio，默认2）",
"example": "2"
},
{
"name": "sort",
"type": "string",
"required": false,
"description": "评论排序（book_comment/item_comment：smart_hot热门 / time最新）",
"example": "smart_hot"
},
{
"name": "service_id",
"type": "string",
"required": false,
"description": "评论类型（comment_reply：0章评 1段评 2书评 3伪书评 4新版章评 5话题评）",
"example": "2"
},
{
"name": "need_reply",
"type": "string",
"required": false,
"description": "是否带回复（item_comment：1=带）",
"example": "1"
},
{
"name": "comment_id",
"type": "string",
"required": false,
"description": "评论ID（comment_reply）",
"example": "6821354989014368270"
},
{
"name": "group_id",
"type": "string",
"required": false,
"description": "评论组ID（comment_reply）",
"example": "7123456789012345678"
},
{
"name": "user_id",
"type": "string",
"required": false,
"description": "用户ID（author_book/user_basic_info）",
"example": "104785017204"
},
{
"name": "book_types",
"type": "string",
"required": false,
"description": "阅读进度书籍类型（read_progress）",
"example": "1"
},
{
"name": "shelf_action",
"type": "string",
"required": false,
"description": "书架操作（shelf）",
"example": "list"
},
{
"name": "rank_type",
"type": "string",
"required": false,
"description": "榜单类型（rank）",
"example": "1"
},
{
"name": "category_id",
"type": "string",
"required": false,
"description": "分类ID（rank/new_category_landing）",
"example": "0"
},
{
"name": "genre_type",
"type": "string",
"required": false,
"description": "频道类型（new_category_landing：0男生 1女生）",
"example": "0"
},
{
"name": "query_gender",
"type": "string",
"required": false,
"description": "性别筛选（new_category_landing）",
"example": "0"
},
{
"name": "session_id",
"type": "string",
"required": false,
"description": "书城会话ID（bookmall_tab翻页）",
"example": "7123456789012345678"
},
{
"name": "series_id",
"type": "string",
"required": false,
"description": "短剧/漫剧剧集ID（video_detail）",
"example": "7664807332483697726"
},
{
"name": "vids",
"type": "string",
"required": false,
"description": "视频ID列表（video_info，逗号分隔）",
"example": "7664807332483697726"
},
{
"name": "is_encrypt",
"type": "string",
"required": false,
"description": "是否加密请求（video_info）",
"example": "0"
},
{
"name": "video_id",
"type": "string",
"required": false,
"description": "短剧剧集ID，15-20位数字（shortplay）",
"example": "7664807332483697726"
},
{
"name": "chapter_id",
"type": "string",
"required": false,
"description": "短剧章节ID，指定集（shortplay）",
"example": "7664808905486126104"
},
{
"name": "all",
"type": "string",
"required": false,
"description": "遍历全部集返回每集试看URL（shortplay）",
"example": "1"
},
{
"name": "encrypt_did",
"type": "string",
"required": false,
"description": "加密设备ID（shortplay）",
"example": ""
},
{
"name": "encrypt_uid",
"type": "string",
"required": false,
"description": "加密用户ID（shortplay）",
"example": ""
},
{
"name": "url",
"type": "string",
"required": false,
"description": "媒体URL（play/down，来自audio/content返回）",
"example": "https://..."
},
{
"name": "cek",
"type": "string",
"required": false,
"description": "解密key（play/down）",
"example": "efcf7dd24c9bbe904af478c4ccfe602f"
},
{
"name": "filename",
"type": "string",
"required": false,
"description": "保存文件名（down）",
"example": "ch1.mp3"
},
{
"name": "batch_size",
"type": "string",
"required": false,
"description": "批量下载并发数（download）",
"example": "3"
},
{
"name": "max_chapters",
"type": "string",
"required": false,
"description": "最大章节数（download）",
"example": "10"
},
{
"name": "output_dir",
"type": "string",
"required": false,
"description": "输出目录（download）",
"example": "./downloads"
},
{
"name": "rotate",
"type": "string",
"required": false,
"description": "强制换新设备（device_register）",
"example": "1"
},
{
"name": "register",
"type": "string",
"required": false,
"description": "0=跳过registerkey会话注册（device_register）",
"example": "0"
},
{
"name": "applog",
"type": "string",
"required": false,
"description": "1=执行AppLog设备注册（device_register，通常返回device_id:0）",
"example": "1"
},
{
"name": "platform",
"type": "string",
"required": false,
"description": "设备平台（device_register）",
"example": "android"
},
{
"name": "path",
"type": "string",
"required": false,
"description": "API路径（rpc/debug_api，须以/reading/开头）",
"example": "/reading/bookapi/search/page/v:version/"
},
{
"name": "method",
"type": "string",
"required": false,
"description": "请求方法（debug_api：GET/POST）",
"example": "GET"
},
{
"name": "body",
"type": "string",
"required": false,
"description": "POST请求体JSON（debug_api）",
"example": "{}"
},
{
"name": "sentence_template",
"type": "string",
"required": false,
"description": "句子模板（tts）",
"example": ""
},
{
"name": "task_id",
"type": "string",
"required": false,
"description": "TTS任务ID（tts/streamtts_item内部轮询用）",
"example": ""
},
{
"name": "is_exempt",
"type": "string",
"required": false,
"description": "豁免标识（tone_info）",
"example": "0"
},
{
"name": "timeout",
"type": "string",
"required": false,
"description": "上游请求超时秒数（通用，默认30）",
"example": "30"
}
]
{
"openapi": "3.1.1",
"info": {
"title": "反切小说",
"description": "番茄小说接口，支持搜索、目录、章节内容、有声书、短剧、评论、榜单、分类、TTS 等。",
"version": "1.0.0"
},
"paths": {
"\/api\/book\/fanqie\/index.php": {
"get": {
"summary": "反切小说",
"description": "番茄小说接口，支持搜索、目录、章节内容、有声书、短剧、评论、榜单、分类、TTS 等。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "action",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "search"
},
"description": "操作：search\/search_page\/search_tab\/search_suggest\/search_cue\/directory\/content\/newfull\/book_detail\/multi_detail\/hot_search\/rank\/category\/homepage\/bookmall_tab\/new_category_front\/new_category_landing\/audio_detail\/audio\/tones\/tone_info\/streamtts_item\/ttsinfo\/book_comment\/item_comment\/comment_reply\/comment\/urge_update\/recommend_book\/recommend\/lastpage_recommend\/author_book\/user_basic_info\/read_progress\/shelf\/video_detail\/video_info\/shortplay\/device_register\/download\/rpc\/debug_api\/debug_play\/debug_raw\/play\/down"
},
{
"name": "q",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "烟雨楼"
},
"description": "搜索词（search\/search_page\/search_tab\/search_suggest）"
},
{
"name": "query",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "凡人修仙"
},
"description": "搜索词别名（search\/search_page\/search_tab\/search_suggest）"
},
{
"name": "tab_type",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "3"
},
"description": "内容类型（search_tab\/search：1综合 2听书 3书籍 4社区 5全文 6用户 8漫画 11短剧 13买书 19漫剧）"
},
{
"name": "offset",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "偏移量（search\/search_page\/search_tab\/directory\/comment系列\/new_category_landing\/author_book）"
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "10"
},
"description": "数量（search 1-30 \/ hot_search \/ search_cue 1-20 \/ new_category_landing \/ shortplay配合all用）"
},
{
"name": "count",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "5"
},
"description": "数量（directory\/comment）"
},
{
"name": "search_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "202610051244589836D608EDE34B1FE99E"
},
"description": "搜索会话ID（search_page\/search_tab 翻页时回传上一页响应的值，URL编码）"
},
{
"name": "passback",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "10"
},
"description": "翻页透传游标（search_page\/search_tab，配合search_id使用）"
},
{
"name": "book_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "6883748331202284558"
},
"description": "书籍ID（directory\/content\/newfull\/book_detail\/audio_detail\/audio\/tone_info\/ttsinfo\/book_comment\/recommend_book\/lastpage_recommend\/comment\/shelf等）"
},
{
"name": "book_ids",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "6883748331202284558,7233717404444920893"
},
"description": "书籍ID列表（multi_detail，逗号分隔）"
},
{
"name": "item_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "6883749008234250760"
},
"description": "章节ID（content\/newfull\/audio_detail\/tone_info\/ttsinfo\/streamtts_item\/item_comment\/urge_update\/comment）"
},
{
"name": "item_ids",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "6883749008234250760"
},
"description": "章节ID，多个用逗号分隔（audio\/content\/newfull）"
},
{
"name": "tone_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "96"
},
"description": "音色ID（audio\/streamtts_item，留空自动匹配该章节可用音色）"
},
{
"name": "req_type",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "2"
},
"description": "音频请求类型（audio，默认2）"
},
{
"name": "sort",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "smart_hot"
},
"description": "评论排序（book_comment\/item_comment：smart_hot热门 \/ time最新）"
},
{
"name": "service_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "2"
},
"description": "评论类型（comment_reply：0章评 1段评 2书评 3伪书评 4新版章评 5话题评）"
},
{
"name": "need_reply",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "是否带回复（item_comment：1=带）"
},
{
"name": "comment_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "6821354989014368270"
},
"description": "评论ID（comment_reply）"
},
{
"name": "group_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7123456789012345678"
},
"description": "评论组ID（comment_reply）"
},
{
"name": "user_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "104785017204"
},
"description": "用户ID（author_book\/user_basic_info）"
},
{
"name": "book_types",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "阅读进度书籍类型（read_progress）"
},
{
"name": "shelf_action",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "list"
},
"description": "书架操作（shelf）"
},
{
"name": "rank_type",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "榜单类型（rank）"
},
{
"name": "category_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "分类ID（rank\/new_category_landing）"
},
{
"name": "genre_type",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "频道类型（new_category_landing：0男生 1女生）"
},
{
"name": "query_gender",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "性别筛选（new_category_landing）"
},
{
"name": "session_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7123456789012345678"
},
"description": "书城会话ID（bookmall_tab翻页）"
},
{
"name": "series_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7664807332483697726"
},
"description": "短剧\/漫剧剧集ID（video_detail）"
},
{
"name": "vids",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7664807332483697726"
},
"description": "视频ID列表（video_info，逗号分隔）"
},
{
"name": "is_encrypt",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "是否加密请求（video_info）"
},
{
"name": "video_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7664807332483697726"
},
"description": "短剧剧集ID，15-20位数字（shortplay）"
},
{
"name": "chapter_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7664808905486126104"
},
"description": "短剧章节ID，指定集（shortplay）"
},
{
"name": "all",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "遍历全部集返回每集试看URL（shortplay）"
},
{
"name": "encrypt_did",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "加密设备ID（shortplay）"
},
{
"name": "encrypt_uid",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "加密用户ID（shortplay）"
},
{
"name": "url",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "https:\/\/..."
},
"description": "媒体URL（play\/down，来自audio\/content返回）"
},
{
"name": "cek",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "efcf7dd24c9bbe904af478c4ccfe602f"
},
"description": "解密key（play\/down）"
},
{
"name": "filename",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "ch1.mp3"
},
"description": "保存文件名（down）"
},
{
"name": "batch_size",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "3"
},
"description": "批量下载并发数（download）"
},
{
"name": "max_chapters",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "10"
},
"description": "最大章节数（download）"
},
{
"name": "output_dir",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": ".\/downloads"
},
"description": "输出目录（download）"
},
{
"name": "rotate",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "强制换新设备（device_register）"
},
{
"name": "register",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "0=跳过registerkey会话注册（device_register）"
},
{
"name": "applog",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "1=执行AppLog设备注册（device_register，通常返回device_id:0）"
},
{
"name": "platform",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "android"
},
"description": "设备平台（device_register）"
},
{
"name": "path",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "\/reading\/bookapi\/search\/page\/v:version\/"
},
"description": "API路径（rpc\/debug_api，须以\/reading\/开头）"
},
{
"name": "method",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "GET"
},
"description": "请求方法（debug_api：GET\/POST）"
},
{
"name": "body",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "{}"
},
"description": "POST请求体JSON（debug_api）"
},
{
"name": "sentence_template",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "句子模板（tts）"
},
{
"name": "task_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "TTS任务ID（tts\/streamtts_item内部轮询用）"
},
{
"name": "is_exempt",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "豁免标识（tone_info）"
},
{
"name": "timeout",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "30"
},
"description": "上游请求超时秒数（通用，默认30）"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "反切小说",
"description": "番茄小说接口，支持搜索、目录、章节内容、有声书、短剧、评论、榜单、分类、TTS 等。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "action",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "search"
},
"description": "操作：search\/search_page\/search_tab\/search_suggest\/search_cue\/directory\/content\/newfull\/book_detail\/multi_detail\/hot_search\/rank\/category\/homepage\/bookmall_tab\/new_category_front\/new_category_landing\/audio_detail\/audio\/tones\/tone_info\/streamtts_item\/ttsinfo\/book_comment\/item_comment\/comment_reply\/comment\/urge_update\/recommend_book\/recommend\/lastpage_recommend\/author_book\/user_basic_info\/read_progress\/shelf\/video_detail\/video_info\/shortplay\/device_register\/download\/rpc\/debug_api\/debug_play\/debug_raw\/play\/down"
},
{
"name": "q",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "烟雨楼"
},
"description": "搜索词（search\/search_page\/search_tab\/search_suggest）"
},
{
"name": "query",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "凡人修仙"
},
"description": "搜索词别名（search\/search_page\/search_tab\/search_suggest）"
},
{
"name": "tab_type",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "3"
},
"description": "内容类型（search_tab\/search：1综合 2听书 3书籍 4社区 5全文 6用户 8漫画 11短剧 13买书 19漫剧）"
},
{
"name": "offset",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "偏移量（search\/search_page\/search_tab\/directory\/comment系列\/new_category_landing\/author_book）"
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "10"
},
"description": "数量（search 1-30 \/ hot_search \/ search_cue 1-20 \/ new_category_landing \/ shortplay配合all用）"
},
{
"name": "count",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "5"
},
"description": "数量（directory\/comment）"
},
{
"name": "search_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "202610051244589836D608EDE34B1FE99E"
},
"description": "搜索会话ID（search_page\/search_tab 翻页时回传上一页响应的值，URL编码）"
},
{
"name": "passback",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "10"
},
"description": "翻页透传游标（search_page\/search_tab，配合search_id使用）"
},
{
"name": "book_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "6883748331202284558"
},
"description": "书籍ID（directory\/content\/newfull\/book_detail\/audio_detail\/audio\/tone_info\/ttsinfo\/book_comment\/recommend_book\/lastpage_recommend\/comment\/shelf等）"
},
{
"name": "book_ids",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "6883748331202284558,7233717404444920893"
},
"description": "书籍ID列表（multi_detail，逗号分隔）"
},
{
"name": "item_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "6883749008234250760"
},
"description": "章节ID（content\/newfull\/audio_detail\/tone_info\/ttsinfo\/streamtts_item\/item_comment\/urge_update\/comment）"
},
{
"name": "item_ids",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "6883749008234250760"
},
"description": "章节ID，多个用逗号分隔（audio\/content\/newfull）"
},
{
"name": "tone_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "96"
},
"description": "音色ID（audio\/streamtts_item，留空自动匹配该章节可用音色）"
},
{
"name": "req_type",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "2"
},
"description": "音频请求类型（audio，默认2）"
},
{
"name": "sort",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "smart_hot"
},
"description": "评论排序（book_comment\/item_comment：smart_hot热门 \/ time最新）"
},
{
"name": "service_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "2"
},
"description": "评论类型（comment_reply：0章评 1段评 2书评 3伪书评 4新版章评 5话题评）"
},
{
"name": "need_reply",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "是否带回复（item_comment：1=带）"
},
{
"name": "comment_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "6821354989014368270"
},
"description": "评论ID（comment_reply）"
},
{
"name": "group_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7123456789012345678"
},
"description": "评论组ID（comment_reply）"
},
{
"name": "user_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "104785017204"
},
"description": "用户ID（author_book\/user_basic_info）"
},
{
"name": "book_types",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "阅读进度书籍类型（read_progress）"
},
{
"name": "shelf_action",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "list"
},
"description": "书架操作（shelf）"
},
{
"name": "rank_type",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "榜单类型（rank）"
},
{
"name": "category_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "分类ID（rank\/new_category_landing）"
},
{
"name": "genre_type",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "频道类型（new_category_landing：0男生 1女生）"
},
{
"name": "query_gender",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "性别筛选（new_category_landing）"
},
{
"name": "session_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7123456789012345678"
},
"description": "书城会话ID（bookmall_tab翻页）"
},
{
"name": "series_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7664807332483697726"
},
"description": "短剧\/漫剧剧集ID（video_detail）"
},
{
"name": "vids",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7664807332483697726"
},
"description": "视频ID列表（video_info，逗号分隔）"
},
{
"name": "is_encrypt",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "是否加密请求（video_info）"
},
{
"name": "video_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7664807332483697726"
},
"description": "短剧剧集ID，15-20位数字（shortplay）"
},
{
"name": "chapter_id",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "7664808905486126104"
},
"description": "短剧章节ID，指定集（shortplay）"
},
{
"name": "all",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "遍历全部集返回每集试看URL（shortplay）"
},
{
"name": "encrypt_did",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "加密设备ID（shortplay）"
},
{
"name": "encrypt_uid",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "加密用户ID（shortplay）"
},
{
"name": "url",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "https:\/\/..."
},
"description": "媒体URL（play\/down，来自audio\/content返回）"
},
{
"name": "cek",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "efcf7dd24c9bbe904af478c4ccfe602f"
},
"description": "解密key（play\/down）"
},
{
"name": "filename",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "ch1.mp3"
},
"description": "保存文件名（down）"
},
{
"name": "batch_size",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "3"
},
"description": "批量下载并发数（download）"
},
{
"name": "max_chapters",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "10"
},
"description": "最大章节数（download）"
},
{
"name": "output_dir",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": ".\/downloads"
},
"description": "输出目录（download）"
},
{
"name": "rotate",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "强制换新设备（device_register）"
},
{
"name": "register",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "0=跳过registerkey会话注册（device_register）"
},
{
"name": "applog",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "1"
},
"description": "1=执行AppLog设备注册（device_register，通常返回device_id:0）"
},
{
"name": "platform",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "android"
},
"description": "设备平台（device_register）"
},
{
"name": "path",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "\/reading\/bookapi\/search\/page\/v:version\/"
},
"description": "API路径（rpc\/debug_api，须以\/reading\/开头）"
},
{
"name": "method",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "GET"
},
"description": "请求方法（debug_api：GET\/POST）"
},
{
"name": "body",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "{}"
},
"description": "POST请求体JSON（debug_api）"
},
{
"name": "sentence_template",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "句子模板（tts）"
},
{
"name": "task_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "TTS任务ID（tts\/streamtts_item内部轮询用）"
},
{
"name": "is_exempt",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "0"
},
"description": "豁免标识（tone_info）"
},
{
"name": "timeout",
"in": "query",
"required": false,
"schema": {
"type": "string",
"example": "30"
},
"description": "上游请求超时秒数（通用，默认30）"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https:\/\/api.vsaa.cn",
"description": "当前访问入口（https）"
}
]
}
返回示例
{
"code": 0,
"data": {
"query": "烟雨楼",
"limit": 10,
"results": [
{
"book_id": "6883748331202284558",
"title": "烟雨楼",
"author": "一夕烟雨",
"category": "传统玄幻",
"chapter_count": 557,
"score": "9.6"
},
{
"book_id": "7163517349398580238",
"title": "烟雨楼",
"author": "一夕烟雨（主播：醋布,译鸣,帝繁音,Yu_荦棋）",
"category": "奇幻仙侠",
"chapter_count": 1099,
"score": "8.0"
},
{
"book_id": "7180193154753104935",
"title": "烟雨楼",
"author": "番茄漫画",
"category": "玄幻",
"chapter_count": 112,
"score": "9.5"
},
{
"book_id": "7592529628778990617",
"title": "烟雨楼",
"author": "绝隐",
"category": "玄幻言情",
"chapter_count": 54,
"score": "0"
},
{
"book_id": "6964287029689453604",
"title": "凡人修仙记",
"author": "梧桐悠悠",
"category": "传统玄幻",
"chapter_count": 74,
"score": "8.9"
},
{
"book_id": "7239549183726898213",
"title": "惊鸿",
"author": "一夕烟雨（主播：番茄畅听）",
"category": "奇幻仙侠",
"chapter_count": 1766,
"score": "8.0"
},
{
"book_id": "7471900860004434494",
"title": "烟雨楼-",
"author": "咕噜呆帝",
"category": "古代言情",
"chapter_count": 1,
"score": "0"
},
{
"book_id": "6542710247130139655",
"title": "绝世武神",
"author": "净无痕",
"category": "传统玄幻",
"chapter_count": 2500,
"score": "9.1"
}
]
}
}
详细文档
番茄小说
接口说明
番茄小说接口提供小说搜索、章节目录获取、章节内容阅读及有声音频查询能力，面向需要接入网文数据的服务与开发者。调用方通过 Query 参数传入密钥完成鉴权后，按需选择 search、directory、content、audio 操作即可获取对应数据。
调用地址
https://api2.vsaa.cn/api/book/fanqie/index.php
请求方式
支持 GET 与 POST 两种请求方式。
鉴权说明
本接口为收费接口，调用时须在请求参数中附带接口密钥。密钥参数名为 key，通过 Query 方式传递，例如：?key=YOUR_API_KEY。未提供有效密钥或密钥无效时，接口将拒绝响应。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | string | 是 | 接口调用密钥 |
| action | string | 是 | 操作类型，见下表 |
| query | string | 否 | 搜索词，action=search 时必填 |
| limit | string | 否 | 返回数量，默认 10 |
| book_id | string | 否 | 书籍 ID，获取目录或内容时使用 |
| item_ids | string | 否 | 章节 ID，获取内容时使用 |
| tone | string | 否 | 音效风格，action=audio 时使用 |
action 参数取值说明
| 取值 | 说明 |
|---|---|
| search | 搜索小说 |
| directory | 获取小说目录 |
| content | 获取章节内容 |
| audio | 获取音频播放地址 |
成功响应示例
{
"code": 0,
"data": {
"query": "烟雨楼",
"limit": 10,
"results": [
{
"book_id": "6883748331202284558",
"title": "烟雨楼",
"author": "一夕烟雨",
"category": "传统玄幻",
"chapter_count": 557,
"score": "9.6"
},
{
"book_id": "7163517349398580238",
"title": "烟雨楼",
"author": "一夕烟雨（主播：醋布,译鸣,帝繁音,Yu_荦棋）",
"category": "奇幻仙侠",
"chapter_count": 1099,
"score": "8.0"
},
{
"book_id": "7180193154753104935",
"title": "烟雨楼",
"author": "番茄漫画",
"category": "玄幻",
"chapter_count": 112,
"score": "9.5"
},
{
"book_id": "7592529628778990617",
"title": "烟雨楼",
"author": "绝隐",
"category": "玄幻言情",
"chapter_count": 54,
"score": "0"
},
{
"book_id": "6964287029689453604",
"title": "凡人修仙记",
"author": "梧桐悠悠",
"category": "传统玄幻",
"chapter_count": 74,
"score": "8.9"
},
{
"book_id": "7239549183726898213",
"title": "惊鸿",
"author": "一夕烟雨（主播：番茄畅听）",
"category": "奇幻仙侠",
"chapter_count": 1766,
"score": "8.0"
},
{
"book_id": "7471900860004434494",
"title": "烟雨楼-",
"author": "咕噜呆帝",
"category": "古代言情",
"chapter_count": 1,
"score": "0"
},
{
"book_id": "6542710247130139655",
"title": "绝世武神",
"author": "净无痕",
"category": "传统玄幻",
"chapter_count": 2500,
"score": "9.1"
}
]
}
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码，0 表示成功 |
| data.query | string | 本次搜索关键词 |
| data.limit | integer | 本次请求返回数量 |
| data.results | array | 结果列表 |
| data.results[].book_id | string | 书籍唯一标识 |
| data.results[].title | string | 书名 |
| data.results[].author | string | 作者名，含主播信息时一并返回 |
| data.results[].category | string | 作品分类，如「传统玄幻」「奇幻仙侠」等 |
| data.results[].chapter_count | integer | 总章节数 |
| data.results[].score | string | 作品评分（0–10 分，字符串格式） |
错误响应示例
{
"code": 1,
"msg": "未提供调用密钥",
"errcode": 11001
}业务错误码说明
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁（QPM 限制） |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
调用示例
终端 curl（bash）
curl -X GET "https://api2.vsaa.cn/api/book/fanqie/index.php?key=YOUR_KEY&action=search&query=烟雨楼&limit=10"PHP
// PHP
$url = 'https://api2.vsaa.cn/api/book/fanqie/index.php';
$query = http_build_query([
'key' => 'YOUR_KEY',
'action' => 'search',
'query' => '烟雨楼',
'limit' => '10'
]);
$response = file_get_contents($url . '?' . $query);
echo $response;注意事项
- 密钥通过 Query 参数传递，请妥善保管，切勿直接暴露在前端代码或公开页面中。
- 接口调用地址为
https://api2.vsaa.cn/api/book/fanqie/index.php，建议使用 HTTPS 协议以确保传输安全。 action参数取值仅限search、directory、content、audio四种，传入非法值将导致请求失败。- 搜索操作（
action=search）时需提供query参数；章节列表（directory）、正文获取（content）和音频获取（audio）需分别传入正确的book_id或item_ids。 - 音频接口（
action=audio）支持tone参数指定音效，如「邻家妹妹音」，不传则使用默认音色。 - 接口频率限制为每分钟约 120 次，超出限制将返回错误码，请合理控制调用节奏。
- 本接口为收费服务，请确保账户余额充足后再进行调用。
limit参数用于控制返回数量，建议根据实际需求设置合理范围，避免返回数据过大影响性能。
快速上手
curl "https://api2.vsaa.cn/api/book/fanqie/index.php?key=YOUR_API_KEY&action=search&query=烟雨楼&limit=10"在线测试
请求地址
api.vsaa.cn/api/book/fanqie/index.php
Method
参数
Response
// 结果将在此处显示
接口反馈
免责声明
免责声明
欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。
最后更新日期：2026年10月6日
