https://github.com/taisprestes01/tiktok-uploader
tiktok-uploader is a Python-based project that automates the process of uploading videos to TikTok using the official TikTok API. It handles the full OAuth 2.0 authentication flow.
https://github.com/taisprestes01/tiktok-uploader
account api automation dark python python3 reddit tiktok tiktok-api tiktok-automation tiktok-upload tiktok-uploader trending
Last synced: 4 months ago
JSON representation
tiktok-uploader is a Python-based project that automates the process of uploading videos to TikTok using the official TikTok API. It handles the full OAuth 2.0 authentication flow.
- Host: GitHub
- URL: https://github.com/taisprestes01/tiktok-uploader
- Owner: taisprestes01
- Created: 2025-04-07T04:56:04.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-13T23:51:50.000Z (6 months ago)
- Last Synced: 2025-06-10T00:40:51.501Z (4 months ago)
- Topics: account, api, automation, dark, python, python3, reddit, tiktok, tiktok-api, tiktok-automation, tiktok-upload, tiktok-uploader, trending
- Language: Python
- Homepage:
- Size: 29.3 KB
- Stars: 4
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
🇺🇲
> ⭐ **If this project helped you, leave a star >.<**
> 🛠️ **This project will soon support scheduled video publishing.**
🇧🇷
> ⭐ **Se foi útil para você, deixa uma estrelinha >.<**
> 🛠️ **Este projeto ainda receberá a funcionalidade de agendamento de publicação de vídeos.**
English version 🇺🇸🇬🇧🇮🇳
TikTok OAuth & Video Upload
Automated flow for OAuth and video upload using TikTok API + Python.
🔧 Requirements •
🚀 How to Use •
🌐 HTTPS Callback via ngrok
---
## 🔧 Requirements
- Python 3.7+
- A TikTok Developer Account
- A public HTTPS callback URL (required for TikTok OAuth)
You can use [ngrok](https://ngrok.com) to generate a secure public HTTPS URL to your local Flask server.
---
## 🌐 How to set up the HTTPS callback using ngrok
1. [Create a free ngrok account](https://dashboard.ngrok.com/signup)
2. [Download ngrok](https://ngrok.com/download) and unzip the executable
3. Authenticate ngrok with your account token:
```bash
ngrok config add-authtoken YOUR_NGROK_AUTH_TOKEN
```
4. Start a tunnel on port 8080 (used by Flask):
```bash
ngrok http 8080
```
5. Copy the HTTPS URL generated by ngrok. It will look like:
```
https://abcd1234.ngrok-free.app/callback
```
6. Use this full URL in two places:
- On the TikTok Developer Portal
- Paste it into the `.env` file:
```
REDIRECT_URI=https://abcd1234.ngrok-free.app/callback
```
---
## 🚀 How to Use
### 1. Create a TikTok Developer Account
Go to [https://developers.tiktok.com](https://developers.tiktok.com) and:
- Log in with your TikTok account
- Go to **Developer Portal** → **Manage App** → **Create App**
- Change your app to **SANDBOX**
- Go to **Products** → **Add Products** → **Create App**
- Enable **Login Kit** and **Content Posting**
- Go to **Basic information** and select **Web** under Platforms
- Enter any link in "Configure for Web/Desktop"
- Go to **Products** → **Login Kit** and paste your ngrok link in **Redirect URI**
- Copy your **Client Key** and **Client Secret**
- Fill in the rest of the required fields with placeholder data
- Paste both keys in your `.env` file:
```
CLIENT_KEY=your_key
CLIENT_SECRET=your_secret
```
Woohoo! All set, let’s run it 🚀
---
### 2. Install Dependencies
```bash
pip install -r requirements.txt
```
TikTok OAuth & Upload de Vídeo
Fluxo automatizado de autenticação OAuth e upload de vídeo usando a API do TikTok com Python.
🔧 Requisitos •
🚀 Como Usar •
🌐 Callback HTTPS com ngrok
---
## 🔧 Requisitos
- Python 3.7+
- Conta de desenvolvedor TikTok
- Uma URL HTTPS pública para callback (necessária para o OAuth)
Você pode usar o [ngrok](https://ngrok.com) para gerar um link HTTPS público seguro para seu servidor Flask local.
---
## 🌐 Como configurar o callback HTTPS com ngrok
1. [Crie uma conta gratuita no ngrok](https://dashboard.ngrok.com/signup)
2. [Baixe o ngrok](https://ngrok.com/download) e descompacte o executável
3. Autentique o ngrok com seu token:
```bash
ngrok config add-authtoken SEU_TOKEN_DO_NGROK
```
4. Inicie um túnel na porta 8080 (usada pelo Flask):
```bash
ngrok http 8080
```
5. Copie a URL HTTPS gerada. Vai parecer com isso:
```
https://abcd1234.ngrok-free.app/callback
```
6. Use essa URL completa em dois lugares:
- No portal de desenvolvedor do TikTok
- No arquivo `.env`:
```
REDIRECT_URI=https://abcd1234.ngrok-free.app/callback
```
---
## 🚀 Como Usar
### 1. Criar Conta de Desenvolvedor TikTok
Acesse [https://developers.tiktok.com](https://developers.tiktok.com) e:
- Faça login com sua conta TikTok
- Vá em **Developer Portal** → **Manage App** → **Create App**
- Altere o app para **SANDBOX**
- Vá em **Products** → **Add Products** → **Create App**
- Ative **Login Kit** e **Content Posting**
- Em **Basic information**, selecione **Web** como plataforma
- Insira qualquer link em "Configure for Web/Desktop"
- Vá em **Products** → **Login Kit** e cole o link do ngrok em **Redirect URI**
- Copie seu **Client Key** e **Client Secret**
- Preencha o resto dos campos obrigatórios com dados fictícios
- E cole no `.env`:
```
CLIENT_KEY=sua_key
CLIENT_SECRET=seu_secret
```
Oba! Tudo pronto, bora rodar 🚀
---
### 2. Instalar as Dependências
```bash
pip install -r requirements.txt
```