Perplexity lance pplx : un CLI pour son Search API, directement dans le terminal, à 5 $ les 1000 requêtes

Le 27 juillet 2026, Perplexity a lancé pplx, le client CLI officiel de son Search API. Il renvoie les résultats de recherche web et le texte nettoyé des pages au format JSON, directement dans le terminal, au tarif de 5 dollars les 1000 requêtes.

Ce que sait faire pplx

pplx propose exactement deux commandes de travail et n'est pas un client de chat. La commande pplx search web lance une recherche web en direct, tandis que pplx content fetch récupère l'URL indiquée et renvoie le texte nettoyé de la page. Selon la documentation, l'outil s'adresse à parts égales aux humains et aux agents de code, mais il n'offre ni mode conversationnel, ni choix du modèle, ni réponse synthétisée. Pour content fetch, la documentation recommande de vérifier les champs error et is_paywall de la sortie avant d'exploiter le texte ; le drapeau --html ajoute le HTML brut obtenu en direct via le crawler.

• Deux commandes : pplx search web (recherche) et pplx content fetch (extraction de page)
• Sortie toujours au format JSON, aucun chat
• Tarif du Search API : 5,00 dollars les 1000 requêtes
• Limite : 50 QPS sur tous les forfaits
• Plateformes : macOS sur Apple Silicon, Linux x86_64 et Linux arm64

Le contrat de sortie

pplx construit son comportement autour d'un contrat de sortie prévisible, sa principale caractéristique pour l'automatisation. Un succès se traduit par un code de retour 0 et exactement un objet JSON sur stdout ; la recherche renvoie une structure avec un tableau hits, un champ total et un champ optionnel saved_to. Toute défaillance se termine par le code 1 avec un stdout vide, et un unique objet JSON décrivant l'erreur part sur stderr, avec les champs code, message, command et un champ optionnel hint.

«

Un succès, c'est un code de retour 0 et exactement un objet JSON sur stdout », indique l'Agent Skill officiel pplx-cli.

Les codes d'erreur documentés sont AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR et BAD_REQUEST. Cette liste n'est pas exhaustive : le code appelant doit donc se brancher sur le champ error.code plutôt que de s'appuyer sur un ensemble figé. Grâce à ce contrat, un agent distingue de façon fiable un succès d'un échec grâce au code de sortie, sans avoir à analyser le texte de la réponse.

Installation et économie de contexte

L'installation de pplx tient en une seule commande shell, qui télécharge un script et le transmet à sh ; le binaire est placé dans ~/.local/bin/pplx, sans sudo. Le script récupère manifest.json depuis la dernière version, épingle la version pour tous les téléchargements (afin d'éviter une publication concurrente), vérifie la somme de contrôle SHA256, puis seulement installe le fichier. Windows et la version Intel de macOS ne sont pas pris en charge : seules trois plateformes sont disponibles.

Perplexity a porté une attention particulière à l'économie de la fenêtre de contexte, critique pour les agents. Le drapeau --output-dir écrit le résultat complet dans un fichier JSON, et --stdout-preview tronque les longs champs de type chaîne sur stdout en ajoutant des marqueurs truncated. Un piège important : --stdout-preview ne fonctionne pas sans répertoire de sauvegarde, la troncature ne s'activant qu'avec --output-dir ou la variable PPLX_OUTPUT_DIR. Pour la CI et les agents, l'authentification via pplx auth login n'est pas disponible, car elle ne fonctionne que dans un TTY ; la clé se transmet donc par la variable PERPLEXITY_API_KEY.

Ce que cela signifie

Perplexity conditionne son moteur de recherche dans un outil taillé pour les agents de code : un contrat JSON strict, des codes de sortie prévisibles et un contrôle de la consommation de tokens font du Search API une brique pratique pour des pipelines autonomes, et pas seulement pour un humain devant son clavier.

Questions fréquentes

Combien coûte pplx ?

Le CLI lui-même est gratuit, mais les appels au Search API sont facturés : 5,00 dollars les 1000 requêtes, avec une limite de 50 QPS sur tous les forfaits.

pplx fonctionne-t-il sous Windows ?

Non. Seuls macOS sur Apple Silicon, Linux x86_64 et Linux arm64 sont pris en charge. Cette version ne propose pas de build pour Windows ni pour la version Intel de macOS.

Est-ce un remplaçant du chatbot Perplexity ?

Non. pplx n'est pas un client de chat : il n'a ni mode conversationnel, ni choix du modèle, ni réponse synthétisée, seulement la recherche web et l'extraction du texte des pages en JSON.