网站接口文档

通用说明

服务地址：https://ai.yinghetwbot.com/v1

所有接口通过 token 参数进行身份认证，支持 GET 和 POST 两种请求方式。

认证方式

GET 请求：通过 URL query 参数传递 ?token=xxx
POST 请求：通过 query 参数或 form-data 传递

本服务所有接口均不消耗API调用次数，仅做token身份验证。

用户名说明

所有涉及 Twitter 用户名的参数会自动标准化处理：自动去除 @ 前缀，自动转为小写。

错误码说明

状态码	说明
400	参数缺失或格式错误、用户已存在于列表中
401	token无效或用户不存在
403	已达到监控/关注上限

用户信息接口

获取用户信息不消耗额度

GETPOST/api/user/info

参数名	类型	必填	说明
token	string	是	用户token

请求示例：

GET /api/user/info?token=xxx

响应示例：

{ "success": true, "email": "[email protected]", "username": "testuser", "user_id": "12345", "token": "xxx", "max_tweets": 50, "max_follows": 20, "max_unfollows": 10, "api_calls_remaining": 9500, "expire_time": "2026-04-01T00:00:00", "created_at": "2026-01-01T00:00:00", "is_expired": false }

响应字段说明：

字段	类型	说明
email	string	用户邮箱
username	string	用户名
user_id	string	用户ID
token	string	用户token
max_tweets	int	推文监控上限
max_follows	int	关注上限
max_unfollows	int	取消关注上限
api_calls_remaining	int	剩余API调用次数
expire_time	string/null	到期时间（ISO格式）
created_at	string	账户创建时间
is_expired	boolean	账户是否已过期

推文监控接口

1. 获取推文监控列表不消耗额度

GET/api/tweets

参数名	类型	必填	说明
token	string	是	用户token
page	int	否	页码，从1开始，默认1
page_size	int	否	每页条数，默认20，最大100

请求示例：

GET /api/tweets?token=xxx&page=1&page_size=20

响应示例：

{
  "success": true,
  "data": [
    { "user_id": "44196397", "screen_name": "elonmusk" },
    { "user_id": "0", "screen_name": "jack" }
  ],
  "count": 2,
  "total": 15,
  "page": 1,
  "page_size": 20,
  "total_pages": 1
}

分页字段说明：

字段	类型	说明
count	int	当前页返回的条数
total	int	总记录数
page	int	当前页码
page_size	int	每页条数
total_pages	int	总页数

2. 添加推文监控用户不消耗额度

GETPOST/api/tweets/add

参数名	类型	必填	说明
token	string	是	用户token
username	string	是	Twitter用户名（自动去@和转小写）

请求示例：

GET /api/tweets/add?token=xxx&username=elonmusk

响应示例：

{
  "success": true,
  "message": "添加成功",
  "username": "elonmusk"
}

可能的错误：400 - 该用户已在监控列表中 | 403 - 已达到监控上限

3. 删除推文监控用户不消耗额度

GETPOST/api/tweets/delete

参数名	类型	必填	说明
token	string	是	用户token
username	string	是	Twitter用户名

请求示例：

GET /api/tweets/delete?token=xxx&username=elonmusk

4. 检查推文用户是否在监控列表不消耗额度

GETPOST/api/tweets/check

参数名	类型	必填	说明
token	string	是	用户token
usernames	string	是	用户名，多个用逗号分隔

请求示例：

GET /api/tweets/check?token=xxx&usernames=elonmusk,jack,vitalik

响应示例：

{
  "success": true,
  "count": 3,
  "results": [
    { "username": "elonmusk", "exists": true, "data": { "user_id": "44196397", "screen_name": "elonmusk" } },
    { "username": "jack", "exists": true, "data": { "user_id": "0", "screen_name": "jack" } },
    { "username": "vitalik", "exists": false, "data": null }
  ]
}

关注管理接口

5. 获取关注列表不消耗额度

GET/api/follows

参数名	类型	必填	说明
token	string	是	用户token

请求示例：

GET /api/follows?token=xxx

响应示例：

{
  "success": true,
  "data": [
    { "follow_user": "elonmusk" },
    { "follow_user": "jack" }
  ],
  "count": 2
}

6. 添加关注用户不消耗额度

GETPOST/api/follows/add

参数名	类型	必填	说明
token	string	是	用户token
username	string	是	Twitter用户名

请求示例：

GET /api/follows/add?token=xxx&username=elonmusk

响应示例：

{
  "success": true,
  "message": "添加成功",
  "username": "elonmusk"
}

可能的错误：400 - 该用户已在关注列表中 | 403 - 已达到关注上限

7. 删除关注用户不消耗额度

GETPOST/api/follows/delete

参数名	类型	必填	说明
token	string	是	用户token
username	string	是	Twitter用户名

请求示例：

GET /api/follows/delete?token=xxx&username=elonmusk

8. 检查关注用户是否在列表中不消耗额度

GETPOST/api/follows/check

参数名	类型	必填	说明
token	string	是	用户token
usernames	string	是	用户名，多个用逗号分隔

请求示例：

GET /api/follows/check?token=xxx&usernames=elonmusk,jack

响应示例：

{
  "success": true,
  "count": 2,
  "results": [
    { "username": "elonmusk", "exists": true, "data": { "follow_user": "elonmusk" } },
    { "username": "jack", "exists": false, "data": null }
  ]
}

接口速查表

接口	路径	方式	必填参数	说明
用户信息	`/api/user/info`	GET/POST	token	获取账户信息
推文列表	`/api/tweets`	GET	token	获取监控列表（支持分页：page, page_size）
添加推文	`/api/tweets/add`	GET/POST	token, username	添加监控用户
删除推文	`/api/tweets/delete`	GET/POST	token, username	删除监控用户
检查推文	`/api/tweets/check`	GET/POST	token, usernames	批量检查，逗号分隔
关注列表	`/api/follows`	GET	token	获取关注列表
添加关注	`/api/follows/add`	GET/POST	token, username	添加关注用户
删除关注	`/api/follows/delete`	GET/POST	token, username	删除关注用户
检查关注	`/api/follows/check`	GET/POST	token, usernames	批量检查，逗号分隔

通用说明

认证方式

用户名说明

错误码说明

用户信息接口

获取用户信息 不消耗额度

推文监控接口

1. 获取推文监控列表 不消耗额度

2. 添加推文监控用户 不消耗额度

3. 删除推文监控用户 不消耗额度

4. 检查推文用户是否在监控列表 不消耗额度

关注管理接口

5. 获取关注列表 不消耗额度

6. 添加关注用户 不消耗额度

7. 删除关注用户 不消耗额度

8. 检查关注用户是否在列表中 不消耗额度

接口速查表

获取用户信息不消耗额度

1. 获取推文监控列表不消耗额度

2. 添加推文监控用户不消耗额度

3. 删除推文监控用户不消耗额度

4. 检查推文用户是否在监控列表不消耗额度

5. 获取关注列表不消耗额度

6. 添加关注用户不消耗额度

7. 删除关注用户不消耗额度

8. 检查关注用户是否在列表中不消耗额度