Findcord API

Discord verilerine erişmenin en kolay yolu — herkes için anlaşılır kılavuz

Findcord API Nedir?

Findcord API, Discord platformundaki halka açık verilere programatik olarak erişmeni sağlayan bir köprüdür. Kendi sitenle, botunla veya uygulamanla bu verileri birlikte kullanabilirsin — sıfırdan veri toplama derdi olmadan.

Hızlı sorgulama

Discord ID'si ile saniyeler içinde profil bilgisi.

Güvenli

Sadece halka açık veri. Gizli profillere saygı duyar.

Ücretsiz

Kişisel projeler için anahtar talebi ile ücretsiz erişim.

Discord, dünyanın en büyük topluluk platformlarından biri. Findcord, bu platformdaki kullanıcı etkileşimlerini, sunucu istatistiklerini ve geçmişi etik bir şekilde derler ve sana açar. Sen de bu veriyi kendi projende kullanabilirsin.

Neler Yapabilirsin?

Findcord API ile bir Discord kullanıcısı veya sunucusu hakkında merak ettiğin pek çok şeyi öğrenebilirsin. Aşağıda en sık kullanılan örnekler:

Kullanıcı Profili

Bir Discord kullanıcısının kullanıcı adı geçmişi, avatarı, hesap açılış tarihi ve halka açık profil bilgilerine ulaşabilirsin.

Aktivite Verisi

Bir kullanıcının hangi saatlerde aktif olduğunu, toplam mesaj sayısını ve ses kanallarında ne kadar zaman geçirdiğini görebilirsin.

Sunucu Bilgileri

Discord sunucularının üye sayısı, boost durumu, sahibi ve aktif kullanıcılarını listeleyebilirsin.

Liderlik Tablosu

En aktif kullanıcılar, en çok mesaj atanlar veya en uzun ses kanallarında olanlar — hepsini sıralı şekilde alabilirsin.

Sicil Geçmişi

Bir kullanıcının daha önce hangi sunucularda susturma, ban veya uyarı aldığını öğrenebilirsin.

Booster Listesi

Bir Discord sunucusunu boost'layan kullanıcıların listesini ve ne kadar süredir boost'ladıklarını görebilirsin.

Nasıl Başlarım?

3 basit adımda Findcord API kullanmaya başlayabilirsin. İşin teknik kısmı azdır — internet üzerinden bir istek atabilen herhangi bir araçla çalışır.

1

API anahtarı al

Siteye giriş yap ve Ayarlar → API Keylerim sayfasından “API Key Oluştur” de. Anahtarın anında hazır — başvuru veya bekleme yok.

2

İlk isteğini at

Aldığın anahtar ile bir Discord kullanıcısının ID'sini sorgula — sana o kullanıcı hakkındaki halka açık bilgiyi JSON formatında dönecektir.

3

Projende kullan

Gelen veriyi kendi sitende, botunda veya uygulamanda göstermeye başla. Verinin kaynağı olarak Findcord'u belirtmeyi unutma.

İpucu: İlk olarak sistemin canlı olup olmadığını test etmek istersen sistem durumu sayfasından kontrol edebilirsin — anahtara gerek yok.

Sınırlar

Sistemi herkes için adil ve hızlı tutmak amacıyla bazı sınırlar koyuyoruz. Bu sınırlar normal kullanımda fark edilmez; sadece çok yüksek hacimli isteklerde devreye girer.

IP başına (genel)

15 saniyede 75 istek

IP başına (public API)

60 saniyede 60 istek → 10 dakika blok

Ani yığılma (burst)

saniyede 5 istek → 30 saniye blok

Anahtar başına

60 saniyede 20 istek

Yüksek limitli anahtar

60 saniyede 60 istek (IP kovası uygulanmaz)

Limit aşımı cezası

5 dakika blok

Farklı kullanıcı ID'si

5 dakikada 30

Farklı sunucu ID'si

5 dakikada 50

Geçersiz anahtar denemesi

5 dakikada 10 deneme → 30 dakika IP ban

Anahtar başına farklı IP

5 dakikada 3 farklı IP → 5 dakika blok

