Kickhat API
Herkese Açık API — v1
Kickhat'in keşif ve arşiv verisinin okuma API'si. Giriş istemeden çalışır, IP başına kotalıdır. Tüm yanıtlar JSON.
Temel
Taban adres:
https://kickhat.net/api/public/v1
Her yanıt tek bir zarfla döner:
{
"ok": true,
"surum": "v1",
"veri": { ... } // uca göre değişen içerik
}Hata durumunda:
{
"ok": false,
"surum": "v1",
"hata": "açıklama"
}Kotalar
IP başına, saatlik. Keşif uçları geniş (300/sa), arşiv uçları dar (60/sa — sorgular ağır olduğu için), anlık izleyici kendi geniş kovasında (1500/sa). Kota aşılınca429 ve Retry-After başlığı döner.
Uçlar
| Uç | Açıklama | Parametreler | Kota |
|---|---|---|---|
GET /channels | Kanal listesi (keşif): arama, dil/kategori filtresi, izleyiciye göre sıralama. | q, dil, kategori, sirala, limit | 300/sa |
GET /channels/{slug} | Tek kanalın detayı: izleyici grafiği, yayın geçmişi, kategori dağılımı. | gun | 300/sa |
GET /channels/{slug}/live | Kanalın o anki canlı izleyici sayısı (sunucu tarafı 15 sn cache). | — | 1500/sa |
GET /rising | Son 1 saatte en çok büyüyen kanallar. | — | 300/sa |
GET /categories | Bilinen kategoriler ve canlı kanal sayıları. | — | 300/sa |
GET /overview | Genel özet: canlı kanal, toplam izleyici, TR sayıları. | — | 300/sa |
GET /search | Chat araması: metin + kullanıcı + kanal + tarih aralığı, tüm arşiv. | q, kullanici, kanal, gun | 60/sa |
GET /viewers/{username} | İzleyici profili: hangi kanallarda yazmış, mesaj sayısı, ilk/son görülme. | — | 60/sa |
GET /leaderboard | Liderlik tabloları (global + kanal). | kanal, gun | 60/sa |
GET /links | Chat'te geçen linkler: domain filtresi, şüpheli domain işareti. | kanal, domain, gun | 60/sa |
Örnek
curl "https://kickhat.net/api/public/v1/channels?dil=tr&sirala=izleyici&limit=5" curl "https://kickhat.net/api/public/v1/channels/poyland/live" curl "https://kickhat.net/api/public/v1/search?q=merhaba&kanal=poyland&gun=7"
PRO / API anahtarı
Şu an tüm uçlar anonim ve IP kotalı. Yüksek kota, derin geçmiş, CSV dışa aktarma ve kişisel API anahtarı PRO ile gelecek. Zarf ve uç adları o zaman da aynı kalacak şekilde versiyonlandı (v1) — bugün yazdığın istemci yarın kırılmaz.