Qu’est-ce que Valyu TypeScript SDK (valyu-js) ?
valyu-js est le client TypeScript et JavaScript officiel de Valyu, une API de recherche conçue pour les agents d'IA. Un seul objet `Valyu` couvre la recherche sur le web et dans des sources propriétaires (PubMed, arXiv, documents déposés à la SEC, brevets et d'autres), l'extraction de contenu depuis des URL, des réponses étayées et DeepResearch, un agent de recherche asynchrone qui renvoie des rapports sourcés avec, en option, des fichiers PDF, CSV et autres.
On l'installe avec `npm install valyu-js` et on lui passe une `VALYU_API_KEY`. La version actuelle est la 2.11.5, publiée sur npm le 31 octobre 2026. Le SDK est sous MIT ; chaque appel qu'il effectue est facturé en crédits Valyu.
Valyu TypeScript SDK (valyu-js) vaut-il le coup ?
valyu-js est une surcouche bien entretenue dont la valeur monte ou descend avec l'API Valyu qui se trouve derrière. Le SDK lui-même est gratuit sous MIT ; il ne fait rien sans clé, et chaque recherche, extraction et tâche de recherche approfondie est facturée en crédits. La question à trancher avant de l'adopter est de savoir si les données de Valyu font mieux qu'Exa, Tavily ou un robot d'indexation auto-hébergé pour vos requêtes, pas de savoir si le client est bon.
Le client est bon. À la lecture du changelog, les versions 2.11.0 à 2.11.5 se sont succédé rapidement, avec un mode de recherche `instant`, des relances automatiques sur les réponses 429 (2 par défaut, en respectant Retry-After jusqu'à 60 secondes), un délai d'expiration de 120 secondes sur les requêtes DeepResearch, une interrogation fondée sur les ETag et un contrôle du cache page par page dans `contents()`. Plusieurs correctifs portaient sur des options que le SDK ignorait sans prévenir, comme `countryCode` envoyé avec la mauvaise casse ; cette franchise rassure, et c'est une raison de rester sur la dernière version.
DeepResearch est facturé par tâche selon le mode : 8 crédits en instant, 25 en fast, 100 en standard, 500 en heavy et 2 500 en max, recherches et lectures de pages comprises. Au tarif à l'usage de 1 600 crédits pour 10 $, une tâche fast coûte environ 0,16 $ et une tâche max environ 15,60 $. Le SDK TypeScript utilise fast par défaut, alors que l'API et le SDK Python utilisent standard : le même appel peut donc coûter quatre fois plus cher depuis un autre client. Chaque fichier livrable supplémentaire coûte 16 crédits après le premier. La recherche est facturée par millier de résultats selon la source : environ 0,31 $ pour arXiv et PubMed, 0,63 $ pour le web, jusqu'à 30 $ pour les revues sous licence.
Le hic : les preuves d'adoption sont minces et surtout autoréférentielles. Le dépôt compte 2 étoiles sur GitHub ; npm a enregistré 19 281 téléchargements sur les 30 jours précédant le 2 novembre 2026, et les utilisateurs open source visibles sont des applications de démonstration de proches de Valyu, dont Global Threat Map, Global Hack Map et Polyseer. Cela prouve que l'API fonctionne pour ces applications, pas qu'elle a des parts de marché. La clé est aussi un identifiant de facturation : le SDK est prévu pour du code serveur, et un bundle navigateur contenant `VALYU_API_KEY` livre votre solde de crédits à quiconque ouvre les outils de développement.
Notre avis : valyu-js est le prix d'un essai de Valyu, et il est faible ; Valyu lui-même se juge sur un échantillon de vos propres requêtes avant d'entrer dans un produit.
Là où il fait la différence
Une start-up de deux personnes qui construit en Next.js un assistant de littérature biotech
Interroger PubMed et les essais cliniques depuis le serveur sans entretenir de scrapers
Appelez `valyu.search()` avec `searchType: "proprietary"` et des `includedSources` limitées à PubMed depuis une route d'API. Les résultats sont facturés par millier renvoyé, environ 0,31 $ pour PubMed, si bien qu'un prototype tient avec les 10 $ de crédit d'inscription.
Un analyste actions dans un petit fonds
Obtenir chaque matin un premier jet sourcé sur une entreprise
Mettez en file des tâches `deepresearch.create()` via `batch` en mode fast à 25 crédits chacune, environ 0,16 $ au tarif à l'usage, et lisez la sortie en markdown ou en PDF. Le mode heavy coûte 500 crédits par rapport : le choix du mode fait la facture.
Un ingénieur plateforme qui ajoute la lecture du web à un agent interne
Transformer une liste d'URL en texte propre ou en champs JSON
`contents()` accepte de 1 à 10 URL en mode synchrone ou jusqu'à 50 en asynchrone, avec un schéma JSON facultatif pour l'extraction structurée et `maxAge` pour forcer une nouvelle exploration. À exécuter uniquement côté serveur, avec la clé rangée dans votre gestionnaire de secrets.
Avant de vous engager
- Mise en route
- `npm install valyu-js`, définissez `VALYU_API_KEY` puis appelez `new Valyu(process.env.VALYU_API_KEY)`. Une première recherche prend quelques minutes ; l'inscription ne demande pas de carte.
- Intégrations
- Un SDK Python couvre la même API ; le README cite des intégrations avec le Vercel AI SDK (@valyu/ai-sdk), LangChain et MCP. Des types TypeScript complets sont exportés pour chaque requête et réponse.
- Données et confidentialité
- Les requêtes et les URL partent vers l'API hébergée de Valyu ; le SDK n'a pas de mode auto-hébergé. La documentation du SDK ne traite pas des conditions de conservation et d'entraînement de Valyu. Les liens de téléchargement DeepResearch sont signés et expirent.
- Coût à grande échelle
- Forfaits mensuels : 29 $ pour 5 000 crédits, 99 $ pour 18 000, 499 $ pour 100 000 ; les crédits ne sont pas reportés. À solde nul, les nouvelles requêtes renvoient 402 au lieu de facturer un dépassement. La concurrence DeepResearch dépend du forfait : 2 tâches simultanées en paiement à l'usage, 5 avec le forfait à 29 $, selon la documentation.
- Limites
- La recherche renvoie au plus 20 résultats par appel. Les limites strictes de DeepResearch vont de 2 minutes (instant) à 90 minutes (max) ; `wait()` abandonne au bout de 2 heures. Aucune limite chiffrée de débit des requêtes n'est publiée.
Les points forts
- Recherche, contents, answer, DeepResearch, batch et workflows dans un client typé
- Relances automatiques sûres sur 429, en respectant le Retry-After du serveur
- Versions fréquentes et changelog détaillé et franc
- Licence MIT
Les points faibles
- Inutile sans compte Valyu payant et facturé à l'usage
- Le mode par défaut en TypeScript (fast) diffère de celui de l'API (standard)
- Peu d'adoption indépendante au-delà d'applications de démonstration proches de Valyu
- Plusieurs correctifs récents concernaient des options auparavant ignorées sans erreur
Idéal pour
Les équipes TypeScript qui ont déjà conclu que les sources de données de Valyu conviennent à leur agent et veulent le client officiel et maintenu.
Alternatives à Valyu TypeScript SDK (valyu-js)
Valyu TypeScript SDK (valyu-js) : questions fréquentes
- Valyu TypeScript SDK (valyu-js) vaut-il le coup ?
- Un client soigné et qui évolue vite pour une seule API payante ; le code est sous MIT, mais ce que vous achetez réellement, c'est le compteur de crédits de Valyu. Nous lui donnons 3.8 sur 5.
- Combien coûte Valyu TypeScript SDK (valyu-js) ?
- SDK gratuit sous MIT. L'API Valyu est facturée en crédits : paiement à l'usage, 1 600 crédits pour 10 $ ; forfaits à 29 $, 99 $ et 499 $ par mois ; les nouveaux comptes reçoivent 10 $ de crédits gratuits (20 $ avec une adresse e-mail professionnelle).
- Quels sont les inconvénients de Valyu TypeScript SDK (valyu-js) ?
- Inutile sans compte Valyu payant et facturé à l'usage; le mode par défaut en TypeScript (fast) diffère de celui de l'API (standard); peu d'adoption indépendante au-delà d'applications de démonstration proches de Valyu; plusieurs correctifs récents concernaient des options auparavant ignorées sans erreur.
- À qui s’adresse Valyu TypeScript SDK (valyu-js) ?
- Les équipes TypeScript qui ont déjà conclu que les sources de données de Valyu conviennent à leur agent et veulent le client officiel et maintenu.
- Combien coûte Valyu TypeScript SDK (valyu-js) pour une équipe ou en production ?
- Forfaits mensuels : 29 $ pour 5 000 crédits, 99 $ pour 18 000, 499 $ pour 100 000 ; les crédits ne sont pas reportés. À solde nul, les nouvelles requêtes renvoient 402 au lieu de facturer un dépassement. La concurrence DeepResearch dépend du forfait : 2 tâches simultanées en paiement à l'usage, 5 avec le forfait à 29 $, selon la documentation.
- Valyu TypeScript SDK (valyu-js) est-il sûr pour les données de l’entreprise ?
- Les requêtes et les URL partent vers l'API hébergée de Valyu ; le SDK n'a pas de mode auto-hébergé. La documentation du SDK ne traite pas des conditions de conservation et d'entraînement de Valyu. Les liens de téléchargement DeepResearch sont signés et expirent.
- Quelles sont les meilleures alternatives à Valyu TypeScript SDK (valyu-js) ?
- Les alternatives les plus proches que nous avons testées sont Firecrawl, Crawl4AI et GPT Researcher.
Réponses vérifiées le 3 nov. 2026.