Repository files navigation

An unofficial API wrapper for Kick.com that handles Cloudflare protection automatically. This project provides a FastAPI-based REST API that mirrors Kick.com's API endpoints while managing Cloudflare bypass seamlessly.

Try it out before you deploy it:https://kickapi.hackmap.win/docs

• 🛡️ Automatic Cloudflare protection bypass
• 🔄 Session token authentication support
• 🚀 FastAPI-powered REST API
• 📝 Comprehensive endpoint documentation
• 🔍 Error handling and logging
• ⚡ Efficient request retrying and caching

• Python 3.8+
• Docker (optional, for containerized deployment)
• FastAPI
• curl-cffi

1. Clone the repository:

git clone https://github.com/sarperavci/kick-unofficial-api.gitcd kick-unofficial-api

2. Install dependencies:

pip install -r requirements.txt

3. Deploy the Cloudflare bypass server:

docker run -d -p 8000:8000 ghcr.io/sarperavci/cloudflarebypassforscraping:latest

4. Run the API server:

python src/api.py

1. First, deploy the Cloudflare bypass server:

docker run -d -p 8000:8000 ghcr.io/sarperavci/cloudflarebypassforscraping:latest

2. Then, deploy the API server:

docker run -d -p 5000:5000 \  -e BYPASS_SERVER_URL=http://host.docker.internal \  -e BYPASS_SERVER_PORT=8000 \  -e TARGET_URL=https://kick.com \  ghcr.io/sarperavci/kick-unofficial-api:latest

Note: Usehost.docker.internal to connect to the bypass server running on your host machine.

Run:

docker-compose up -d

The API configuration is managed through environment variables:

Once running, access the Swagger UI documentation at:

• Local deployment:http://localhost:5000/docs
• Docker deployment:http://your-server:5000/docs

For endpoints requiring authentication, include your Kick.com session token in the Authorization header:

curl -H"Authorization: Bearer your-session-token" http://localhost:5000/api/v2/...

The project includes a mitmproxy script (misc/endpoint_discovery.py) for discovering new Kick.com API endpoints:

1. Install mitmproxy requirements:

pip install -r misc/requirements.txt

2. Run mitmproxy with the discovery script:

mitmproxy -s misc/endpoint_discovery.py

The script will automatically capture and document API requests/responses in theapi_docs directory.

docker build -t kick-unofficial-api.

Contributions are welcome! Please feel free to submit a PR. Endpoints are not complete yet.

This project is licensed under the MIT License - see the LICENSE file for details.

• CloudflareBypassForScraping for the Cloudflare bypass solution
• FastAPI for the API framework
• curl-cffi for HTTP request handling to bypass Cloudflare SSL Fingerprinting
• mitmproxy for endpoint discovery

This project is not affiliated with or endorsed by Kick.com. Use responsibly and in accordance with Kick.com's terms of service.