Limit aşıldığında ne olur?

Sistem "çok fazla istek" uyarısı döndürür ve cevapla birlikte kaç saniye beklemen gerektiğini bildirir. O süreyi bekledikten sonra normal şekilde isteklerine devam edebilirsin. Hesabın kapatılmaz; sadece geçici bir bekleme uygulanır.

Anahtarını tek IP adresinden kullan

Bir API anahtarı tek bir IP adresinden kullanılmak üzere tasarlanmıştır. Aynı anahtar 5 dakikalık pencerede 3 farklı IP adresinden kullanılırsa hem anahtar hem de ilgili IP 5 dakika boyunca engellenir (403). Bu koruma, çalınmış veya paylaşılmış bir anahtarın proxy ağları üzerinden dağıtık DDoS ve scraping saldırılarında kullanılmasını engeller. Anahtarını istemci tarafı koda (tarayıcı JavaScript'i, mobil uygulama) gömme — oradan gelen her istek farklı bir IP'den geleceği için anahtarın anında engellenir. İstekleri kendi sunucun üzerinden geçir. Birden fazla sunucudan çağırman gerekiyorsa discord.gg/findcord adresinden bize ulaş.

Sıkça Sorulan Sorular

Üzerine tıklayarak yanıtı genişletebilirsin.

Findcord API ücretli mi?

Hayır, API erişimi ücretsiz. Anahtarını Ayarlar → API Keylerim sayfasından kendin oluşturursun; kimseden izin veya talep gerekmez. Yalnızca standart limitin (dakikada 20 istek) yetmediği yüksek hacimli kullanımlar için Discord sunucumuzdan bize ulaşman gerekir.

Verilerin kaynağı ne?

Sadece Discord platformunda herkese açık olan veriler — kullanıcı adları, profil resimleri, sunucu bilgileri ve sunucularda görünür olan etkinlikler. Özel mesajlara veya kapalı kanallara erişimimiz yoktur.

Bir kullanıcı kendi profilini gizleyebilir mi?

Evet. Bir kullanıcı Findcord'a giriş yapıp gizlilik ayarlarından profilini gizleyebilir. O zaman API üzerinden bilgileri sorgulansa bile veri 'gizli' olarak işaretlenir ve döndürülmez.

Verileri kullanırken neye dikkat etmeliyim?

Discord'un Topluluk Kuralları ve gizlilik politikalarına uymalısın. Kullanıcıların verilerini taciz, dolandırıcılık veya kötüye kullanım için kullanmak yasaktır.

Verileri kendi sitemde / botumda gösterebilir miyim?

Evet, kişisel projelerinde, botlarında ve sitenide gösterebilirsin. Yalnızca veri kaynağı olarak Findcord'u belirtmen ve kullanım kurallarına uyman gerekir.

Çok fazla istek atarsam ne olur?

Kısa süreliğine engellenmiş olursun. Sistem 'çok fazla istek' uyarısı döndürür ve birkaç saniye veya dakika beklemen gerekir. Limitleri aşağıdaki bölümde inceleyebilirsin.

API key'im sızdı, ne yapmalıyım?

Kimseye yazmana gerek yok, kendin halledebilirsin. Siteye giriş yap, Ayarlar → API Keylerim sayfasından "Yeniden Oluştur" de. Eski anahtar anında iptal olur ve yerine yenisi verilir.

Geliştiriciler İçin

Teknik detaylar burada. Eğer kod yazmıyorsan bu kısmı atlayabilirsin.

Base URL

https://app.findcord.com/v1

Format

JSON, REST mantığında

Kimlik doğrulama

Her isteğe Authorization başlığı ekleyerek anahtarını gönder:

Authorization: ApiKey YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY
Authorization: YOUR_API_KEY

Üç biçim de geçerlidir; önek zorunlu değildir.

Hızlı örnek

Bir kullanıcının profilini sorgulamak için:

bash
curl -H "Authorization: ApiKey YOUR_KEY" \
  https://app.findcord.com/v1/user/793766950060818443

JavaScript ile

javascript
const res = await fetch('https://app.findcord.com/v1/user/' + userId, {
  headers: { 'Authorization': 'ApiKey ' + process.env.FINDCORD_KEY }
});
const data = await res.json();

Endpoint'ler

İki yanıt şekli var: /user ve /sorgu doğrudan bir nesne döner; diğer uçlar yanıtı { success, data } içinde sarar. Bu ayrım eski entegrasyonlar kırılmasın diye korunuyor.

Kullanıcı profili
GEThttps://app.findcord.com/v1/user/:id

Bir Discord kullanıcısının FindCord profilini döner.

Parametreler
  • id (zorunlu) — Discord kullanıcı/sunucu ID'si (17-20 haneli sayı).
Yanıt: doğrudan nesne (sarmalayıcısız)Önbellek: 10 sn

Kullanıcı premium/gizli statüdeyse 405 PREMIUM_USER döner. 5 dakikada en fazla 30 farklı kullanıcı ID'si sorgulanabilir.

Kullanıcı sorgusu (eski ad)
GEThttps://app.findcord.com/v1/sorgu/:id

/user/:id ile aynı yanıtı döner. Eski isim/yaş sorgusu entegrasyonları için korunuyor; TopName, TopAge, TopSex ve displayNames alanları bu yanıtın içinde.

Parametreler
  • id (zorunlu) — Discord kullanıcı/sunucu ID'si (17-20 haneli sayı).
Yanıt: doğrudan nesne (sarmalayıcısız)Önbellek: 10 sn

Aynı handler, aynı yanıt. 5 dakikada en fazla 30 farklı kullanıcı ID'si.

Sunucu listesi
GEThttps://app.findcord.com/v1/servers

Takip edilen sunucuların listesini döner.

Parametreler
  • type (opsiyonel) — Liste tipi. Değerler: 0, 1. Varsayılan: 0.
  • sort (opsiyonel) — Sıralama ölçütü. Değerler: memberCount, boostCount, totalVoice, voiceCount, cameraCount, streamCount, RealVoiceCount. Varsayılan: memberCount.
Yanıt: { success, data }Önbellek: 60 sn
Sunucu detayı
GEThttps://app.findcord.com/v1/servers/:id

Tek bir sunucunun ayrıntılarını döner.

Parametreler
  • id (zorunlu) — Discord kullanıcı/sunucu ID'si (17-20 haneli sayı).
Yanıt: { success, data }Önbellek: 30 sn

5 dakikada en fazla 50 farklı sunucu ID'si sorgulanabilir.

Sunucu emoji ve çıkartmaları
GEThttps://app.findcord.com/v1/servers/:id/emojis

Sunucunun kendi emoji/çıkartma kataloğunu kullanım sayaçlarıyla döner. Yanıt üç liste içerir: Own (sunucunun kendi emoji/çıkartmaları), External (sunucuda kullanılan başka sunucuların emojileri) ve Unicode (standart emojiler). Ayrıca Summary alanında toplam, animasyonlu, hiç kullanılmayan ve silinmiş sayıları gelir.

Parametreler
  • id (zorunlu) — Discord kullanıcı/sunucu ID'si (17-20 haneli sayı).
  • kind (opsiyonel) — Emoji mi çıkartma mı listeleneceği. Değerler: emoji, sticker. Varsayılan: emoji.
  • sort (opsiyonel) — Sıralama ölçütü. unused bir FİLTREdir: yalnızca hiç kullanılmamış ve silinmemiş kayıtları döner. Değerler: total, recent, name, unused. Varsayılan: total.
  • limit (opsiyonel) — Own listesindeki azami kayıt sayısı (1-250). Varsayılan: 100.
Yanıt: { success, data }Önbellek: 60 sn

Sayaçlar takip başlangıcından beri birikir, geriye dönük veri yoktur. Silinmiş emojiler RemovedAt alanıyla listede kalır. 5 dakikada en fazla 50 farklı sunucu ID'si sorgulanabilir.

Sıralama
GEThttps://app.findcord.com/v1/leaderboard

Kullanıcı sıralamasını döner.

Parametreler
  • type (opsiyonel) — Sıralama türü (en fazla 20 karakter).
  • limit (opsiyonel) — Kayıt sayısı (en fazla 20 karakter).
  • page (opsiyonel) — Sayfa numarası (en fazla 20 karakter).
Yanıt: { success, data }Önbellek: 30 sn

Tanımsız bir query parametresi gönderilirse istek reddedilir.

Sicil kayıtları
GEThttps://app.findcord.com/v1/sicil/:id

Bir kullanıcının ceza/sicil kayıtlarını döner.

Parametreler
  • id (zorunlu) — Discord kullanıcı/sunucu ID'si (17-20 haneli sayı).
Yanıt: { success, data }Önbellek: 10 sn

5 dakikada en fazla 30 farklı kullanıcı ID'si sorgulanabilir.

Limitler

IP başına (genel)15 saniyede 75 istek
IP başına (public API)60 saniyede 60 istek → 10 dakika blok
Ani yığılma (burst)saniyede 5 istek → 30 saniye blok
Anahtar başına60 saniyede 20 istek
Yüksek limitli anahtar60 saniyede 60 istek (IP kovası uygulanmaz)
Limit aşımı cezası5 dakika blok
Farklı kullanıcı ID'si5 dakikada 30
Farklı sunucu ID'si5 dakikada 50
Geçersiz anahtar denemesi5 dakikada 10 deneme → 30 dakika IP ban
Anahtar başına farklı IP5 dakikada 3 farklı IP → 5 dakika blok

Her yanıtta X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıkları döner. Limit aşımında (429) Retry-After gelir. Önbellekten dönen yanıtlarda X-Cache: HIT bulunur.

Tek istisna: durum kontrolü için https://app.findcord.com/api/ping ucu anahtarsız çalışır. Bu ucun /v1 altında karşılığı yoktur; anahtarsız izleme araçları kırılmasın diye eski yolda bırakılmıştır.

Hata kodları

400VALIDATION_ERRORParametre gecersiz: tanimsiz query alani, hatali sıralama degeri veya bozuk Discord ID.
401API_KEY_REQUIREDAnahtar gönderilmedi veya geçersiz.
403IP_BANNEDIP adresi geçici olarak engellendi.
403MULTI_IP_ABUSEAnahtar 5 dakika içinde 3 farklı IP'den kullanıldı; anahtar 5 dakika engellendi.
403KEY_BLOCKEDAnahtar çoklu IP kullanımı nedeniyle engelli. 5 dakika sonra tekrar deneyin.
403IP_BLOCKEDIP adresiniz çoklu IP kullanımı nedeniyle engelli. 5 dakika sonra tekrar deneyin.
405PREMIUM_USERKullanıcı premium/gizli statüde, erişim yok.
429RATE_LIMITEDGlobal IP limiti aşıldı (15 saniyede 75 istek).
429KEY_RATE_LIMITEDAnahtar limiti aşıldı (dakikada 20, yüksek limitli anahtarda 60).
429BURST_LIMITEDSaniyede 5 istek sınırı aşıldı; 30 saniye beklemek gerekir.
429IP_RATE_LIMITEDPublic API IP limiti aşıldı (dakikada 60).
429ENUM_LIMITEDKısa sürede çok fazla farklı ID sorgulandı.

Hata yanıtı her zaman şu şekildedir: { success: false, error: { code, message } }

Eski entegrasyonlar app.findcord.com/api/* ve api.findcord.com/api/* yollarını kullanıyor. Bu yolların ikisi de çalışmaya devam ediyor ve kapatılmayacak; api.findcord.com adresi de aynı API'ye çıkar. Yeni entegrasyonlarda https://app.findcord.com/v1 kullanın.

İletişim

Soru, öneri, yüksek limit talebi veya sorun bildirimi için Discord sunucumuzdan bize ulaşabilirsin. Tüm iletişimimizi oradan yürütüyoruz. Genelde 1–2 iş günü içinde yanıt veririz.

Discord Sunucusu

discord.gg/findcord

Yanıt Süresi

Genellikle 1-2 iş günü

Findcord topluluğuna katılmak ve gelişmeleri takip etmek istersen Discord sunucumuza beklerim.