WebTrackly API v1

Alan adı istihbarat verileri için RESTful API

Giriş Yap API Planları

Kimlik Doğrulama

Tüm API istekleri, Authorization başlığında bir Bearer token gerektirir. API anahtarınızı, bir API planına abone olduktan sonra API Panelinden alabilirsiniz.

Authorization: Bearer YOUR_API_KEY

Hızlı Başlangıç

curl "https://webtrackly.com/api/v1/packages/?type=technology&q=wordpress" \
     -H "Authorization: Bearer YOUR_API_KEY"

Temel URL: https://webtrackly.com/api/v1/

Format: JSON

Yöntem: GET

Sayfalama: ?page=1 (20 sayfa başına)

Yanıt Formatı

Liste uç noktaları sayfalanmış sonuçlar döndürür. Hız limiti bilgisi yanıt başlıklarında yer alır.

{
  "results": [...],
  "count": 1511,
  "page": 1,
  "pages": 76,
  "has_next": true
}

Yanıt Başlıkları

Başlık	Açıklama
X-RateLimit-Limit	Aylık çağrı limiti
X-RateLimit-Remaining	Bu ay kalan çağrı sayısı
X-RateLimit-Used	Bu ay kullanılan çağrı sayısı

Paketler

GET /api/v1/packages/

Tüm alan adı paketlerini listeler (bölge dosyaları ve teknoloji verileri). Filtreleme ve aramayı destekler.

Parametre	Tür	Açıklama
type	string	Türe göre filtrele: zone, technology, detailed
zone	string	Bölge TLD'sine göre filtrele (ör. com, net)
technology	string	Teknoloji adına göre filtrele
q	string	Ada göre ara
page	int	Sayfa numarası (varsayılan: 1)

GET /api/v1/packages/{slug}/

Örnek alan adları dahil olmak üzere belirli bir paket hakkında ayrıntılı bilgi alın.

{
  "slug": "com-zone",
  "name": ".com Zone File",
  "package_type": "zone",
  "zone": "com",
  "domain_count": 150000000,
  "price": "49.00",
  "updated_at": "2026-03-08",
  "sample_domains": ["example.com", "test.com", ...]
}

Veri Setleri

GET /api/v1/datasets/

Tüm premium veri setlerini listeler. Aramayı destekler.

Parametre	Tür	Açıklama
q	string	Ada veya açıklamaya göre ara
page	int	Sayfa numarası (varsayılan: 1)

GET /api/v1/datasets/{slug}/

Örnek veriler dahil olmak üzere veri seti ayrıntılarını alın.

{
  "slug": "ecommerce-domains-2026",
  "name": "E-commerce Domains 2026",
  "description": "...",
  "record_count": 500000,
  "price": "99.00",
  "sample": [...]
}

Hesap

GET /api/v1/account/

API abonelik bilgilerinizi, kullanım istatistiklerinizi ve API anahtar listenizi alın.

{
  "subscription": {
    "plan": "API Professional",
    "status": "active",
    "calls_limit": 100000,
    "calls_used": 1523,
    "calls_remaining": 98477,
    "expires_at": "2026-04-08"
  },
  "keys": [
    {"key": "wt_live_abc...xyz", "name": "Production", "is_active": true}
  ]
}

Hız Limitleri

API çağrıları aylık olarak sayılır. Limitler, API abonelik planınıza bağlıdır.

Plan	Çağrı/ay	Fiyat
API Starter	10,000	$29/ay
API Professional	100,000	$99/ay
API Enterprise	1,000,000	$299/ay

Toplu veri çekimini önlemek için sonuçlar sayfa başına en fazla 20 öğe olacak şekilde sayfalanır. Planları görüntüle

Hatalar

Kod	Açıklama
401	API anahtarı eksik veya geçersiz
403	API anahtarı devre dışı veya aboneliğin süresi dolmuş
404	Kaynak bulunamadı
429	Aylık API çağrı limiti aşıldı

{"error": "Rate limit exceeded", "limit": 10000, "used": 10000}

Kod Örnekleri

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://webtrackly.com/api/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# Search technology packages
r = requests.get(f"{BASE}/packages/", headers=headers,
                 params={"type": "technology", "q": "wordpress"})
for pkg in r.json()["results"]:
    print(f"{pkg['name']}: {pkg['domain_count']} domains")

# Check usage
r = requests.get(f"{BASE}/account/", headers=headers)
info = r.json()["subscription"]
print(f"Used {info['calls_used']}/{info['calls_limit']}")

JavaScript

const API_KEY = 'YOUR_API_KEY';
const BASE = 'https://webtrackly.com/api/v1';
const headers = { 'Authorization': `Bearer ${API_KEY}` };

// Search packages
const res = await fetch(`${BASE}/packages/?type=zone&q=com`, { headers });
const data = await res.json();
data.results.forEach(pkg =>
    console.log(`${pkg.name}: ${pkg.domain_count} domains`)
);

// Check rate limits from headers
console.log('Remaining:', res.headers.get('X-RateLimit-Remaining'));

PHP

$apiKey = 'YOUR_API_KEY';
$base = 'https://webtrackly.com/api/v1';

$ch = curl_init("$base/packages/?type=technology&q=wordpress");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $apiKey"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($result['results'] as $pkg) {
    echo "- {$pkg['name']}: {$pkg['domain_count']} domains\n";
}

cURL

# List zone packages
curl "https://webtrackly.com/api/v1/packages/?type=zone" \
     -H "Authorization: Bearer YOUR_API_KEY"

# Get package details
curl "https://webtrackly.com/api/v1/packages/com-zone/" \
     -H "Authorization: Bearer YOUR_API_KEY"

# Check account usage
curl "https://webtrackly.com/api/v1/account/" \
     -H "Authorization: Bearer YOUR_API_KEY"