Skip to main content

​
Premiers pas

Scraping synchrone

L’endpoint scrape exécute une session de navigateur et renvoie le HTML rendu en une seule requête — idéal pour les intégrations à faible latence.

Tâches asynchrones

Les endpoints jobs mettent les scrapes en file d’attente et permettent de consulter le statut et les résultats — idéal pour un volume élevé ou des pages lentes.

​
Architecture REST

L’API de web scraping suit les principes REST, avec des URL prévisibles orientées ressources et des codes de statut HTTP standard pour une intégration fluide et une gestion des erreurs.

​
Sécurité HTTPS

Toutes les communications API sont sécurisées par TLS 1.2 ou supérieur pour garantir l’intégrité et la confidentialité des données.

​
Versions de l’API

L’API de web scraping maintient la compatibilité ascendante via le versionnage et fonctionne actuellement en Version 1.

​
Authentification

Votre clé API est le credential exclusif pour accéder à l’API de web scraping. Chaque service Cleariflow nécessite une clé unique. Incluez votre clé dans le corps JSON via api_key.

​
URL de base

​
Rendu des pages

Les pages sont rendues dans un véritable navigateur headless. JavaScript est entièrement exécuté avant le retour du contenu. La protection SSRF intégrée bloque les requêtes vers localhost et les plages d’IP privées.

​
Codes de réponse et d’erreur

En cas d’échec, l’API renvoie des réponses d’erreur JSON structurées avec des codes et descriptions spécifiques pour un dépannage efficace.