Docs
Se connecter

Account API

Accès programmatique à vos statistiques d'utilisation mensuelles : succès, échecs, montant dû, crédits restants et répartition par domaine.

Vue d'ensemble

L'Account API renvoie les statistiques d'utilisation mensuelles de vos produits Crawlbase. Utilisez-la pour surveiller votre consommation, créer des tableaux de bord internes ou déclencher des alertes lorsque vous approchez de votre limite de crédits.

Cette API est activement maintenue. Elle est regroupée sous « legacy » dans la navigation uniquement parce qu'il s'agit d'un format d'endpoint plus ancien — aucun remplacement n'est prévu.

Endpoint :https://api.crawlbase.com/account

Limite de débit : 1 requête toutes les 5 minutes

Cet endpoint agrège beaucoup de données côté serveur. Mettez la réponse en cache — il est inutile de l'appeler plus fréquemment.

Démarrage rapide

curl 'https://api.crawlbase.com/account?token=YOUR_TOKEN&product=crawling-api'

Paramètres

token
stringrequis
Votre token Crawlbase.
product
stringrequis
Le produit dont récupérer l'utilisation. Au choix : crawling-api, crawler, smartproxy, scraper-api, leads-api, screenshot-api.
previous_month
booleanfalse
Lorsque défini à true, inclut les statistiques du mois précédent en plus du mois en cours pour comparer les tendances.

Champs de la réponse

totalSuccess
Nombre total de requêtes réussies ce mois-ci.
totalFailed
Nombre total de requêtes échouées ce mois-ci.
totalDue
Montant total dû en USD pour les requêtes réussies ce mois-ci.
remainingCredits
Crédits encore disponibles ce mois-ci. Renvoyé uniquement pour les produits par abonnement.
domainStats
Tableau des répartitions par domaine : domain, totalRequests, success, failure, successRate.

Exemples par produit

# Crawling API
curl "https://api.crawlbase.com/account?token=YOUR_TOKEN&product=crawling-api"

# Enterprise Crawler
curl "https://api.crawlbase.com/account?token=YOUR_TOKEN&product=crawler"

# Smart AI Proxy
curl "https://api.crawlbase.com/account?token=YOUR_TOKEN&product=smartproxy"

# Scraper API (legacy)
curl "https://api.crawlbase.com/account?token=YOUR_TOKEN&product=scraper-api"

# Leads API (legacy)
curl "https://api.crawlbase.com/account?token=YOUR_TOKEN&product=leads-api"

# Screenshots API (legacy)
curl "https://api.crawlbase.com/account?token=YOUR_TOKEN&product=screenshot-api"

# With previous month for trend comparison
curl "https://api.crawlbase.com/account?token=YOUR_TOKEN&product=crawling-api&previous_month=true"