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.

Base Production Endpoint URL: 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 Request Example
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

Python 3.10+ Request Example
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:

KodDurum MetniAçıklama
200OKİstek başarıyla işlendi ve veri döndürüldü.
400Bad RequestEksik veya hatalı biçimlendirilmiş sorgu parametresi.
401UnauthorizedAPI anahtarı eksik, geçersiz veya süresi dolmuş.
429Too Many RequestsDakikalık istek kotası aşıldı (Retry-After başlığı döner).
500Internal Server ErrorMerkezi 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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUSorgulanacak e-posta, kullanıcı adı, IP veya telefon verisi
sourceStringOpsiyonelÖzel kaynak filtresi (varsayılan: all)
POST /search/multi
curl -X POST "https://api.bytearchive.io/search/multi" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "query=mesker_80@hotmail.com"
JSON Response (200 OK)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUSorgulanacak e-posta veya hash verisi
POST /search/snusbase
curl -X POST "https://api.bytearchive.io/search/snusbase" -d "query=target@domain-leak.net"
JSON Response (200 OK)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUKasa arama sorgu parametresi
POST /search/vault
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

ParametreTipGereklilikAçıklama
messageStringZORUNLUYapay zeka motoruna iletilecek komut veya analiz sorusu
POST /api/ai/chat
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."}'
JSON Response (200 OK)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUSorgulanacak e-posta adresi
POST /search/seon
curl -X POST "https://api.bytearchive.io/search/seon" -d "query=target@email.com"
JSON Response (200 OK)
{
  "fraud_score": 0,
  "registered_platforms": ["discord", "github", "spotify"],
  "domain_details": {"deliverable": true}
}

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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUDiscord ID veya kullanıcı adı
POST /search/discord
curl -X POST "https://api.bytearchive.io/search/discord" -d "query=849201938102"
JSON Response (200 OK)
{
  "discord_id": "849201938102",
  "username": "discord_user#0001",
  "avatar_url": "https://cdn.discordapp.com/avatars/..."
}

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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUInstagram kullanıcı adı
POST /search/instagram
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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUEpic Games e-posta adresi veya kullanıcı adı
POST /search/epicgames
curl -X POST "https://api.bytearchive.io/search/epicgames" -d "query=mesker_80@hotmail.com"
JSON Response (200 OK - Match Found)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUSorgulanacak Telegram kullanıcı adı (@ile) veya uluslararası telefon numarası (+90...)
POST /search/telegram
curl -X POST "https://api.bytearchive.io/search/telegram" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "query=@telegram_target"
JSON Response (200 OK)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUSnapchat kullanıcı adı veya e-posta adresi
POST /search/snapchat
curl -X POST "https://api.bytearchive.io/search/snapchat" -d "query=snap_user_official"
JSON Response (200 OK)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLURoblox kullanıcı adı veya oyuncu ID'si
POST /search/roblox
curl -X POST "https://api.bytearchive.io/search/roblox" -d "query=robloxian123"
JSON Response (200 OK)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUCraftrise oyuncu adı veya e-posta
POST /search/craftrise
curl -X POST "https://api.bytearchive.io/search/craftrise" -d "query=enes"
JSON Response (200 OK)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUTikTok kullanıcı adı
POST /search/tiktok
curl -X POST "https://api.bytearchive.io/search/tiktok" -d "query=tiktok_target"
JSON Response (200 OK)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUMinecraft oyuncu adı veya Mojang UUID
POST /search/minecraft
curl -X POST "https://api.bytearchive.io/search/minecraft" -d "query=Notch"
JSON Response (200 OK)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUGitHub kullanıcı adı
POST /search/memory
curl -X POST "https://api.bytearchive.io/search/memory" -d "query=octocat"
JSON Response (200 OK)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLUTelefon numarası (+905...)
POST /search/gsm
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ı

ParametreTipGereklilikAçıklama
ipStringZORUNLUIPv4 veya IPv6 Adresi
POST /ip-info
curl -X POST "https://api.bytearchive.io/ip-info" -d "ip=8.8.8.8"
JSON Response (200 OK)
{
  "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ı

ParametreTipGereklilikAçıklama
queryStringZORUNLU6 Haneli BIN Numarası
POST /search/binlist
curl -X POST "https://api.bytearchive.io/search/binlist" -d "query=454360"
JSON Response (200 OK)
{
  "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ı:

ByteArchive API anahtarını nereden ve nasıl alabilirim?
Kullanıcı panelinizdeki Profil & Ayarlar sayfasına giderek benzersiz 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.
İstek limitini (Rate Limit) aşarsam ne olur?
Varsayılan limit aşıldığında sistem 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.
Epic Games veritabanında arama nasıl işler?
Epic Games sızıntı arşivimiz 83.525 doğrulanmış hesap kaydı içerir. Sorgulanan e-posta veya kullanıcı adı veritabanında bulunursa eşleşen detaylar getirilir; veritabanında bulunmayan sorgularda otomatik olarak "No data found" uyarısı döner.
ByteArchive 0.1 AI nasıl çalışır?
ByteArchive 0.1, siber tehdit istihbaratına ve OSINT sorgularına özel eğitilmiş nöral ağ motorumuzdur. Doğal dil komutlarıyla sızıntı verilerini ilişkilendirir, risk puanlaması yapar ve özet raporlar oluşturur.

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...