/agent est une API révolutionnaire qui recherche, parcourt et collecte des données même depuis les sites web les plus complexes, trouvant des données dans des endroits difficiles d’accès et en découvrant partout sur internet. Elle accomplit en quelques minutes ce qui prendrait de nombreuses heures à un humain, et rend le scraping web traditionnel obsolète.
Décrivez simplement les données que vous souhaitez et /agent s’occupe du reste.
Version de recherche (Research Preview) : Agent est en accès anticipé. Attendez-vous à quelques limitations. Il s’améliorera considérablement au fil du temps. Donnez votre avis →
/extract et va encore plus loin :
- Aucune URL requise : Décrivez simplement ce dont vous avez besoin via le paramètre
prompt. Les URL sont facultatives. - Recherche web approfondie : Explore et navigue automatiquement en profondeur dans les sites pour trouver vos données
- Fiable et précis : Fonctionne avec un large éventail de requêtes et de cas d’usage
- Plus rapide : Traite plusieurs sources en parallèle pour des résultats plus rapides
- Moins cher : Agent est plus économique que
/extractpour les cas d’usage complexes
Utilisation de /agent
prompt. Décrivez simplement les données que vous souhaitez extraire. Pour une sortie structurée, fournissez un schéma JSON. Les SDK prennent en charge Pydantic (Python) et Zod (Node) pour des définitions de schémas avec typage sûr :
Réponse
JSON
Fournir des URL (facultatif)
Statut et fin de la tâche
- Méthode par défaut :
agent()attend la fin de l’exécution et renvoie les résultats finaux - Démarrer puis interroger : utilisez
start_agent(Python) oustartAgent(Node) pour obtenir immédiatement un ID de tâche, puis interrogez avecget_agent_status/getAgentStatus
Les résultats de la tâche sont disponibles pendant 24 heures après la fin de l’exécution.
États possibles
| Statut | Description |
|---|---|
processing | L’agent est toujours en cours de traitement de votre requête |
completed | L’extraction s’est terminée avec succès |
failed | Une erreur s’est produite au cours de l’extraction |
Exemple en attente
JSON
Exemple complété
JSON
Paramètres
| Paramètre | Type | Requis | Description |
|---|---|---|---|
prompt | string | Oui | Description en langage naturel des données que vous souhaitez extraire (max. 10 000 caractères) |
urls | array | Non | Liste optionnelle d’URL pour cibler l’extraction |
schema | object | Non | Schéma JSON optionnel pour un résultat structuré |
Agent vs Extract : ce qui a été amélioré
| Fonctionnalité | Agent (nouveau) | Extract |
|---|---|---|
| URL requises | Non | Oui |
| Vitesse | Plus rapide | Standard |
| Coût | Inférieur | Standard |
| Fiabilité | Supérieure | Standard |
| Flexibilité des requêtes | Élevée | Modérée |
Exemples de cas d’utilisation
- Recherche : “Trouver les 5 principales startups d’IA et les montants de leurs financements”
- Analyse concurrentielle : “Comparer les offres tarifaires entre Slack et Microsoft Teams”
- Collecte de données : “Extraire les informations de contact depuis les sites web d’entreprises”
- Synthèse de contenu : “Résumer les derniers articles de blog sur le web scraping”
Référence de l’API
Tarification
Fonctionnement de la tarification de l’agent
- Les extractions simples (comme les informations de contact à partir d’une seule page) consomment généralement moins de crédits et coûtent moins cher
- Les tâches de recherche complexes (comme une analyse concurrentielle sur plusieurs domaines) consomment plus de crédits mais reflètent mieux l’effort total requis
- Une transparence totale sur l’utilisation vous montre exactement combien de crédits chaque requête a consommé
- La conversion de crédits convertit automatiquement l’utilisation de crédits par l’agent en crédits pour une facturation simplifiée
L’utilisation de crédits varie en fonction de la complexité de votre prompt, de la quantité de données traitées et de la structure du résultat demandé.
Pour commencer
Gestion des coûts
- Commencez avec des exécutions gratuites : utilisez vos 5 requêtes gratuites quotidiennes pour comprendre la tarification
- Définissez un paramètre
maxCredits: limitez vos dépenses en définissant un nombre maximal de crédits que vous êtes prêt à utiliser - Optimisez les prompts : des prompts plus spécifiques consomment souvent moins de crédits
- Surveillez votre utilisation : suivez votre consommation via le tableau de bord
- Définissez des attentes claires : des recherches complexes couvrant plusieurs domaines utiliseront plus de crédits que de simples extractions sur une seule page
La tarification est susceptible d’évoluer à mesure que nous passons de la Research Preview à la disponibilité générale. Les utilisateurs actuels recevrront un préavis avant toute mise à jour des tarifs.

