根据关键字搜索抖音用户,支持翻页与会话 ID。
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键字 |
| offset | number | 否 | 翻页偏移量 (默认0) 后续翻页请传入返回参数中的cursor |
| searchId | string | 否 | 会话ID (首次留空) 后续翻页请传入返回参数中的searchId |
| apiKey | string | 是 | 用户 API Key |
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | number | 状态码 (0 表示成功) |
| success | boolean | 请求是否成功 |
| msg | string | 状态描述信息 |
| data | object | 数据对象 |
| data.has_more | number | 是否有更多数据 (1: 有, 0: 无) |
| data.cursor | number | 下一页游标 |
| data.search_id | string | 搜索会话 ID |
| data.items | array | 用户列表 |
| data.items[].uid | string | 用户 UID |
| data.items[].sec_uid | string | 用户 SecUID |
| data.items[].unique_id | string | 用户抖音号 |
| data.items[].nickname | string | 用户昵称 |
| data.items[].signature | string | 用户签名 |
| data.items[].follower_count | number | 粉丝数 |
| data.items[].avatar | string | 头像链接 |
| usage | object | 用量信息 |
| usage.cost | number | 本次消耗用量 |
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| 401 | Unauthorized | API Key 无效或过期,请检查 Key 是否正确 |
| 400 | Bad Request | 请求参数错误 |
| 403 | Forbidden | 余额不足或权限受限 |
| 500 | Internal Server Error | 服务器内部错误,请联系技术支持 |