Claw API 接口文档

基础信息

Base URL: https://api.thesophon.cn/
认证方式: API Key（通过请求体中的 apiKey 字段）
Content-Type: application/json

1. 视频解析接口

接口描述

解析抖音或小红书视频信息，提取视频元数据、文案、作者信息等。

请求信息

请求方法: POST

请求路径: /api/v1/claw/account/parse

支持平台:

抖音（普通链接、v.douyin.com 分享链接）
小红书（xhslink.com 分享链接、包含 xiaohongshu 的链接）

请求参数

字段名	类型	必填	说明
apiKey	String	是	用户 API 密钥，用于身份验证和积分扣除
url	String	是	视频链接地址（支持抖音和小红书）

请求示例:


{
  "apiKey": "your_api_key_here",
  "url": "https://v.douyin.com/xxxxx/"
}

响应参数

成功响应 (success: true):

字段名	类型	说明
success	Boolean	请求状态，true 表示成功
cost	Integer	本次请求消耗的积分数量
quota	Integer	用户剩余积分数量
data	Object	视频详细信息对象
message	String	成功时为空

data 字段说明:

data 是一个对象，包含视频的所有详细信息：

字段名	类型	说明
title	String	视频标题
keywords	Array	从视频描述中提取的话题标签（hashtag）
summary	String	视频描述/文案
like_count	Long	点赞数
comment_count	Long	评论数
collect_count	Long	收藏数
share_count	Long	分享数
author_name	String	作者昵称
publish_time	String	发布时间（格式化后的字符串）
audio_url	String	音频文件 URL
video_url	String	视频文件 URL
transcript	String	视频语音转文字结果（AI 识别的文案）
cover_url	String	视频封面图片 URL
follower_count	Long	作者粉丝数

抖音视频响应示例:


xxxxxxxxxx
{
  "success": true,
  "cost": 5,
  "quota": 995,
  "data": {
    "title": "精彩视频分享",
    "keywords": ["#美食", "#生活"],
    "summary": "今天给大家分享一道美食",
    "like_count": 1234,
    "comment_count": 56,
    "collect_count": 78,
    "share_count": 23,
    "author_name": "美食达人",
    "publish_time": "2025-03-22 10:30:00",
    "audio_url": "https://example.com/audio.mp3",
    "video_url": "https://example.com/video.mp4",
    "transcript": "今天给大家分享一道美食",
    "cover_url": "https://example.com/cover.jpg",
    "follower_count": 50000
  },
  "message": ""
}

失败响应 (success: false):

字段名	类型	说明
success	Boolean	请求状态，false 表示失败
message	String	错误信息描述

失败示例:


xxxxxxxxxx
{
  "success": false,
  "message": "无效的API密钥"
}

2. 获取用户积分接口

接口描述

查询指定 API Key 对应的用户积分余额。

请求信息

请求方法: GET

请求路径: /api/v1/claw/user/get_quota

请求参数

参数名	类型	必填	说明
apiKey	String	是	用户 API 密钥

请求示例:


xxxxxxxxxx
GET /api/v1/claw/user/get_quota?apiKey=your_api_key_here

响应参数

成功响应 (success: true):

字段名	类型	说明
success	Boolean	请求状态，true 表示成功
cost	Integer	本次请求消耗的积分数量（固定为 0）
quota	Integer	用户剩余积分数量
data	String	当前服务器时间（格式：yyyy/MM/dd HH:mm）
message	String	成功时为空

响应示例:


xxxxxxxxxx
{
  "success": true,
  "cost": 0,
  "quota": 1000,
  "data": "2025/03/22 14:30",
  "message": ""
}

失败响应 (success: false):

字段名	类型	说明
success	Boolean	请求状态，false 表示失败
message	String	错误信息描述

失败示例:


xxxxxxxxxx
{
  "success": false,
  "message": "无效的API密钥"
}

3. 采集账号视频列表接口

接口描述

采集抖音或小红书账号的视频列表，支持按互动量筛选和最近天数过滤。

请求信息

请求方法: POST

请求路径: /api/v1/claw/account/collect/videos

支持平台:

抖音（个人主页链接）
小红书（个人主页链接）

请求参数

字段名	类型	必填	默认值	说明
apiKey	String	是	-	用户 API 密钥，用于身份验证和积分扣除
url	String	是	-	账号主页链接地址（支持抖音和小红书）
recentDay	Integer	否	180	最近天数，只采集指定天数内的视频
maxSize	Integer	否	-	最大获取数量，不传则返回所有符合条件的视频
minDigg	Long	否	0	最低点赞量，低于此值的视频将被过滤
minComment	Long	否	0	最低评论量，低于此值的视频将被过滤
minCollect	Long	否	0	最低收藏量，低于此值的视频将被过滤

请求示例:


xxxxxxxxxx
{
  "apiKey": "your_api_key_here",
  "url": "https://www.douyin.com/user/xxxxx",
  "recentDay": 30,
  "maxSize": 10,
  "minDigg": 1000,
  "minComment": 50,
  "minCollect": 100
}

响应参数

成功响应 (success: true):

字段名	类型	说明
success	Boolean	请求状态，true 表示成功
cost	Integer	本次请求消耗的积分数量（按实际返回视频数量计算）
quota	Integer	用户剩余积分数量
data	Array	视频列表数组
message	String	成功时为空

抖音视频 data 字段说明:

data 是一个数组，每个元素表示一个视频：

