Claw API 接口文档

基础信息

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

1. 视频解析接口

接口描述

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

请求信息

请求方法: POST

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

支持平台:

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

请求参数

请求示例:

1
{
2
  "apiKey": "your_api_key_here",
3
  "url": "https://v.douyin.com/xxxxx/"
4
}

响应参数

成功响应 (success: true):

data 字段说明:

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

抖音视频响应示例:

xxxxxxxxxx
22
1
{
2
  "success": true,
3
  "cost": 5,
4
  "quota": 995,
5
  "data": {
6
    "title": "精彩视频分享",
7
    "keywords": ["#美食", "#生活"],
8
    "summary": "今天给大家分享一道美食",
9
    "like_count": 1234,
10
    "comment_count": 56,
11
    "collect_count": 78,
12
    "share_count": 23,
13
    "author_name": "美食达人",
14
    "publish_time": "2025-03-22 10:30:00",
15
    "audio_url": "https://example.com/audio.mp3",
16
    "video_url": "https://example.com/video.mp4",
17
    "transcript": "今天给大家分享一道美食",
18
    "cover_url": "https://example.com/cover.jpg",
19
    "follower_count": 50000
20
  },
21
  "message": ""
22
}

失败响应 (success: false):

失败示例:

xxxxxxxxxx
4
1
{
2
  "success": false,
3
  "message": "无效的API密钥"
4
}

2. 获取用户积分接口

接口描述

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

请求信息

请求方法: GET

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

请求参数

请求示例:

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

响应参数

成功响应 (success: true):

响应示例:

xxxxxxxxxx
7
1
{
2
  "success": true,
3
  "cost": 0,
4
  "quota": 1000,
5
  "data": "2025/03/22 14:30",
6
  "message": ""
7
}

失败响应 (success: false):

失败示例:

xxxxxxxxxx
4
1
{
2
  "success": false,
3
  "message": "无效的API密钥"
4
}

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

接口描述

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

请求信息

请求方法: POST

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

支持平台:

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

请求参数

请求示例:

xxxxxxxxxx
9
1
{
2
  "apiKey": "your_api_key_here",
3
  "url": "https://www.douyin.com/user/xxxxx",
4
  "recentDay": 30,
5
  "maxSize": 10,
6
  "minDigg": 1000,
7
  "minComment": 50,
8
  "minCollect": 100
9
}

响应参数

成功响应 (success: true):

抖音视频 data 字段说明:

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

抖音视频响应示例:

xxxxxxxxxx
25
1
{
2
  "success": true,
3
  "cost": 30,
4
  "quota": 970,
5
  "data": [
6
    {
7
      "title": "精彩视频分享",
8
      "author_nickname": "抖音达人",
9
      "type": "video",
10
      "like_count": 5000,
11
      "comment_count": 200,
12
      "collect_count": 500,
13
      "share_count": 100,
14
      "publish_time": 1711098000000,
15
      "share_url": {
16
        "text": "https://v.douyin.com/xxxxx/",
17
        "link": "https://v.douyin.com/xxxxx/"
18
      },
19
      "cover_url": "https://example.com/cover.jpg",
20
      "video_url": "https://example.com/video.mp4",
21
      "audio_url": "https://example.com/audio.mp3"
22
    }
23
  ],
24
  "message": ""
25
}

小红书视频 data 字段说明:

小红书视频响应示例:

xxxxxxxxxx
23
1
{
2
  "success": true,
3
  "cost": 20,
4
  "quota": 980,
5
  "data": [
6
    {
7
      "title": "小红书视频分享",
8
      "author_nickname": "小红书达人",
9
      "type": "video",
10
      "like_count": 3000,
11
      "comment_count": 150,
12
      "collect_count": 400,
13
      "share_count": 80,
14
      "publish_time": 1711098000000,
15
      "share_url": {
16
        "text": "https://www.xiaohongshu.com/discovery/item/xxxxx",
17
        "link": "https://www.xiaohongshu.com/discovery/item/xxxxx"
18
      },
19
      "video_url": "https://example.com/xhs_video.mp4"
20
    }
21
  ],
22
  "message": ""
23
}

失败响应 (success: false):

失败示例:

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

4. 采集账号数据接口

接口描述

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

请求信息

请求方法: POST

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

支持平台:

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

请求参数

请求示例:

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

响应参数

成功响应 (success: true):

抖音账号 data 字段说明:

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

抖音账号响应示例:

