DK Social API Docs
公开 API 文档
本页公开可读,供智能体和开发者理解 DK 工具的 REST API、MCP 接入、API Key、分页、调用日志和积分扣减方式。
当前公开启用工具共 30 个,覆盖 XHS、DY、SPH、KS 和 DOWNLOAD。接口新增、开放、关闭、参数、返回字段、扣费、分页或错误码变化后必须同步更新本文档。
当前已开放工具
| 工具名 | 平台 | 用途 | 主要参数 | 积分 |
|---|---|---|---|---|
| xhs_search_notes | XHS | 关键词搜索内容列表,返回标题、作者、封面、互动数据和可打开链接。 | keyword, limit, page | 20/页 |
| xhs_get_note_detail | XHS | 根据链接或内容 ID 查询详情,返回标题、正文、媒体、作者和互动数据。 | note_url 或 url | 15/次 |
| xhs_extract_note_token | XHS | 根据分享文本或链接做留存预检测,提取内容 ID 和访问 token。 | share_text, note_url 或 url | 3/次 |
| xhs_get_author_profile | XHS | 查询作者公开主页资料,返回昵称、头像、简介和公开统计信息。 | author_id | 15/次 |
| xhs_get_author_notes | XHS | 查询作者主页公开内容列表,返回作品、封面、标题、互动数据和下一页游标。 | author_id, cursor, limit | 20/页 |
| xhs_get_note_comments | XHS | 查询公开评论列表,返回评论内容、时间、点赞数和分页信息。 | note_id, limit, lastCursor, pages | 20/页 |
| xhs_get_primary_comments | XHS | 获取一级公开评论,返回评论内容、时间、点赞数和分页信息。 | note_id, limit, lastCursor, pages | 20/页 |
| xhs_get_primary_secondary_comments | XHS | 获取一级公开评论和二级公开评论,返回层级关系、评论内容和分页信息。 | note_id, limit, lastCursor, pages, subCommentPages | 20/页 |
| dy_search_videos | DY | 关键词搜索内容列表,返回标题/描述、作者、封面、互动数据和下一页游标。 | keyword, limit, cursor, search_id | 20/页 |
| dy_get_hot_search_list | DY | 查询热搜榜单,返回榜单词、热度和趋势信息。 | 无 | 20/页 |
| dy_get_hot_video_list | DY | 查询热门内容榜单,返回热门内容、作者和互动数据。 | 无 | 20/页 |
| dy_get_video_detail | DY | 根据视频 ID 查询内容详情,返回标题/描述、作者、封面、互动数据和可打开链接。 | video_id | 10/次 |
| dy_get_video_by_share_url | DY | 根据分享链接解析内容详情,返回标题/描述、作者、封面、互动数据和可打开链接。 | share_url | 10/次 |
| dy_get_author_profile | DY | 查询作者公开主页资料,返回昵称、头像、简介和公开统计信息。 | author_id | 10/次 |
| dy_get_author_videos | DY | 查询作者主页公开视频列表,返回作品、封面、描述、互动数据和下一页游标。 | author_id, limit, cursor | 20/页 |
| dy_get_video_comments | DY | 查询公开评论列表,返回评论内容、时间、点赞数和分页信息。 | video_id, limit, cursor | 20/页 |
| sph_search_default | SPH | 关键词搜索默认排序内容列表,返回标题、作者、封面和互动数据。 | keyword, session_buffer | 20/页 |
| sph_search_latest | SPH | 关键词搜索最新排序内容列表,返回标题、作者、封面和互动数据。 | keyword, session_buffer | 20/页 |
| sph_search_ordinary | SPH | 关键词搜索综合排序内容列表,返回标题、作者、封面和互动数据。 | keyword, session_buffer | 20/页 |
| sph_get_video_detail | SPH | 根据内容 ID 查询详情,返回标题、作者、封面、互动数据和可打开链接。 | video_id, export_id | 10/次 |
| sph_get_video_by_share_url | SPH | 根据分享链接解析内容详情,返回标题、作者、封面、互动数据和可打开链接。 | share_url | 10/次 |
| sph_get_comments | SPH | 查询公开评论列表,返回评论内容、时间、点赞数和分页信息。 | video_id, lastBuffer, comment_id | 20/页 |
| sph_get_author_homepage | SPH | 查询主页公开内容,返回主页作品列表、作者资料和下一页游标。 | author_id, lastBuffer | 20/页 |
| ks_search_videos | KS | 关键词搜索视频内容,返回标题/描述、作者、封面、互动数据和下一页游标。 | keyword, pcursor | 20/页 |
| ks_search_comprehensive | KS | 关键词综合搜索内容,返回标题/描述、作者、封面、互动数据和下一页游标。 | keyword, pcursor | 20/页 |
| ks_get_video_detail | KS | 根据内容 ID 查询详情,返回标题/描述、作者、封面、互动数据和可打开链接。 | photo_id 或 video_id | 10/次 |
| ks_get_video_by_url | KS | 根据分享链接解析内容详情,返回标题/描述、作者、封面、互动数据和可打开链接。 | share_url | 10/次 |
| ks_get_video_comments | KS | 查询公开评论列表,返回评论内容、时间、点赞数和分页信息。 | photo_id 或 video_id, pcursor | 20/页 |
| ks_get_author_videos | KS | 查询作者主页公开视频列表,返回作品、封面、描述、互动数据和下一页游标。 | author_id, pcursor | 20/页 |
| video_download_parse | DOWNLOAD | 根据公开视频链接解析标题、封面和可用媒体地址。 | url | 20/次 |
标准返回字段
DK 会在不改变原始字段的基础上补充这些标准字段,方便前端和智能体消费。字段只有在源数据返回时才会出现;不会用 0 或空字符串假造缺失字段。普通公开工具不返回敏感账号标识。