<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# 抖音用户公开信息

> 通过抖音用户主页链接（短链或长链），获取昵称、头像、签名、作品数、粉丝数、关注数、获赞总数等公开信息。自动展开 v.douyin.com 短链。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `douyin-user` |
| 接口名称 | 抖音用户公开信息 |
| 接口地址 | `https://v1.apizero.cn/api/douyin-user` |
| 请求方法 | `GET` |
| 分类 | content |
| 提供方 | 极数本源 |
| 计费模式 | 免费试用 |
| 单次消耗 | 0 积分 |
| 起步价 | — |
| QPS 限制 | 5 req/s |
| 每日免费额度 | 100 次（已认证用户） |
| 匿名每日额度 | 20 次（无 API Key） |
| VIP 免费 | 否 |
| 调用总次数 | undefined |

## 2. 认证

匿名免登录可调每日 20 次；登录用户每日 100 次。

获取 API Key：登录 `https://apizero.cn/account/keys` 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `url` | `string` | 是 | 抖音用户主页链接（v.douyin.com 短链或 douyin.com/user/ 长链） | — |

## 5. 请求示例 (cURL)

```bash
curl "https://v1.apizero.cn/api/douyin-user?url=%3Curl%3E&key=YOUR_API_KEY"
```

## 6. 响应字段

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `sec_uid` | `string` | 抖音内部 sec_uid | — |
| `unique_id` | `string` | 抖音号 | — |
| `nickname` | `string` | 昵称 | — |
| `signature` | `string` | 个性签名 | — |
| `avatar` | `string` | 头像 URL | — |
| `aweme_count` | `number` | 作品数 | — |
| `follower_count` | `number` | 粉丝数 | — |
| `following_count` | `number` | 关注数 | — |
| `total_favorited` | `number` | 获赞总数 | — |

## 7. 响应示例

```json
{
    "code": 0,
    "msg": "成功",
    "data": {
        "nickname": "张三",
        "follower_count": 9999,
        "aweme_count": 123,
        "total_favorited": 100000
    }
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `4000` | `—` | url 为空或无法提取 sec_uid |
| `5020` | `—` | 抖音接口失败或解析异常 |

## 9. 变更日志

- **1.0.0** (2026-05-07)
  - 首次上线 · 短链/长链双支持

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/douyin-user`

Source: `https://apizero.cn/aidocs/douyin-user/raw.md`
Last updated: 2026-05-11T16:16:07+08:00