# jackspeng/douyin-api-1 architecture

> Architecture diagram of the GitHub repository jackspeng/douyin-api-1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jackspeng/douyin-api-1
- Repository: https://github.com/jackspeng/douyin-api-1

## Overview

This repository is a Chinese-language catalog of Douyin data APIs and related collection capabilities, not an implementation of those services. The principal documented workflow is a client requesting an API and receiving structured results; the README gives a concrete video-list request and response example. Other branches cover search, user and video data, live streams, commerce, topics, recommendations, and rankings. Nodes represent documented capabilities, not inspected runtime modules; links reflect README claims only.

Main entry points: [`搜索/抖音Api：关键词综合搜索.md`](https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E5%85%B3%E9%94%AE%E8%AF%8D%E7%BB%BC%E5%90%88%E6%90%9C%E7%B4%A2.md) (General search), [`搜索/抖音Api：视频搜索列表.md`](https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E8%A7%86%E9%A2%91%E6%90%9C%E7%B4%A2%E5%88%97%E8%A1%A8.md) (Content search), [`搜索/抖音Api：用户搜索列表.md`](https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%94%A8%E6%88%B7%E6%90%9C%E7%B4%A2%E5%88%97%E8%A1%A8.md) (User search), [`搜索/抖音Api：直播搜索列表.md`](https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%9B%B4%E6%92%AD%E6%90%9C%E7%B4%A2%E5%88%97%E8%A1%A8.md) (Live search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_search["Search APIs"]
  node_search_general["General search<br/>[抖音Api：关键词综合搜索.md]"]
  node_search_content["Content search<br/>[抖音Api：视频搜索列表.md]"]
  node_search_people["User search<br/>[抖音Api：用户搜索列表.md]"]
  node_search_live["Live search<br/>[抖音Api：直播搜索列表.md]"]
  node_search_commerce["Product search<br/>[抖音Api：商品搜索列表.md]"]
  node_search_other["Other search"]
end

subgraph group_accounts["User and Video APIs"]
  node_user_profile["User profile<br/>[抖音Api：用户信息.md]"]
  node_user_lists["User lists<br/>[抖音Api：用户视频列表.md]"]
  node_user_relations["User relations<br/>[抖音Api：用户关注列表.md]"]
  node_user_live_shop["User live shop<br/>[抖音Api：用户直播信息.md]"]
  node_video_detail["Video details<br/>[抖音Api：视频详情.md]"]
  node_video_interaction["Video comments<br/>[抖音Api：评论列表.md]"]
  node_video_products["Video products<br/>[抖音Api：视频带货商品列表.md]"]
end

subgraph group_live["Live APIs"]
  node_live_room["Live room data<br/>[直播间信息.md]"]
  node_live_events["Live monitoring"]
  node_live_audience["Audience and status<br/>[在线观众.md]"]
  node_live_discovery["Live discovery<br/>[随机推荐.md]"]
  node_live_products["Live products<br/>[直播间带货商品列表.md]"]
end

subgraph group_discovery["Discovery APIs"]
  node_topics["Topic discovery<br/>[README.md]"]
  node_recommendations["Recommendations<br/>[README.md]"]
  node_rankings["Rankings<br/>[抖音榜单Api：热点榜.md]"]
end

subgraph group_collection["Collection Tools"]
  node_video_parsing["Video parsing"]
  node_data_collection["Data collection<br/>[从抖音app爬取数据.md]"]
  node_live_collection["Live data collection<br/>[readme.md]"]
end

node_client(("API client"))

node_client -->|"requests"| node_search_general
node_client -->|"requests"| node_search_content
node_client -->|"requests"| node_search_people
node_client -->|"requests"| node_search_live
node_client -->|"requests"| node_search_commerce
node_client -->|"requests"| node_search_other
node_client -->|"requests"| node_user_profile
node_client -->|"requests"| node_user_lists
node_client -->|"requests"| node_user_relations
node_client -->|"requests"| node_user_live_shop
node_client -->|"requests"| node_video_detail
node_client -->|"requests"| node_video_interaction
node_client -->|"requests"| node_video_products
node_client -->|"requests"| node_live_room
node_client -->|"requests"| node_live_events
node_client -->|"requests"| node_live_audience
node_client -->|"requests"| node_live_discovery
node_client -->|"requests"| node_live_products
node_client -->|"requests"| node_topics
node_client -->|"requests"| node_recommendations
node_client -->|"requests"| node_rankings
node_client -->|"uses"| node_video_parsing
node_client -->|"uses"| node_data_collection
node_client -->|"uses"| node_live_collection

click node_search_general "https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E5%85%B3%E9%94%AE%E8%AF%8D%E7%BB%BC%E5%90%88%E6%90%9C%E7%B4%A2.md"
click node_search_content "https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E8%A7%86%E9%A2%91%E6%90%9C%E7%B4%A2%E5%88%97%E8%A1%A8.md"
click node_search_people "https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%94%A8%E6%88%B7%E6%90%9C%E7%B4%A2%E5%88%97%E8%A1%A8.md"
click node_search_live "https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%9B%B4%E6%92%AD%E6%90%9C%E7%B4%A2%E5%88%97%E8%A1%A8.md"
click node_search_commerce "https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E5%95%86%E5%93%81%E6%90%9C%E7%B4%A2%E5%88%97%E8%A1%A8.md"
click node_search_other "https://github.com/jackspeng/douyin-api-1/tree/master/%E6%90%9C%E7%B4%A2"
click node_user_profile "https://github.com/jackspeng/douyin-api-1/blob/master/%E7%94%A8%E6%88%B7/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%94%A8%E6%88%B7%E4%BF%A1%E6%81%AF.md"
click node_user_lists "https://github.com/jackspeng/douyin-api-1/blob/master/%E7%94%A8%E6%88%B7/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%94%A8%E6%88%B7%E8%A7%86%E9%A2%91%E5%88%97%E8%A1%A8.md"
click node_user_relations "https://github.com/jackspeng/douyin-api-1/blob/master/%E7%94%A8%E6%88%B7/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%94%A8%E6%88%B7%E5%85%B3%E6%B3%A8%E5%88%97%E8%A1%A8.md"
click node_user_live_shop "https://github.com/jackspeng/douyin-api-1/blob/master/%E7%94%A8%E6%88%B7/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%94%A8%E6%88%B7%E7%9B%B4%E6%92%AD%E4%BF%A1%E6%81%AF.md"
click node_video_detail "https://github.com/jackspeng/douyin-api-1/blob/master/%E8%A7%86%E9%A2%91/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E8%A7%86%E9%A2%91%E8%AF%A6%E6%83%85.md"
click node_video_interaction "https://github.com/jackspeng/douyin-api-1/blob/master/%E8%A7%86%E9%A2%91/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E8%AF%84%E8%AE%BA%E5%88%97%E8%A1%A8.md"
click node_video_products "https://github.com/jackspeng/douyin-api-1/blob/master/%E8%A7%86%E9%A2%91/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E8%A7%86%E9%A2%91%E5%B8%A6%E8%B4%A7%E5%95%86%E5%93%81%E5%88%97%E8%A1%A8.md"
click node_live_room "https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/%E7%9B%B4%E6%92%AD%E9%97%B4%E4%BF%A1%E6%81%AF.md"
click node_live_events "https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/%E6%8A%96%E9%9F%B3%E7%9B%B4%E6%92%AD%E7%9B%91%E6%8E%A7Api%EF%BC%9A%E5%BC%B9%E5%B9%95%E3%80%81%E5%85%B3%E6%B3%A8%E3%80%81%E9%80%81%E7%A4%BC%E3%80%81%E7%82%B9%E8%B5%9E%E3%80%81%E6%9D%A5%E4%BA%86%20%E5%AE%9E%E6%97%B6%E8%8E%B7%E5%8F%96.md"
click node_live_audience "https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/%E5%9C%A8%E7%BA%BF%E8%A7%82%E4%BC%97.md"
click node_live_discovery "https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/%E9%9A%8F%E6%9C%BA%E6%8E%A8%E8%8D%90.md"
click node_live_products "https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/%E7%9B%B4%E6%92%AD%E9%97%B4%E5%B8%A6%E8%B4%A7%E5%95%86%E5%93%81%E5%88%97%E8%A1%A8.md"
click node_topics "https://github.com/jackspeng/douyin-api-1/blob/master/README.md"
click node_recommendations "https://github.com/jackspeng/douyin-api-1/blob/master/README.md"
click node_rankings "https://github.com/jackspeng/douyin-api-1/blob/master/%E6%A6%9C%E5%8D%95/%E6%8A%96%E9%9F%B3%E6%A6%9C%E5%8D%95Api%EF%BC%9A%E7%83%AD%E7%82%B9%E6%A6%9C.md"
click node_video_parsing "https://github.com/jackspeng/douyin-api-1/blob/master/%E5%B0%8F%E5%B7%A5%E5%85%B7/%E6%8A%96%E9%9F%B3%E3%80%81%E5%BF%AB%E6%89%8B%E7%AD%89%E5%85%A8%E5%B9%B3%E5%8F%B0%E8%A7%86%E9%A2%91%E5%8E%BB%E6%B0%B4%E5%8D%B0%E8%A7%A3%E6%9E%90.md"
click node_data_collection "https://github.com/jackspeng/douyin-api-1/blob/master/%E6%96%87%E9%9B%86/%E4%BB%8E%E6%8A%96%E9%9F%B3app%E7%88%AC%E5%8F%96%E6%95%B0%E6%8D%AE.md"
click node_live_collection "https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/readme.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_search_general,node_search_content,node_search_people,node_search_live,node_search_commerce,node_search_other,node_client toneBlue
class node_user_profile,node_user_lists,node_user_relations,node_user_live_shop,node_video_detail,node_video_interaction,node_video_products toneAmber
class node_live_room,node_live_events,node_live_audience,node_live_discovery,node_live_products toneMint
class node_topics,node_recommendations,node_rankings toneRose
class node_video_parsing,node_data_collection,node_live_collection toneIndigo
```

## Components

### Search APIs

- [General search](https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E5%85%B3%E9%94%AE%E8%AF%8D%E7%BB%BC%E5%90%88%E6%90%9C%E7%B4%A2.md): `搜索/抖音Api：关键词综合搜索.md`
- [Content search](https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E8%A7%86%E9%A2%91%E6%90%9C%E7%B4%A2%E5%88%97%E8%A1%A8.md): `搜索/抖音Api：视频搜索列表.md`
- [User search](https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%94%A8%E6%88%B7%E6%90%9C%E7%B4%A2%E5%88%97%E8%A1%A8.md): `搜索/抖音Api：用户搜索列表.md`
- [Live search](https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%9B%B4%E6%92%AD%E6%90%9C%E7%B4%A2%E5%88%97%E8%A1%A8.md): `搜索/抖音Api：直播搜索列表.md`
- [Product search](https://github.com/jackspeng/douyin-api-1/blob/master/%E6%90%9C%E7%B4%A2/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E5%95%86%E5%93%81%E6%90%9C%E7%B4%A2%E5%88%97%E8%A1%A8.md): `搜索/抖音Api：商品搜索列表.md`
- [Other search](https://github.com/jackspeng/douyin-api-1/tree/master/%E6%90%9C%E7%B4%A2): `搜索`

### User and Video APIs

- [User profile](https://github.com/jackspeng/douyin-api-1/blob/master/%E7%94%A8%E6%88%B7/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%94%A8%E6%88%B7%E4%BF%A1%E6%81%AF.md): `用户/抖音Api：用户信息.md`
- [User lists](https://github.com/jackspeng/douyin-api-1/blob/master/%E7%94%A8%E6%88%B7/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%94%A8%E6%88%B7%E8%A7%86%E9%A2%91%E5%88%97%E8%A1%A8.md): `用户/抖音Api：用户视频列表.md`
- [User relations](https://github.com/jackspeng/douyin-api-1/blob/master/%E7%94%A8%E6%88%B7/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%94%A8%E6%88%B7%E5%85%B3%E6%B3%A8%E5%88%97%E8%A1%A8.md): `用户/抖音Api：用户关注列表.md`
- [User live shop](https://github.com/jackspeng/douyin-api-1/blob/master/%E7%94%A8%E6%88%B7/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E7%94%A8%E6%88%B7%E7%9B%B4%E6%92%AD%E4%BF%A1%E6%81%AF.md): `用户/抖音Api：用户直播信息.md`
- [Video details](https://github.com/jackspeng/douyin-api-1/blob/master/%E8%A7%86%E9%A2%91/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E8%A7%86%E9%A2%91%E8%AF%A6%E6%83%85.md): `视频/抖音Api：视频详情.md`
- [Video comments](https://github.com/jackspeng/douyin-api-1/blob/master/%E8%A7%86%E9%A2%91/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E8%AF%84%E8%AE%BA%E5%88%97%E8%A1%A8.md): `视频/抖音Api：评论列表.md`
- [Video products](https://github.com/jackspeng/douyin-api-1/blob/master/%E8%A7%86%E9%A2%91/%E6%8A%96%E9%9F%B3Api%EF%BC%9A%E8%A7%86%E9%A2%91%E5%B8%A6%E8%B4%A7%E5%95%86%E5%93%81%E5%88%97%E8%A1%A8.md): `视频/抖音Api：视频带货商品列表.md`

### Live APIs

- [Live room data](https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/%E7%9B%B4%E6%92%AD%E9%97%B4%E4%BF%A1%E6%81%AF.md): `直播/直播间信息.md`
- [Live monitoring](https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/%E6%8A%96%E9%9F%B3%E7%9B%B4%E6%92%AD%E7%9B%91%E6%8E%A7Api%EF%BC%9A%E5%BC%B9%E5%B9%95%E3%80%81%E5%85%B3%E6%B3%A8%E3%80%81%E9%80%81%E7%A4%BC%E3%80%81%E7%82%B9%E8%B5%9E%E3%80%81%E6%9D%A5%E4%BA%86%20%E5%AE%9E%E6%97%B6%E8%8E%B7%E5%8F%96.md): `直播/抖音直播监控Api：弹幕、关注、送礼、点赞、来了 实时获取.md`
- [Audience and status](https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/%E5%9C%A8%E7%BA%BF%E8%A7%82%E4%BC%97.md): `直播/在线观众.md`
- [Live discovery](https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/%E9%9A%8F%E6%9C%BA%E6%8E%A8%E8%8D%90.md): `直播/随机推荐.md`
- [Live products](https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/%E7%9B%B4%E6%92%AD%E9%97%B4%E5%B8%A6%E8%B4%A7%E5%95%86%E5%93%81%E5%88%97%E8%A1%A8.md): `直播/直播间带货商品列表.md`

### Discovery APIs

- [Topic discovery](https://github.com/jackspeng/douyin-api-1/blob/master/README.md): `README.md`
- [Recommendations](https://github.com/jackspeng/douyin-api-1/blob/master/README.md): `README.md`
- [Rankings](https://github.com/jackspeng/douyin-api-1/blob/master/%E6%A6%9C%E5%8D%95/%E6%8A%96%E9%9F%B3%E6%A6%9C%E5%8D%95Api%EF%BC%9A%E7%83%AD%E7%82%B9%E6%A6%9C.md): `榜单/抖音榜单Api：热点榜.md`

### Collection Tools

- [Video parsing](https://github.com/jackspeng/douyin-api-1/blob/master/%E5%B0%8F%E5%B7%A5%E5%85%B7/%E6%8A%96%E9%9F%B3%E3%80%81%E5%BF%AB%E6%89%8B%E7%AD%89%E5%85%A8%E5%B9%B3%E5%8F%B0%E8%A7%86%E9%A2%91%E5%8E%BB%E6%B0%B4%E5%8D%B0%E8%A7%A3%E6%9E%90.md): `小工具/抖音、快手等全平台视频去水印解析.md`
- [Data collection](https://github.com/jackspeng/douyin-api-1/blob/master/%E6%96%87%E9%9B%86/%E4%BB%8E%E6%8A%96%E9%9F%B3app%E7%88%AC%E5%8F%96%E6%95%B0%E6%8D%AE.md): `文集/从抖音app爬取数据.md`
- [Live data collection](https://github.com/jackspeng/douyin-api-1/blob/master/%E7%9B%B4%E6%92%AD/readme.md): `直播/readme.md`

### Other components

- **API client**

## Connections

- API client → General search: requests (evidence: `README.md`)
- API client → Content search: requests (evidence: `README.md`)
- API client → User search: requests (evidence: `README.md`)
- API client → Live search: requests (evidence: `README.md`)
- API client → Product search: requests (evidence: `README.md`)
- API client → Other search: requests (evidence: `README.md`)
- API client → User profile: requests (evidence: `README.md`)
- API client → User lists: requests (evidence: `README.md`)
- API client → User relations: requests (evidence: `README.md`)
- API client → User live shop: requests (evidence: `README.md`)
- API client → Video details: requests (evidence: `README.md`)
- API client → Video comments: requests (evidence: `README.md`)
- API client → Video products: requests (evidence: `README.md`)
- API client → Live room data: requests (evidence: `README.md`)
- API client → Live monitoring: requests (evidence: `README.md`)
- API client → Audience and status: requests (evidence: `README.md`)
- API client → Live discovery: requests (evidence: `README.md`)
- API client → Live products: requests (evidence: `README.md`)
- API client → Topic discovery: requests (evidence: `README.md`)
- API client → Recommendations: requests (evidence: `README.md`)
- API client → Rankings: requests (evidence: `README.md`)
- API client → Video parsing: uses (evidence: `README.md`)
- API client → Data collection: uses (evidence: `README.md`)
- API client → Live data collection: uses (evidence: `README.md`)
