API Kullanım Kılavuzu
ByteArchive RESTful API entegrasyonu, yetkilendirme standartları, multi-search motoru ve sızıntı veritabanı sorgulama metodlarının detaylı rehberi.
Giriş ve Sistem Mimarisi
ByteArchive REST API; güvenlik araştırmacıları, siber analiz uzmanları ve adli bilişim ekipleri için tasarlanmış yüksek hızlı bir istihbarat arayüzüdür. Platformumuz 410M+ sızdırılmış veritabanı kaydını, canlı sosyal medya veri problarını (Instagram, Discord, Telegram, TikTok, Craftrise), Epic Games breach verilerini ve ByteArchive 0.1 yapay zeka nöral ağ analiz motorunu doğrudan uygulamanıza entegre etmenizi sağlar.
https://api.bytearchive.io/api/v2/
Kimlik Doğrulama (Authentication & Security)
Tüm API istekleri yetkilendirilmiş Bearer Token başlığı gerektirir. Kullanıcı panelinizin Profil & Ayarlar bölümünden oluşturabileceğiniz canlı erişim anahtarlarınız ba_live_ öneki ile başlar. Tüm iletişim 256-bit TLS v1.3 şifrelemesi ile korunmaktadır.
cURL Örnek İstek
curl -X GET "https://api.bytearchive.io/api/v2/search?query=target@email.com" \
-H "Authorization: Bearer ba_live_59102938102938" \
-H "Accept: application/json"
Python SDK Entegrasyon Örneği
import requests
api_key = "ba_live_59102938102938"
url = "https://api.bytearchive.io/api/v2/search"
headers = {
"Authorization": f"Bearer {api_key}",
"Accept": "application/json"
}
params = {"query": "mesker_80@hotmail.com"}
response = requests.get(url, headers=headers, params=params)
print(response.json())
İstek Sınırlamaları (Rate Limits & Quotas)
Sistem kaynaklarının adil kullanımı ve yüksek erişilebilirlik için tüm hesap türlerine göre uyarlanmış dakikalık ve günlük istek kotaları uygulanmaktadır.
| Paket Seviyesi | Dakikalık Limit | Günlük Kota | Eşzamanlı Bağlantı |
|---|---|---|---|
| Free Tier | 10 Istek / dk | 500 Sorgu | 1 Bağlantı |
| Premium Tier | 60 Istek / dk | Sınırsız | 5 Bağlantı |
| Enterprise Tier | 300 Istek / dk | Sınırsız | 20 Bağlantı |
HTTP Durum ve Hata Kodları
ByteArchive API standart HTTP durum kodları kullanarak yanıt döner:
| Kod | Durum Metni | Açıklama |
|---|---|---|
| 200 | OK | İstek başarıyla işlendi ve veri döndürüldü. |
| 400 | Bad Request | Eksik veya hatalı biçimlendirilmiş sorgu parametresi. |
| 401 | Unauthorized | API anahtarı eksik, geçersiz veya süresi dolmuş. |
| 429 | Too Many Requests | Dakikalık istek kotası aşıldı (Retry-After başlığı döner). |
| 500 | Internal Server Error | Merkezi arama düğümünde geçici sunucu hatası. |
Multi Search (Çoklu Tarama Motoru)
Multi Search uç noktası, girilen hedef veriyi (E-posta, Kullanıcı Adı, IP Adresi veya Telefon) platform bünyesindeki tüm aktif veritabanlarında (Epic Games, Discord, Snusbase, Instagram, Craftrise vb.) eşzamanlı olarak tarar ve birleştirilmiş istihbarat raporu üretir.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Sorgulanacak e-posta, kullanıcı adı, IP veya telefon verisi |
| source | String | Opsiyonel | Özel kaynak filtresi (varsayılan: all) |
curl -X POST "https://api.bytearchive.io/search/multi" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "query=mesker_80@hotmail.com"
{
"status": "success",
"query": "mesker_80@hotmail.com",
"total_matches": 1,
"data": [
{
"source": "Epic Games Breach Records DB",
"username": "mesker_80",
"email": "mesker_80@hotmail.com",
"account_id": "EPIC_98102938",
"leak_date": "2026-02-20"
}
]
}
Snusbase API Integration
Sızdırılmış küresel hesap dizinlerinde e-posta, kullanıcı adı, şifre karması (MD5/SHA1/Bcrypt) ve IP adresi sorgulaması gerçekleştiren yüksek hızlı veritabanı indeksleyicisi.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Sorgulanacak e-posta veya hash verisi |
curl -X POST "https://api.bytearchive.io/search/snusbase" -d "query=target@domain-leak.net"
{
"source": "Snusbase DB Index",
"matches": 1,
"data": [{"email": "target@domain-leak.net", "hash": "5f4dcc3b5aa765d61d8327deb882cf99"}]
}
ByteArchive Vault Core Engine
Platforma özel olarak indekslenmiş, halka açık olmayan özel sızıntı arşivlerine ve güncel veri sızıntısı kayıtlarına doğrudan güvenli erişim sağlayan ana motor.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Kasa arama sorgu parametresi |
curl -X POST "https://api.bytearchive.io/search/vault" -d "query=secure_vault_target"
ByteArchive 0.1 AI Analyst Engine
Siber güvenlik, hedef profil çıkarma ve OSINT verisi ilişkilendirme işlemleri için geliştirilmiş yapay zeka nöral ağ analiz motorudur. Doğal dilde gönderilen karmaşık istihbarat sorularını ve sızıntı çıktılarımı analiz edip özet raporlar üretir.
API Parametreleri
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| message | String | ZORUNLU | Yapay zeka motoruna iletilecek komut veya analiz sorusu |
curl -X POST "https://api.bytearchive.io/api/ai/chat" \
-H "Content-Type: application/json" \
-d '{"message": "Sızdırılmış mesker_80@hotmail.com hesabı için OSINT güvenlik özeti ve risk analizi yap."}'
{
"response": "Target e-posta adresi Epic Games sızıntı veritabanında tespit edilmiştir (Account ID: EPIC_98102938). Parola yenilenmesi önerilir."
}
SEON Intelligence & Fraud Risk API
E-posta adresleri üzerinden dijital ayak izi tespiti, dolandırıcılık risk puanlaması ve sosyal platform kayıt (Discord, Telegram, GitHub, Spotify) doğrulaması gerçekleştirir.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Sorgulanacak e-posta adresi |
curl -X POST "https://api.bytearchive.io/search/seon" -d "query=target@email.com"
{
"fraud_score": 0,
"registered_platforms": ["discord", "github", "spotify"],
"domain_details": {"deliverable": true}
}
Instagram Live OSINT Probe
Instagram kullanıcı adı üzerinden canlı web tarama API'si ile profil resmi, takipçi sayıları, biyografi, gönderiler ve ilişkili e-posta izlerini sorgular.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Instagram kullanıcı adı |
curl -X POST "https://api.bytearchive.io/search/instagram" -d "query=ladygaga"
Epic Games OSINT Engine (83.525 Real Records)
Epic Games oyuncu veritabanı (epicgames.txt) üzerinde e-posta veya kullanıcı adı araması gerçekleştirir. Arama sonucunda doğrulanmış e-posta adresi, kullanıcı adı ve benzersiz Epic ID eşleşmesi döndürülür. Eşleşmeyen aramalarda temiz bir şekilde No data found döner.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Epic Games e-posta adresi veya kullanıcı adı |
curl -X POST "https://api.bytearchive.io/search/epicgames" -d "query=mesker_80@hotmail.com"
{
"username": "mesker_80",
"email": "mesker_80@hotmail.com",
"account_id": "EPIC_84102948",
"source": "Epic Games Breach Records DB",
"leak_date": "2026-02-20"
}
Telegram OSINT & Channel Archive
Telegram kullanıcı adı (@username) ve telefon numarası eşleşmesi üzerinden halka açık Telegram kanallarındaki sızıntı kayıtlarını, grup üyelik izlerini ve kanal mesaj geçmişlerini sorgulayan yüksek verimli siber istihbarat modülü.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Sorgulanacak Telegram kullanıcı adı (@ile) veya uluslararası telefon numarası (+90...) |
curl -X POST "https://api.bytearchive.io/search/telegram" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "query=@telegram_target"
{
"telegram_id": "1920194812",
"username": "telegram_target",
"first_name": "Alex",
"channels_count": 14,
"leaked_messages_found": true,
"source": "Telegram Channel Crawler & Breach Index"
}
Snapchat OSINT Probe
Snapchat kullanıcı adı doğrulama, Bitmoji avatar görseli, bağlı Snapcode ve halka açık hikaye kayıtlarının analizi. E-posta adresi ile Snapchat hesap varlığı sorgulanabilir.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Snapchat kullanıcı adı veya e-posta adresi |
curl -X POST "https://api.bytearchive.io/search/snapchat" -d "query=snap_user_official"
{
"username": "snap_user_official",
"display_name": "Snap User",
"bitmoji_avatar": "https://images.bitmoji.com/3d/avatar/...",
"account_status": "Active"
}
Roblox OSINT & Gaming Leak DB
Roblox gaming kullanıcı hesapları, kayıtlı e-postalar, oyuncu ID'si, robux rozetleri ve sızdırılmış veritabanı kayıtları sorgu uç noktası.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Roblox kullanıcı adı veya oyuncu ID'si |
curl -X POST "https://api.bytearchive.io/search/roblox" -d "query=robloxian123"
{
"roblox_id": "9810293",
"username": "robloxian123",
"created_at": "2020-04-12",
"badge_count": 48
}
Craftrise Intelligence Engine
Craftrise Türkiye sunucu veritabanı sızıntıları ve canlı üye dizini üzerinden oyuncu isimleri, kayıtlı e-postalar, VIP dereceleri ve son giriş tarihleri sorgulama uç noktası.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Craftrise oyuncu adı veya e-posta |
curl -X POST "https://api.bytearchive.io/search/craftrise" -d "query=enes"
{
"username": "enes",
"rank": "RISE VIP",
"coins": 14500,
"source": "Craftrise Active Player DB"
}
TikTok OSINT & SecUID Probe
TikTok kullanıcı adı, benzersiz sec_uid değeri ve e-posta ilişkisi verilerini sorgulama uç noktası. Canlı profil verileri, doğrulama rozetleri ve takipçi analizi sunar.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | TikTok kullanıcı adı |
curl -X POST "https://api.bytearchive.io/search/tiktok" -d "query=tiktok_target"
{
"username": "tiktok_target",
"sec_uid": "MS4wLjABAAAA...",
"followers": 254000,
"verified": true
}
Minecraft / Mojang Intelligence
Minecraft oyuncu isimleri, Mojang benzersiz UUID değerleri, geçmiş isim değişiklikleri zaman çizelgesi, orijinal cilt (skin) dosyaları ve veritabanı sızıntı eşleşmeleri.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Minecraft oyuncu adı veya Mojang UUID |
curl -X POST "https://api.bytearchive.io/search/minecraft" -d "query=Notch"
{
"uuid": "069a79f4-44e9-4726-a5be-fef90e38aaf5",
"username": "Notch",
"name_history": [{"name": "Notch", "changedToAt": 0}]
}
Memory.lol (GitHub Footprint)
GitHub ve yazılımcı hesaplarının geçmiş kullanıcı adı değiştirme zaman çizelgelerini, commit e-posta adreslerini ve dijital ayak izi geçmişini arşivleyen sorgu servisi.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | GitHub kullanıcı adı |
curl -X POST "https://api.bytearchive.io/search/memory" -d "query=octocat"
{
"account": "octocat",
"history": [{"username": "octocat", "valid_from": "2011-01-25"}]
}
GSM / Identity Lookup API
Telefon numaraları ve kimlik veritabanı kaynaklarında operatör tespiti (Turkcell, Vodafone, Türk Telekom), hat tipi (Postpaid/Prepaid) ve sızıntı eşleşmeleri sorgu servisi.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | Telefon numarası (+905...) |
curl -X POST "https://api.bytearchive.io/search/gsm" -d "query=+905550000000"
RDAP / WHOIS & IP Geolocation
IP adreslerinin coğrafi konumu, internet servis sağlayıcısı (ISP), açık portlar, ASN bilgisi, proxy/VPN tespiti ve alan adı WHOIS sahiplik analizi.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| ip | String | ZORUNLU | IPv4 veya IPv6 Adresi |
curl -X POST "https://api.bytearchive.io/ip-info" -d "ip=8.8.8.8"
{
"ip": "8.8.8.8",
"country": "United States",
"isp": "Google LLC",
"asn": "AS15169",
"is_proxy": false
}
Binlist CC Intelligence API
Kredi kartı ve banka kartlarının ilk 6 haneli BIN numarasından veren banka adı, şema (Visa/Mastercard), kart tipi (Debit/Credit), seviyesi (Gold/Platinum) ve ülke tespiti.
Parametre Detayları
| Parametre | Tip | Gereklilik | Açıklama |
|---|---|---|---|
| query | String | ZORUNLU | 6 Haneli BIN Numarası |
curl -X POST "https://api.bytearchive.io/search/binlist" -d "query=454360"
{
"bin": "454360",
"bank": "Garanti BBVA",
"scheme": "VISA",
"type": "CREDIT",
"country": "Turkey"
}
Favoriler & Sorgu Arşivi API
Sık yapılan sorgulamaları kişisel favori listenize ekleme, kaydetme ve geçmiş aramaları yönetme uç noktası.
FAQ / Sıkça Sorulan Sorular (Detaylı Kılavuz)
ByteArchive API kullanımı, oran limitleri, güvenlik standartları ve entegrasyon süreçleri hakkında en sık sorulan geliştirici soruları:
ba_live_ API anahtarınızı oluşturabilirsiniz. Anahtarınızı güvende tutmalı ve istemci tarafı (frontend) kodlarında asla açıkça paylaşmamalısınız.
HTTP 429 Too Many Requests hatası döner. Yanıt başlığındaki Retry-After değeri kadar saniye bekledikten sonra yeni istek gönderebilirsiniz. Premium üyeliklerde limitler artırılır.
Canlı API Test Konsolu (Live Interactive Tester)
Sistemden ayrılmadan canlı API anahtarınız ile anlık istek gönderip JSON yanıtlarını test edin.
// İstek göndermek için yukarıdaki butona tıklayın...
Discord OSINT Intelligence Engine
Discord kullanıcı kimlik numarası (ID), kullanıcı adı veya e-posta üzerinden üyelik geçmişi, sunucu veri tabanı sızıntıları ve ilişkili hesap verilerini getirir.
Parametre Detayları