xxxxxxxxxx
18
1
{
2
  "success": true,
3
  "cost": 3,
4
  "quota": 997,
5
  "data": {
6
    "home_page_url": "https://www.douyin.com/user/xxxxx",
7
    "nickname": "抖音达人",
8
    "signature": "分享生活，记录美好",
9
    "douyin_id": "douyin123456",
10
    "following_count": 256,
11
    "follower_count": 125000,
12
    "max_follower_count": 130000,
13
    "total_favorited": 5680000,
14
    "aweme_count": 328,
15
    "ip_location": "北京"
16
  },
17
  "message": ""
18
}

小红书账号 data 字段说明:

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

小红书账号响应示例:

xxxxxxxxxx
18
1
{
2
  "success": true,
3
  "cost": 3,
4
  "quota": 997,
5
  "data": {
6
    "home_page_url": "https://www.xiaohongshu.com/user/profile/xxxxx",
7
    "nickname": "小红书达人",
8
    "signature": "生活美学家",
9
    "red_id": "123456789",
10
    "following_count": 180,
11
    "follower_count": 86000,
12
    "max_follower_count": 90000,
13
    "liked_count": 2340000,
14
    "notes_count": 256,
15
    "ip_location": "上海"
16
  },
17
  "message": ""
18
}

失败响应 (success: false):

失败示例:

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

5. 对话接口

接口描述

使用预设的 Prompt 模板进行 AI 对话，支持多种 AI 模型（OpenAI、Siliconflow、Volcengine）。

请求信息

请求方法: POST

请求路径: /api/v1/claw/chat/{path}

路径参数:

请求参数

请求示例:

xxxxxxxxxx
4
1
{
2
  "apiKey": "your_api_key_here",
3
  "message": "帮我分析一下这个视频的文案"
4
}

响应参数

成功响应 (success: true):

响应示例:

xxxxxxxxxx
7
1
{
2
  "success": true,
3
  "cost": 15,
4
  "quota": 985,
5
  "data": "根据您提供的视频文案分析...",
6
  "message": ""
7
}

失败响应 (success: false):

失败示例:

xxxxxxxxxx
4
1
{
2
  "success": false,
3
  "message": "未找到对应的 Prompt"
4
}

6. 图片生成接口

接口描述

使用 Seedream 模型生成图片，支持自定义提示词、图片尺寸、数量和参考图片。

请求信息

请求方法: POST

请求路径: /api/v1/claw/seedream/images/generations

请求参数

请求示例:

xxxxxxxxxx
7
1
{
2
  "apiKey": "your_api_key_here",
3
  "message": "一只可爱的猫咪在花园里",
4
  "size": "1024x1024",
5
  "n": 2,
6
  "image": ["https://example.com/reference.jpg"]
7
}

响应参数

成功响应 (success: true):

响应示例:

xxxxxxxxxx
10
1
{
2
  "success": true,
3
  "cost": 20,
4
  "quota": 980,
5
  "data": [
6
    "https://cos.example.com/images/generated1.jpg",
7
    "https://cos.example.com/images/generated2.jpg"
8
  ],
9
  "message": ""
10
}

失败响应 (success: false):

失败示例:

xxxxxxxxxx
4
1
{
2
  "success": false,
3
  "message": "图片生成失败：生成超时"
4
}

7. 关键词搜索视频接口

接口描述

根据关键词搜索抖音视频，支持按互动量筛选和日期过滤，并将结果写入飞书多维表格。

请求信息

请求方法: POST

请求路径: /api/v1/claw/search/videos

请求参数

请求示例:

xxxxxxxxxx
10
1
{
2
  "apiKey": "your_api_key_here",
3
  "keyword": "美食教程",
4
  "appToken": "your_feishu_app_token",
5
  "lastDay": "2025/01/01",
6
  "minDigg": 1000,
7
  "minComment": 50,
8
  "minCollect": 100,
9
  "minShare": 20
10
}

响应参数

成功响应 (success: true):

data 字段说明:

每个视频记录包含以下字段：

响应示例:

