README - English - TikHub.io API Docs

此页也有中文版本可用：自述文档 - 中文

[Useful Links]

🏡 Home: https://www.tikhub.io

🐙 GitHub Organization: https://github.com/TikHub

🛠 Python SDK V1: https://github.com/TikHub/TikHub-API-Python-SDK

🛠 Python SDK V2: https://github.com/TikHub/TikHub-API-Python-SDK-V2

📥 Multi-Functional Downloader: https://github.com/TikHub/TikHub-Multi-Functional-Downloader

🖥️ API Demo: https://github.com/TikHub/TikHub-API-Demo

📜 Swagger UI: https://api.tikhub.io

📚 Apifox UI: https://docs.tikhub.io

🧪 API Playground: https://app.apifox.com/project/4705614

📈 API Status Monitor: https://monitor.tikhub.io

💬 Discord Server: https://discord.gg/Pu2uKkFu6u

✨ X.com: https://x.com/TikHubio

📢 TikHub Domain Access Notice (Important for Mainland China Users)

Dear TikHub Users,

Due to our primary domain api.tikhub.io being blocked by the Great Firewall, users in Mainland China are currently unable to access TikHub services. To ensure stable access, we have deployed a free acceleration domain specifically for users located in Mainland China.

🌍 Please use the correct API domain based on your location:

🌎 If you are outside Mainland China
✅ Use: https://api.tikhub.io
🚫 Do NOT use api.tikhub.dev — doing so may result in slower response times and degraded performance.

🇨🇳 If you are located in Mainland China
✅ Use: https://api.tikhub.dev
🔓 No proxy is required — you can access it directly.
⚙️ All request paths and parameters remain the same — simply replace the domain name.

HTTP Status Codes

400 Bad Request

The request format is incorrect or parameters are invalid. Sometimes occurs due to server internal errors.

401 Unauthorized

Invalid API token.

API token is missing.

Unable to validate API token.

API token status is invalid or not activated.

API token has expired.

User not found.

403 Forbidden

Lacking required permissions for this route.

Account is disabled.

Email is not verified.

API token lacks required permissions.

404 Not Found

Endpoint data not found in the database.

402 Payment Required

Insufficient balance, this endpoint requires payment and accepts free credits.

Insufficient balance, this endpoint requires payment and does not accept free credits.

429 Too Many Requests

Request too fast, exceeding the rate limit.

500 Internal Server Error

Server internal error, unable to complete the request.

Note

🌐 TikHub API is a multi-social media data analysis platform that provides the following data interface services for developers and is constantly being updated:

📱 Douyin Web API

📱 Douyin App V1 API - (This version is no longer actively maintained, please use the new version)

📱 Douyin App V2 API - (This version is no longer actively maintained, please use the new version)

📱 Douyin App V3 API

🔥 Douyin Search API

🔥 Douyin Billboard API

⭐ Douyin Xingtu API

🎵 TikTok Web API

🎵 TikTok App V2 API - (This version is no longer actively maintained, please use the new version)

🎵 TikTok App V3 API

👨‍🎨 TikTok Creator API - E-commerce

🎵 TikTok Analytics API - MCN

🎵 TikTok Shop Web API

🎵 TikTok Ads API -Ads

🍉 Xigua App V2 API

📕 Xiaohongshu Web API

📕 Xiaohongshu Web V2 API

📕 Xiaohongshu App API

🍋 Lemon8 App API

📺 Bilibili Web API

📺 Bilibili App API

🎬 Sora2 API

⚡ Kuaishou Web API

⚡ Kuaishou App API

🦐 PiPiXia App API

🔄 Weibo Web API

🔄 Weibo Web V2 API

🔄 Weibo APP API

💬 WeChat MP Web API

📱 WeChat Channels API

📸 Instagram Web & APP API

📹 YouTube Web API

🎵 NetEase Cloud Music App API

🐦 Twitter Web API

🧵 Threads Web API

🔴 Reddit Web API

🔴 Reddit APP API

💼 LinkedIn Web API

❓ Zhihu Web API

🤖 Captcha Solver

✉️ Temp Mail API

Please report any issues or errors to the Discord server.

Users

Official Website/User Dashboard: TikHub User

Update Notice

Old Users

If you have previously registered a TikHub account, please re-register and contact us via Discord, WeChat, or email to adjust the remaining balance. We will serve you one-on-one.

New Users

Please register and verify your email before using the API and purchasing services.

Payment

Stripe Payment: Supports Visa, MasterCard, American Express, and other credit cards, as well as Apple Pay, Google Pay, and other payment methods.

PayPal Payment: Chinese users/UnionPay cardholders please use PayPal payment, no registration is required when paying, please select the credit card/debit card payment option below.

Unipayment Payment: Supports USDT, BTC, ETH, and other cryptocurrencies.

If the above payment methods do not meet your needs, please contact us.

Referral Code

You can send the referral code registration link to your friends. If your friend successfully registers, you will receive

2 o f p ai d ba l an ce (ab o u t 1000 re q u es t s), an d yo u r f r i e n d w i ll a l sorece i v e

2 of paid balance (about 1000 requests) after the first purchase of the service.

The referral code registration link can be viewed and generated on the personal homepage.

The referral code registration link is valid for 30 days.

When using the referral code, make sure your account has verified the email and is a paid user.

API Key Usage

Please save the API Key immediately after generating it, as the API Key will only be displayed once after creation.

Each user can create up to 20 API Keys.

API Free Trial

After registering and verifying your email, you can click the Check-in button in the upper right corner of the user dashboard to get a free trial balance, you can sign in once a day.

API Token Introduction:

Method 1: Use API Token in the Request Header (Recommended)

Header: Authorization

Format: Bearer your_token

Example: "Authorization": "Bearer your_token"

Swagger UI: Click on the Authorize button in the upper right corner of the page to enter the API token directly without the Bearer keyword.

Cookie: Authorization

Format: Bearer your_token

Example: Authorization=Bearer your_token

Get API Token:

Go to the user center, click on the API token menu, and create an API token.

Copy and use the API token in the request header.

Keep your API token confidential and use it only in the request header.

README - English

[Useful Links]#

📢 TikHub Domain Access Notice (Important for Mainland China Users)#

🌍 Please use the correct API domain based on your location:#

HTTP Status Codes#

Note#

Users#

Update Notice#

API Token Introduction:#

Method 1: Use API Token in the Request Header (Recommended)#

Method 2: Use API Token in the Cookie (Not Recommended, Use Only When Method 1 is Unavailable)#

Get API Token:#