WebTrackly API v1

API RESTful pentru date detaliate despre domenii

Autentificare Planuri API

Autentificare

Toate cererile API necesită un token Bearer în antetul Authorization. Obține cheia API din panoul API după ce te abonezi la un plan API.

Authorization: Bearer YOUR_API_KEY

Ghid rapid

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

URL de bază: https://webtrackly.com/api/v1/

Format: JSON

Metodă: GET

Paginare: ?page=1 (20 pe pagină)

Formatul răspunsului

Endpoint-urile de tip listă returnează rezultate paginate. Informațiile despre limitele de rată sunt incluse în antetele răspunsului.

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

Antetele răspunsului

Antet	Descriere
X-RateLimit-Limit	Limita lunară de apeluri
X-RateLimit-Remaining	Apeluri rămase luna aceasta
X-RateLimit-Used	Apeluri folosite luna aceasta

Pachete

GET /api/v1/packages/

Listează toate pachetele de domenii (fișiere de zonă și date despre tehnologii). Acceptă filtrare și căutare.

Parametru	Tip	Descriere
type	string	Filtrează după tip: zone, technology, detailed
zone	string	Filtrează după TLD-ul zonei (ex. com, net)
technology	string	Filtrează după numele tehnologiei
q	string	Caută după nume
page	int	Numărul paginii (implicit: 1)

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

Obține informații detaliate despre un anumit pachet, inclusiv domenii de exemplu.

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

Seturi de date

GET /api/v1/datasets/

Listează toate seturile de date premium. Acceptă căutare.

Parametru	Tip	Descriere
q	string	Caută după nume sau descriere
page	int	Numărul paginii (implicit: 1)

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

Obține detaliile setului de date, inclusiv date de exemplu.

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

Cont

GET /api/v1/account/

Obține informații despre abonamentul tău API, statistici de utilizare și lista cheilor 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}
  ]
}

Limite de rată

Apelurile API sunt contorizate lunar. Limitele depind de planul tău de abonament API.

Plan	Apeluri/lună	Preț
API Starter	10,000	$29/lună
API Professional	100,000	$99/lună
API Enterprise	1,000,000	$299/lună

Rezultatele sunt paginate, cu maximum 20 de elemente pe pagină, pentru a preveni extragerea datelor în masă. Vezi planurile

Erori

Cod	Descriere
401	Cheie API lipsă sau invalidă
403	Cheie API dezactivată sau abonament expirat
404	Resursă negăsită
429	Limita lunară de apeluri API a fost depășită

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

Exemple de cod

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"