xxxxxxxxxx
28
1
{
2
  "success": true,
3
  "cost": 30,
4
  "quota": 970,
5
  "data": [
6
    {
7
      "fields": {
8
        "作品标题": "美食教程：如何制作红烧肉",
9
        "账号名": "美食达人",
10
        "类型": "视频",
11
        "点赞量": 5000,
12
        "评论量": 200,
13
        "收藏量": 500,
14
        "转发量": 100,
15
        "发布时间": 1711098000000,
16
        "分享链接": {
17
          "text": "https://v.douyin.com/xxxxx/",
18
          "link": "https://v.douyin.com/xxxxx/"
19
        },
20
        "封面图链接": "https://example.com/cover.jpg",
21
        "视频下载地址": "https://example.com/video.mp4",
22
        "视频音频下载地址": "https://example.com/audio.mp3",
23
        "关键词": "美食教程"
24
      }
25
    }
26
  ],
27
  "message": ""
28
}

失败响应 (success: false):

失败示例:

xxxxxxxxxx
4
1
{
2
  "success": false,
3
  "message": "飞书表格未打开编辑权限"
4
}

8. 批量关键词搜索视频接口

接口描述

从飞书表格批量读取关键词及筛选条件，搜索对应的抖音视频并写入目标表格。

请求信息

请求方法: POST

请求路径: /api/v1/claw/search/collect/keyword-batch

请求参数

请求示例:

xxxxxxxxxx
12
1
{
2
  "apiKey": "your_api_key_here",
3
  "fromAppToken": "source_app_token",
4
  "toAppToken": "target_app_token",
5
  "keywordFieldName": "关键词",
6
  "selectedFieldName": "是否采集",
7
  "lastDayFieldName": "起始日期",
8
  "minDiggFieldName": "最低点赞",
9
  "minCommentFieldName": "最低评论",
10
  "minCollectFieldName": "最低收藏",
11
  "minShareFieldName": "最低转发"
12
}

响应参数

成功响应 (success: true):

响应示例:

xxxxxxxxxx
24
1
{
2
  "success": true,
3
  "cost": 60,
4
  "quota": 940,
5
  "data": [
6
    [
7
      {
8
        "fields": {
9
          "作品标题": "视频标题1",
10
          "账号名": "作者1"
11
        }
12
      }
13
    ],
14
    [
15
      {
16
        "fields": {
17
          "作品标题": "视频标题2",
18
          "账号名": "作者2"
19
        }
20
      }
21
    ]
22
  ],
23
  "message": ""
24
}

失败响应 (success: false):

失败示例:

xxxxxxxxxx
4
1
{
2
  "success": false,
3
  "message": "积分不足"
4
}

9. 热榜采集接口

接口描述

采集多个平台的热榜数据，包括抖音、小红书、百度和微博，支持关键词筛选。

请求信息

请求方法: POST

请求路径: /api/v1/claw/hotlist/getHotList

请求参数

请求示例:

xxxxxxxxxx
5
1
{
2
  "apiKey": "your_api_key_here",
3
  "appToken": "your_feishu_app_token",
4
  "key": "科技"
5
}

响应参数

成功响应 (success: true):

data 字段说明:

data 对象包含以下四个平台的热榜数据：

每个热榜项包含以下字段：

响应示例:

xxxxxxxxxx
60
1
{
2
  "success": true,
3
  "cost": 10,
4
  "quota": 990,
5
  "data": {
6
    "douyin": [
7
      {
8
        "fields": {
9
          "标题": {
10
            "text": "科技新闻标题",
11
            "link": "https://example.com/news1"
12
          },
13
          "关键词": "科技",
14
          "热度值": 1000000,
15
          "平台": "抖音"
16
        }
17
      }
18
    ],
19
    "xhs": [
20
      {
21
        "fields": {
22
          "标题": {
23
            "text": "小红书科技内容",
24
            "link": "https://example.com/news2"
25
          },
26
          "关键词": "科技",
27
          "热度值": 500000,
28
          "平台": "小红书"
29
        }
30
      }
31
    ],
32
    "baidu": [
33
      {
34
        "fields": {
35
          "标题": {
36
            "text": "百度热搜科技",
37
            "link": "https://example.com/news3"
38
          },
39
          "关键词": "科技",
40
          "热度值": 800000,
41
          "平台": "百度"
42
        }
43
      }
44
    ],
45
    "weibo": [
46
      {
47
        "fields": {
48
          "标题": {
49
            "text": "微博科技话题",
50
            "link": "https://example.com/news4"
51
          },
52
          "关键词": "科技",
53
          "热度值": 600000,
54
          "平台": "微博"
55
        }
56
      }
57
    ]
58
  },
59
  "message": ""
60
}

失败响应 (success: false):

失败示例:

xxxxxxxxxx
4
1
{
2
  "success": false,
3
  "message": "热榜获取失败：网络连接超时"
4
}