WebTrackly API v1

RESTful API για δεδομένα ανάλυσης domain

Σύνδεση Προγράμματα API

Έλεγχος ταυτότητας

Όλα τα αιτήματα API απαιτούν ένα Bearer token στην κεφαλίδα Authorization. Λάβετε το κλειδί API σας από τον Πίνακα ελέγχου API αφού αποκτήσετε συνδρομή σε κάποιο πρόγραμμα API.

Authorization: Bearer YOUR_API_KEY

Γρήγορη εκκίνηση

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

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

Μορφή: JSON

Μέθοδος: GET

Σελιδοποίηση: ?page=1 (20 ανά σελίδα)

Μορφή απόκρισης

Τα endpoints λίστας επιστρέφουν σελιδοποιημένα αποτελέσματα. Οι πληροφορίες για τα όρια ρυθμού περιλαμβάνονται στις κεφαλίδες απόκρισης.

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

Κεφαλίδες απόκρισης

Κεφαλίδα	Περιγραφή
X-RateLimit-Limit	Μηνιαίο όριο κλήσεων
X-RateLimit-Remaining	Υπόλοιπο κλήσεων αυτόν τον μήνα
X-RateLimit-Used	Κλήσεις που χρησιμοποιήθηκαν αυτόν τον μήνα

Πακέτα

GET /api/v1/packages/

Επιστρέφει όλα τα πακέτα domain (αρχεία ζώνης και δεδομένα τεχνολογιών). Υποστηρίζει φιλτράρισμα και αναζήτηση.

Παράμετρος	Τύπος	Περιγραφή
type	string	Φιλτράρισμα κατά τύπο: zone, technology, detailed
zone	string	Φιλτράρισμα κατά TLD ζώνης (π.χ. com, net)
technology	string	Φιλτράρισμα κατά όνομα τεχνολογίας
q	string	Αναζήτηση κατά όνομα
page	int	Αριθμός σελίδας (προεπιλογή: 1)

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

Επιστρέφει αναλυτικές πληροφορίες για συγκεκριμένο πακέτο, μαζί με δείγματα domain.

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

Σύνολα δεδομένων

GET /api/v1/datasets/

Επιστρέφει όλα τα premium σύνολα δεδομένων. Υποστηρίζει αναζήτηση.

Παράμετρος	Τύπος	Περιγραφή
q	string	Αναζήτηση κατά όνομα ή περιγραφή
page	int	Αριθμός σελίδας (προεπιλογή: 1)

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

Επιστρέφει λεπτομέρειες του συνόλου δεδομένων, μαζί με δείγμα δεδομένων.

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

Λογαριασμός

GET /api/v1/account/

Επιστρέφει πληροφορίες για τη συνδρομή API σας, στατιστικά χρήσης και τη λίστα κλειδιών 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}
  ]
}

Όρια ρυθμού

Οι κλήσεις API μετρώνται σε μηνιαία βάση. Τα όρια εξαρτώνται από το πρόγραμμα συνδρομής API σας.

Πρόγραμμα	Κλήσεις/μήνα	Τιμή
API Starter	10,000	$29/μήνα
API Professional	100,000	$99/μήνα
API Enterprise	1,000,000	$299/μήνα

Τα αποτελέσματα σελιδοποιούνται με μέγιστο 20 στοιχεία ανά σελίδα, ώστε να αποτρέπεται η μαζική εξαγωγή δεδομένων. Δείτε τα προγράμματα

Σφάλματα

Κωδικός	Περιγραφή
401	Λείπει ή δεν είναι έγκυρο το κλειδί API
403	Το κλειδί API απενεργοποιήθηκε ή η συνδρομή έληξε
404	Ο πόρος δεν βρέθηκε
429	Υπέρβαση μηνιαίου ορίου κλήσεων API

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

Παραδείγματα κώδικα

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"