ByteNote

TikHub 是一个开箱即用的社交媒体数据 API 集成平台，提供抖音、TikTok、小红书、快手、微博、Instagram、YouTube 等主流平台的 RESTful API 服务。该项目通过 Python SDK 的形式，帮助开发者快速获取社交媒体数据，支持异步调用、自动重试、速率限制等功能。

项目简介

TikHub.io 是一个集成工具和服务的平台，目标是帮助用户快速开展业务并支持功能定制。该项目采用社区创业模式，允许社区成员将自己编写的功能或接口接入平台并获得收益。

核心特性

多平台支持：抖音（网页版/App V1/V2/V3）、TikTok（网页版/App V2/V3）、小红书、快手、微博、Instagram、YouTube、网易云音乐、Twitter
RESTful API：基于 OpenAPI 规范，支持自动生成多语言客户端代码
Python SDK：提供完整的异步 SDK，基于 HTTPX 封装
在线文档：Swagger UI 可视化接口文档，支持在线测试
阶梯定价：根据使用量提供阶梯式折扣
验证码绕过：内置验证码解决接口
临时邮箱：提供临时邮箱接口服务

安装指南

环境要求

Python >= 3.6

安装 SDK

bash

pip install tikhub

快速开始

基础用法

python

from tikhub import Client
import asyncio

# 初始化客户端
client = Client(
    base_url="https://api.tikhub.io",
    api_key="YOUR_API_TOKEN",
    proxies=None,
    max_retries=3,
    max_connections=50,
    timeout=60,
    max_tasks=50
)

# 获取单个抖音视频数据
async def get_video():
    video_data = await client.DouyinAppV1.fetch_one_video(
        aweme_id="7345492945006595379"
    )
    print(video_data)

asyncio.run(get_video())

同步代码中使用

如果你的代码是同步执行的，可以使用以下方式防止异步传染：

python

import asyncio
from tikhub import Client

client = Client(
    base_url="https://api.tikhub.io",
    api_key="YOUR_API_TOKEN"
)

def fetch_one_video(aweme_id: str):
    loop = asyncio.get_event_loop()
    try:
        video_data = loop.run_until_complete(
            client.DouyinAppV1.fetch_one_video(aweme_id=aweme_id)
        )
        return video_data
    except Exception as e:
        return str(e)
    finally:
        loop.close()

if __name__ == "__main__":
    video_data = fetch_one_video(aweme_id="7345492945006595379")
    print(video_data)

SDK 模块说明

TikHub SDK 提供了以下主要模块：

模块	说明
`TikHubUser`	用户接口，获取用户信息、使用量、价格计算等
`DouyinWeb`	抖音网页版 API
`DouyinAppV1/V2/V3`	抖音 App API（多个版本）
`TikTokWeb`	TikTok 网页版 API
`TikTokAppV2/V3`	TikTok App API
`InstagramWeb`	Instagram API
`WeiboWeb`	微博 API
`XiaohongshuWeb`	小红书网页版 API
`KuaishouWeb`	快手网页版 API
`YouTubeWeb`	YouTube API
`TwitterWeb`	Twitter API
`NetEaseCloudMusicAppV1`	网易云音乐 API
`CaptchaSolver`	验证码解决器
`HybridParsing`	混合解析接口

获取 API Token

访问 TikHub 用户后台
点击左侧的 "API Keys"
生成新的 API Token
可自定义权限（Scopes）和过期日期（Expire Date）

鉴权方式

在 HTTP 请求头中添加 Authorization 字段：

json

{
  "Authorization": "Bearer Your_API_Token"
}

许可证

Apache Software License

字节笔记本

TikHub - 社交媒体数据 API Python SDK