字段名	类型	说明
title	String	视频标题/描述
author_nickname	String	作者昵称
type	String	视频类型：video（视频）、image（图文）、other（其他）
like_count	Integer	点赞数
comment_count	Integer	评论数
collect_count	Integer	收藏数
share_count	Integer	转发/分享数
publish_time	Long	发布时间戳（毫秒）
share_url	Object	分享链接对象，包含 text 和 link 字段
cover_url	String	视频封面图片 URL
video_url	String	视频文件下载地址（仅视频类型）
audio_url	String	音频文件下载地址（仅视频类型）

抖音视频响应示例:


xxxxxxxxxx
{
  "success": true,
  "cost": 30,
  "quota": 970,
  "data": [
    {
      "title": "精彩视频分享",
      "author_nickname": "抖音达人",
      "type": "video",
      "like_count": 5000,
      "comment_count": 200,
      "collect_count": 500,
      "share_count": 100,
      "publish_time": 1711098000000,
      "share_url": {
        "text": "https://v.douyin.com/xxxxx/",
        "link": "https://v.douyin.com/xxxxx/"
      },
      "cover_url": "https://example.com/cover.jpg",
      "video_url": "https://example.com/video.mp4",
      "audio_url": "https://example.com/audio.mp3"
    }
  ],
  "message": ""
}

小红书视频 data 字段说明:

字段名	类型	说明
title	String	笔记标题
author_nickname	String	作者昵称
type	String	类型（固定为"video"，只返回视频类型笔记）
like_count	Long	点赞数
comment_count	Long	评论数
collect_count	Long	收藏数
share_count	Long	分享数
publish_time	Long	发布时间戳（毫秒）
share_url	Object	分享链接对象，包含 text 和 link 字段
video_url	String	视频文件下载地址

小红书视频响应示例:


xxxxxxxxxx
{
  "success": true,
  "cost": 20,
  "quota": 980,
  "data": [
    {
      "title": "小红书视频分享",
      "author_nickname": "小红书达人",
      "type": "video",
      "like_count": 3000,
      "comment_count": 150,
      "collect_count": 400,
      "share_count": 80,
      "publish_time": 1711098000000,
      "share_url": {
        "text": "https://www.xiaohongshu.com/discovery/item/xxxxx",
        "link": "https://www.xiaohongshu.com/discovery/item/xxxxx"
      },
      "video_url": "https://example.com/xhs_video.mp4"
    }
  ],
  "message": ""
}

失败响应 (success: false):

字段名	类型	说明
success	Boolean	请求状态，false 表示失败
message	String	错误信息描述

失败示例:


xxxxxxxxxx
{
  "success": false,
  "message": "用户数据采集失败：账号不存在"
}

4. 采集账号数据接口

接口描述

采集抖音或小红书账号信息，包括粉丝数、作品数、账号简介等数据。

请求信息

请求方法: POST

请求路径: /api/v1/claw/account/collect/info

支持平台:

抖音（个人主页链接）
小红书（个人主页链接）

请求参数

字段名	类型	必填	说明
apiKey	String	是	用户 API 密钥，用于身份验证和积分扣除
url	String	是	账号主页链接地址（支持抖音和小红书）

请求示例:


xxxxxxxxxx
{
  "apiKey": "your_api_key_here",
  "url": "https://www.douyin.com/user/xxxxx"
}

响应参数

成功响应 (success: true):

字段名	类型	说明
success	Boolean	请求状态，true 表示成功
cost	Integer	本次请求消耗的积分数量
quota	Integer	用户剩余积分数量
data	Object	账号详细信息对象
message	String	成功时为空

抖音账号 data 字段说明:

data 是一个对象，包含账号的所有详细信息：

字段名	类型	说明
home_page_url	String	主页链接
nickname	String	昵称
signature	String	账号简介/个性签名
douyin_id	String	抖音号（优先使用 unique_id，为空则使用 short_id）
following_count	Long	关注数
follower_count	Long	粉丝数
max_follower_count	Long	粉丝数峰值（历史最高粉丝数）
total_favorited	Long	获赞总数（赞藏量）
aweme_count	Long	作品数
ip_location	String	IP 属地（如"北京"、"上海"等），可能不存在

抖音账号响应示例:


xxxxxxxxxx
{
  "success": true,
  "cost": 3,
  "quota": 997,
  "data": {
    "home_page_url": "https://www.douyin.com/user/xxxxx",
    "nickname": "抖音达人",
    "signature": "分享生活，记录美好",
    "douyin_id": "douyin123456",
    "following_count": 256,
    "follower_count": 125000,
    "max_follower_count": 130000,
    "total_favorited": 5680000,
    "aweme_count": 328,
    "ip_location": "北京"
  },
  "message": ""
}

小红书账号 data 字段说明:

data 是一个对象，包含账号的所有详细信息：

字段名	类型	说明
home_page_url	String	主页链接
nickname	String	昵称
signature	String	账号简介
red_id	String	小红书号
following_count	Long	关注数
follower_count	Long	粉丝数
max_follower_count	Long	粉丝数峰值
liked_count	Long	获赞总数（赞藏量）
notes_count	Long	作品数（笔记数）
ip_location	String	IP 属地

小红书账号响应示例:


xxxxxxxxxx
{
  "success": true,
  "cost": 3,
  "quota": 997,
  "data": {
    "home_page_url": "https://www.xiaohongshu.com/user/profile/xxxxx",
    "nickname": "小红书达人",
    "signature": "生活美学家",
    "red_id": "123456789",
    "following_count": 180,
    "follower_count": 86000,
    "max_follower_count": 90000,
    "liked_count": 2340000,
    "notes_count": 256,
    "ip_location": "上海"
  },
  "message": ""
}

失败响应 (success: false):

字段名	类型	说明
success	Boolean	请求状态，false 表示失败
message	String	错误信息描述

失败示例:


xxxxxxxxxx
{
  "success": false,
  "message": "用户数据采集失败：账号不存在"
}