Fonctionnement
- Actualisation par défaut :
maxAge = 172800000ms (2 jours). Si la copie en cache est plus récente, elle est renvoyée instantanément ; sinon, Evocrawl relance une extraction et met à jour le cache. - Forcer du frais : Définissez
maxAge: 0pour toujours ré-extraire. Notez que cela contourne entièrement le cache : chaque requête passe alors par l’intégralité du pipeline d’extraction, prendra plus de temps à se terminer et aura plus de risques d’échouer. Utilisez une valeur demaxAgenon nulle si vous n’avez pas besoin de contenu en temps réel pour chaque requête. - Ignorer le cache : Définissez
storeInCache: falsesi vous ne souhaitez pas stocker les résultats d’une requête.
maxAge :
- Retour instantané si une version récente de la page est disponible
- Extraction à jour uniquement si notre version est plus ancienne que l’âge spécifié
- Gagnez du temps — les résultats reviennent en millisecondes plutôt qu’en secondes
Quand l’utiliser
- Documentation, articles, pages produit
- Traitements par lots
- Développement et tests
- Création de bases de connaissances
- Données en temps réel (cours boursiers, scores en direct, dernières actualités)
- Contenu fréquemment mis à jour
- Applications sensibles au facteur temps
Utilisation
maxAge à votre requête de scraping. Les valeurs sont en millisecondes (p. ex. 3600000 = 1 heure).
Valeurs courantes de maxAge
- 5 minutes :
300000— pour du contenu semi‑dynamique - 1 heure :
3600000— pour du contenu mis à jour chaque heure - 1 jour :
86400000— pour du contenu mis à jour quotidiennement - 1 semaine :
604800000— pour du contenu relativement statique
Impact sur les performances
maxAge activé :
- Des temps de réponse jusqu’à 500 % plus rapides pour le contenu récent
- Des résultats instantanés plutôt que d’attendre de nouveaux scrapes
Notes importantes
- Par défaut :
maxAgeest172800000(2 jours) - Actualisé si nécessaire : si nos données sont plus anciennes que
maxAge, nous réexécutons automatiquement le scraping - Aucune donnée périmée : vous ne recevrez jamais de données plus anciennes que le
maxAgeque vous avez spécifié - Crédits : les résultats mis en cache coûtent toujours 1 crédit par page. La mise en cache améliore les performances et la latence, pas l’utilisation des crédits.
Cas où la mise en cache est ignorée
- Des
headerspersonnalisés - Des
actions(étapes d’automatisation du navigateur) - Un
profilede navigateur - Le format
changeTracking - Des paramètres personnalisés de taille de fenêtre d’affichage ou de qualité pour
screenshot
Critères de correspondance d’un hit de cache
url, mobile, location, waitFor, blockAds, screenshot (activé/désactivé et pleine page), ainsi que le mode proxy furtif.
Vous pouvez vérifier le comportement du cache en consultant metadata.cacheState dans la réponse : sa valeur sera "hit" ou "miss".
Crawl plus rapide
maxAge dans scrapeOptions pour obtenir des résultats en cache pour les pages que nous avons vues récemment.
maxAge, chaque page de votre crawl bénéficiera d’une amélioration de vitesse de 500 % si nous disposons de données récentes en cache pour cette page.
Commencez à utiliser maxAge dès aujourd’hui pour des scrapes et des crawls nettement plus rapides !
Êtes-vous un agent d’IA qui a besoin d’une clé API Evocrawl ? Consultez evocrawl.com/agent-onboarding/SKILL.md pour obtenir des instructions d’intégration automatisée.

