WebTrackly API v1

API REST zapewniające dostęp do danych analitycznych o domenach

Zaloguj się Plany API

Uwierzytelnianie

Wszystkie zapytania do API wymagają tokenu Bearer w nagłówku Authorization. Klucz API znajdziesz w Panelu API po wykupieniu planu API.

Authorization: Bearer YOUR_API_KEY

Szybki start

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

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

Format: JSON

Metoda: GET

Paginacja: ?page=1 (20 na stronę)

Format odpowiedzi

Endpointy listujące zwracają wyniki podzielone na strony. Informacje o limitach zapytań znajdują się w nagłówkach odpowiedzi.

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

Nagłówki odpowiedzi

Nagłówek	Opis
X-RateLimit-Limit	Miesięczny limit wywołań
X-RateLimit-Remaining	Pozostałe wywołania w tym miesiącu
X-RateLimit-Used	Wywołania wykorzystane w tym miesiącu

Pakiety

GET /api/v1/packages/

Lista wszystkich pakietów domen (pliki stref i dane o technologiach). Obsługuje filtrowanie i wyszukiwanie.

Parametr	Typ	Opis
type	string	Filtruj według typu: zone, technology, detailed
zone	string	Filtruj według TLD strefy (np. com, net)
technology	string	Filtruj według nazwy technologii
q	string	Szukaj według nazwy
page	int	Numer strony (domyślnie: 1)

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

Pobierz szczegółowe informacje o wybranym pakiecie, wraz z przykładowymi domenami.

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

Zbiory danych

GET /api/v1/datasets/

Lista wszystkich zbiorów danych premium. Obsługuje wyszukiwanie.

Parametr	Typ	Opis
q	string	Szukaj według nazwy lub opisu
page	int	Numer strony (domyślnie: 1)

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

Pobierz szczegóły zbioru danych wraz z przykładowymi danymi.

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

Konto

GET /api/v1/account/

Pobierz informacje o swojej subskrypcji API, statystyki użycia i listę kluczy API.

{
  "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 zapytań

Wywołania API rozliczane są miesięcznie. Limity zależą od wybranego planu subskrypcji API.

Plan	Wywołań/mies.	Cena
API Starter	10,000	$29/mies.
API Professional	100,000	$99/mies.
API Enterprise	1,000,000	$299/mies.

Wyniki są dzielone na strony, maksymalnie 20 pozycji na stronę, aby zapobiec masowemu pobieraniu danych. Zobacz plany

Błędy

Kod	Opis
401	Brak klucza API lub nieprawidłowy klucz
403	Klucz API wyłączony lub subskrypcja wygasła
404	Nie znaleziono zasobu
429	Przekroczono miesięczny limit wywołań API

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

Przykłady kodu

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"