WebTrackly API v1

RESTful API pro data o doménách

Přihlásit se Tarify API

Ověření

Všechny požadavky na API vyžadují Bearer token v hlavičce Authorization. Svůj API klíč získáte v API dashboardu po předplacení tarifu API.

Authorization: Bearer YOUR_API_KEY

Rychlý start

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

Základní URL: https://webtrackly.com/api/v1/

Formát: JSON

Metoda: GET

Stránkování: ?page=1 (20 na stránku)

Formát odpovědi

Endpointy pro výpis vracejí stránkované výsledky. Informace o limitech požadavků najdete v hlavičkách odpovědi.

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

Hlavičky odpovědi

Hlavička	Popis
X-RateLimit-Limit	Měsíční limit volání
X-RateLimit-Remaining	Zbývající volání v tomto měsíci
X-RateLimit-Used	Volání využitá v tomto měsíci

Balíčky

GET /api/v1/packages/

Výpis všech balíčků domén (zónové soubory a technologická data). Podporuje filtrování a vyhledávání.

Parametr	Typ	Popis
type	string	Filtrování podle typu: zone, technology, detailed
zone	string	Filtrování podle TLD zóny (např. com, net)
technology	string	Filtrování podle názvu technologie
q	string	Vyhledávání podle názvu
page	int	Číslo stránky (výchozí: 1)

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

Podrobné informace o konkrétním balíčku včetně ukázkových domé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", ...]
}

Datové sady

GET /api/v1/datasets/

Výpis všech prémiových datových sad. Podporuje vyhledávání.

Parametr	Typ	Popis
q	string	Vyhledávání podle názvu nebo popisu
page	int	Číslo stránky (výchozí: 1)

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

Podrobnosti o datové sadě včetně ukázkových dat.

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

Účet

GET /api/v1/account/

Informace o vašem předplatném API, statistiky využití a seznam API klíčů.

{
  "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}
  ]
}

Limity požadavků

Volání API se počítají měsíčně. Limity závisí na vašem tarifu předplatného API.

Tarif	Volání/měsíc	Cena
API Starter	10,000	$29/měs.
API Professional	100,000	$99/měs.
API Enterprise	1,000,000	$299/měs.

Výsledky jsou stránkovány po maximálně 20 položkách na stránku, aby se zabránilo hromadné extrakci dat. Zobrazit tarify

Chyby

Kód	Popis
401	Chybějící nebo neplatný API klíč
403	API klíč je deaktivován nebo předplatné vypršelo
404	Zdroj nenalezen
429	Překročen měsíční limit volání API

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

Ukázky kódu

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"