API Website Antibot

Vue d'ensembleLink to Vue d'ensemble

Avant de scraper un site, il est utile de savoir quelle protection anti-bot vous attend. L'API Website Antibot répond à cette question : envoyez une URL et récupérez le vendor reconnu par Piloterr (Cloudflare, DataDome, Akamai, captcha, etc.).

Piloterr charge la page une fois, comme une visite navigateur classique, et observe la réponse : en-têtes HTTP, cookies et contenu. Il remonte ce qu'il reconnaît, son niveau de confiance, et les indices qui ont déclenché la détection.

C'est de la détection uniquement. Pas de contournement de captcha, pas de bypass WAF, pas de scraping de pages protégées. Servez-vous-en pour choisir la suite : Website Crawler, Rendering ou WebUnlocker.

Coût : 1 crédit par appel.

Quand l'utiliserLink to Quand l'utiliser

• Un crawl échoue : comprendre qui bloque.
• Pré-vol avant un pipeline de données pour choisir le bon endpoint Piloterr.
• Veille concurrentielle ou commerciale : détecter l'ajout d'une protection bot.
• Réponse simple à un client ou collègue : "Ce site tourne sous Cloudflare Bot Management."

Démarrage rapideLink to Démarrage rapide

GET https://api.piloterr.com/v2/website/antibot?query=https://www.example.com&timeout=15

ParamètresLink to Paramètres

Exemple de réponseLink to Exemple de réponse

{
  "requested_url": "https://www.example.com",
  "final_url": "https://www.example.com/",
  "status": 200,
  "vendor": "cloudflare",
  "confidence": "high",
  "detections": [
    {
      "vendor": "cloudflare",
      "confidence": "high",
      "evidence": [
        "Header cf-ray: abc123-LHR",
        "Cookie __cf_bm present (Bot Management)"
      ]
    }
  ]
}

Quand rien n'est détecté :

{
  "requested_url": "https://example.org",
  "final_url": "https://example.org/",
  "status": 200,
  "vendor": "none",
  "confidence": null,
  "detections": []
}

Comprendre la réponseLink to Comprendre la réponse

Chaque élément de detections :

Comment lire la réponse : vendor + confidence à la racine pour une réponse rapide. Ouvrez detections pour le détail ou quand plusieurs protections coexistent.

Protections détectéesLink to Protections détectées

Bon à savoirLink to Bon à savoir

• Une page de challenge (403, 503, "Checking your browser") reste une analyse réussie : c'est souvent le signal recherché.
• none ne garantit rien. Certaines protections n'apparaissent qu'après exécution JavaScript.

Et ensuite sur Piloterr ?Link to Et ensuite sur Piloterr ?

Codes d'erreurLink to Codes d'erreur

LimitesLink to Limites

• Analyse passive : une requête HTTP, sans exécuter le JavaScript de la page.
• Captchas ou scripts injectés dynamiquement peuvent rester invisibles.
• Outil de recherche et de planification, pas de contournement.