API WebTrackly v1

API RESTful pour les données de veille sur les domaines

Se connecter Formules API

Authentification

Toutes les requêtes API nécessitent un jeton Bearer dans l'en-tête Authorization. Obtenez votre clé API depuis le tableau de bord API après avoir souscrit une formule API.

Authorization: Bearer YOUR_API_KEY

Démarrage rapide

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

URL de base: https://webtrackly.com/api/v1/

Format: JSON

Méthode: GET

Pagination: ?page=1 (20 par page)

Format de réponse

Les points de terminaison de liste renvoient des résultats paginés. Les informations de limite de débit figurent dans les en-têtes de réponse.

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

En-têtes de réponse

En-tête	Description
X-RateLimit-Limit	Limite d'appels mensuelle
X-RateLimit-Remaining	Appels restants ce mois-ci
X-RateLimit-Used	Appels utilisés ce mois-ci

Packs

GET /api/v1/packages/

Liste tous les packs de domaines (fichiers de zone et données technologiques). Prend en charge le filtrage et la recherche.

Paramètre	Type	Description
type	string	Filtrer par type : zone, technology, detailed
zone	string	Filtrer par TLD de zone (ex. com, net)
technology	string	Filtrer par nom de technologie
q	string	Rechercher par nom
page	int	Numéro de page (par défaut : 1)

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

Obtenir des informations détaillées sur un pack donné, y compris des exemples de domaines.

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

Jeux de données

GET /api/v1/datasets/

Liste tous les jeux de données premium. Prend en charge la recherche.

Paramètre	Type	Description
q	string	Rechercher par nom ou description
page	int	Numéro de page (par défaut : 1)

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

Obtenir les détails d'un jeu de données, y compris des données d'exemple.

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

Compte

GET /api/v1/account/

Obtenir les informations de votre abonnement API, vos statistiques d'utilisation et la liste de vos clés 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}
  ]
}

Limites de débit

Les appels API sont comptabilisés mensuellement. Les limites dépendent de votre formule d'abonnement API.

Formule	Appels/mois	Prix
API Starter	10,000	$29/mois
API Professional	100,000	$99/mois
API Enterprise	1,000,000	$299/mois

Les résultats sont paginés avec un maximum de 20 éléments par page afin d'empêcher l'extraction massive de données. Voir les formules

Erreurs

Code	Description
401	Clé API manquante ou invalide
403	Clé API désactivée ou abonnement expiré
404	Ressource introuvable
429	Limite mensuelle d'appels API dépassée

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

Exemples de code

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"