Search API de Perplexity : Guide complet et exemple concret

Dans un monde où l’information est produite en continu et en quantité toujours plus massive, savoir extraire rapidement les données pertinentes est devenu un enjeu essentiel. Les moteurs de recherche classiques, comme Google ou Bing, restent incontournables, mais ils présentent plusieurs limites. Les résultats sont souvent mélangés avec de la publicité, les formats sont pensés pour une navigation humaine et l’automatisation est complexe. C’est précisément là qu’intervient la Search API proposée par Perplexity.

Cette interface vous permet d’accéder directement à la puissance de recherche de Perplexity depuis vos propres programmes, vos scripts ou même depuis un simple terminal. Grâce à la Search API, il devient possible d’automatiser des recherches, de structurer les résultats en JSON et de les exploiter dans vos propres projets sans dépendre d’un navigateur.

Dans ce tutoriel complet, nous allons découvrir ce qu’est la Search API, à quoi elle sert, quels sont ses avantages, et surtout comment l’installer, l’utiliser et l’intégrer dans vos projets. Nous découvrirons pas à pas, avec des explications simples et détaillées, comment rapidement mettre en place un système de recherche automatisé. En guise d’illustration concrète, nous réaliserons ensemble un cas pratique : la mise en place d’un outil de veille automatisée grâce à la Search API et à un script cron.

Qu’est-ce que la Search API de Perplexity ?

Une API (Application Programming Interface) est une interface qui permet à des programmes de communiquer entre eux. Dans le cas de Perplexity, la Search API est un point d’accès qui autorise les développeurs et utilisateurs avancés à effectuer des recherches directement depuis leur code ou leur terminal.

Plutôt que d’ouvrir votre navigateur, taper une requête et parcourir les résultats manuellement, vous envoyez une requête HTTP à l’API. En retour, vous obtenez une réponse structurée au format JSON, contenant les résultats essentiels : titre des pages, URL, extraits de contenu, sources, dates et parfois même des métadonnées.

Cette approche transforme l’acte de rechercher en ligne en un processus automatisé. Vous pouvez poser des questions simples comme « Quelle est la capitale du Japon ? », ou lancer des recherches complexes avec des filtres de date, de domaine ou de quantité de résultats.

À quoi sert la Search API ?

La Search API est avant tout conçue pour celles et ceux qui souhaitent aller au-delà d’une recherche manuelle. Son but est de donner accès aux résultats de Perplexity sous une forme directement exploitable par des machines.

Elle peut servir à de nombreuses tâches :

• Réaliser des recherches répétitives et automatisées sans perte de temps.
• Collecter des informations à intervalle régulier sur un sujet donné, comme les tendances SEO ou l’actualité en cybersécurité.
• Alimenter une base de données avec des résultats sourcés.
• Construire un chatbot capable de répondre avec des informations fraîches issues du web.
• Créer des tableaux de bord d’analyse ou des rapports quotidiens générés automatiquement.

Grâce à son format structuré et à son intégration facile dans des scripts, la Search API se prête aussi bien à des projets simples qu’à des applications professionnelles nécessitant de la recherche à grande échelle.

Exemple d’utilisation

1. Automatiser des recherches web
   • Faire des recherches sans ouvrir le navigateur.
   • Récupérer les résultats en JSON (structurés) au lieu d’un simple texte.
   • Exemple : lancer une recherche chaque matin pour obtenir les dernières news tech.
2. Scraping intelligent / veille automatisée
   • Surveiller l’actualité d’un sujet (SEO, cybersécurité, IA, etc.).
   • Intégrer ça dans un script cron pour générer un rapport quotidien.
3. Intégration dans tes projets web
   • Brancher l’API à un site pour proposer aux utilisateurs un moteur de recherche enrichi par Perplexity.
   • Construire des assistants personnalisés (ex. chatbot qui cite ses sources en temps réel).
4. CLI rapide pour développeurs
   • Ne pas quitter son terminal pour poser une question (un peu comme curl ou grep, mais pour le web).
   • Utile quand vous bossez en SSH sur un serveur et que vous recherchez une info sans lancer un navigateur.
5. Automatisation avec d’autres outils
   • Lier ça à des scripts Python, Bash, ou Node.js pour :
     • Créer un bot Twitter qui poste des tendances chaque heure.
     • Générer des rapports de veille pour un client.
     • Alimenter une base de données avec des articles sourcés.
6. Alternative aux moteurs classiques
   • Contrairement à Google Search, les résultats sont orientés question/réponse avec citations directes.
   • Vous pouvez définir des filtres : par date, domaine, nombre de résultats, etc.

La Search API de Perplexity sert à industrialiser vos recherches et les brancher dans votre écosystème dev (scripts, projets web, dashboards, automatisations), sans dépendre d’un navigateur.

Les avantages de la Search API par rapport aux recherches classiques

La Search API possède plusieurs avantages indéniables par rapport à une recherche traditionnelle sur le web.

Tout d’abord, elle supprime la dimension manuelle. Vous n’avez plus besoin d’ouvrir un navigateur, de taper votre requête et de naviguer de lien en lien. Tout est automatisé et peut être intégré directement dans vos propres outils.

Ensuite, elle fournit des résultats structurés. Là où un moteur de recherche classique présente des pages visuellement attractives mais difficiles à analyser automatiquement, l’API renvoie du JSON. Ce format est lisible par les humains mais surtout conçu pour être traité par des programmes. Cela permet d’extraire rapidement les informations dont vous avez besoin sans bruit inutile.

Un autre atout réside dans la possibilité de filtrer et personnaliser vos requêtes. Vous pouvez limiter le nombre de résultats, cibler un domaine particulier, restreindre la recherche à une période donnée ou définir des options de langue. Ces paramètres rendent la recherche beaucoup plus précise et adaptée à vos besoins spécifiques.

Enfin, la Search API s’intègre facilement dans vos workflows existants. Que vous soyez développeur web, analyste de données ou responsable marketing, vous pouvez connecter cette API à vos scripts Python, PHP, Node.js ou même à des automatisations simples via le terminal et cron. Cela en fait un outil flexible, utilisable aussi bien pour un projet personnel que pour un déploiement à grande échelle.

Pourquoi s’y intéresser dès aujourd’hui ?

La recherche d’information évolue rapidement. Les entreprises, les créateurs de contenu et les développeurs ont besoin d’outils capables de s’adapter à ce flux constant de données.

La Search API de Perplexity répond à plusieurs problématiques actuelles :

• Gagner du temps en automatisant la collecte d’information.
• Améliorer la pertinence de vos recherches grâce à des filtres avancés.
• Créer des services et applications innovantes sans devoir réinventer un moteur de recherche complet.
• Mettre en place une veille automatisée qui fonctionne même lorsque vous n’êtes pas devant votre ordinateur.

En clair, si vous travaillez avec des données, que vous gérez un site web ou que vous développez des projets nécessitant une veille continue, la Search API est un outil dont vous pourriez rapidement ne plus vous passer.

Installer et configurer la Search API de Perplexity

Avant de pouvoir interroger la Search API, vous devez disposer d’un compte Perplexity et d’une clé API valide. La clé API agit comme une carte d’identité : elle vous permet d’accéder au service et d’être reconnu par Perplexity.

Création du compte et récupération de la clé API

Rendez-vous sur le site officiel de Perplexity et créez un compte si ce n’est pas déjà fait. L’inscription est rapide et gratuite pour un usage de base.

1. Aller dans les paramètres (Settings) de son compte.
2. Cliquer sur l’onglet ou la section « API ».
3. Générer une nouvelle clé API en cliquant sur « Create API Key » ou « Generate New Key ».
4. Copier immédiatement la clé API affichée qui commence généralement par « pplx- » et la stocker de manière sécurisée (ex : variables d’environnement, gestionnaire secret).
5. Cette clé donne accès aux fonctionnalités de la Search API de Perplexity, y compris des modèles spécifiques avec accès à la recherche en ligne.
6. Ces étapes se font via l’interface utilisateur de Perplexity, et la clé est nécessaire pour authentifier les requêtes vers la Search API permettant d’accéder aux données et réponses web en temps réel. La clé doit être protégée pour éviter toute utilisation non autorisée.

Une fois la clé générée, vous êtes prêt à utiliser la Search API.

Attention, la Search API n’est pas gratuite, il vous faut entrer un moyen de paiement.

Faire une première requête avec curl

Le moyen le plus simple de tester la Search API est d’utiliser curl, un outil présent par défaut sur la plupart des systèmes (Linux, macOS et parfois Windows).

Voici un exemple de commande :

curl https://api.perplexity.ai/search \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Capitale du Japon",
    "max_results": 3
  }'

Dans cette commande :

• -H permet de définir les en-têtes nécessaires, dont l’authentification avec votre clé API.
• -d définit le corps de la requête au format JSON, où vous précisez votre question et les paramètres souhaités.
• max_results limite le nombre de résultats renvoyés.

La réponse sera renvoyée en JSON, avec des champs tels que title, url et snippet. Vous pouvez l’afficher directement dans le terminal ou l’enregistrer dans un fichier pour traitement ultérieur.

Installer un client CLI dédié

Même si curl fonctionne, il n’est pas toujours pratique d’écrire des requêtes JSON complètes à chaque fois. C’est pourquoi des clients en ligne de commande existent.

Un des plus utilisés est perplexity-cli. Voici comment l’installer :

Sur Linux ou macOS avec pip (Python)

pip install perplexity-cli

Pour en savoir plus, Consultez notre guide complet sur Pip, Pipx et Pip3.

Vérifier l’installation

Une fois installé, tapez :

perplexity --help

Vous verrez apparaître la liste des options disponibles.

Configurer la clé API

Lors de la première utilisation, il faudra renseigner votre clé API. En général, cela se fait ainsi :

export PERPLEXITY_API_KEY="VOTRE_CLE_API"

Cette commande définit une variable d’environnement qui sera utilisée par le client. Vous pouvez aussi ajouter cette ligne à votre fichier ~/.bashrc ou ~/.zshrc pour éviter de la retaper à chaque session.

Lancer une recherche simple depuis le terminal

Une fois le client configuré, vous pouvez lancer une recherche très simplement. Par exemple :

perplexity "Quelle est la capitale du Japon ?"

Le client retournera directement la réponse, parfois accompagnée de citations de sources.

Vous pouvez aussi préciser certains paramètres, comme le nombre de résultats :

perplexity "Nouvelles tendances SEO 2025" --max-results 5

Cette simplicité transforme le terminal en véritable moteur de recherche instantané.

Exploiter les résultats en JSON

L’un des grands avantages de la Search API est de renvoyer des résultats structurés. Vous pouvez par exemple récupérer les résultats en JSON et les traiter avec des outils comme jq.

Exemple :

perplexity "Actualité cybersécurité" --json | jq '.results[].url'

Cette commande affichera uniquement les URL des résultats trouvés.

De la même manière, vous pouvez extraire les titres ou les extraits pour construire un rapport automatique.

Pourquoi préférer le terminal à un navigateur ?

Vous pourriez vous demander pourquoi utiliser la Search API depuis un terminal alors qu’il est si simple d’ouvrir un moteur de recherche classique.

La réponse tient en un mot : automatisation.

Depuis un terminal, vous pouvez :

• Enchaîner des recherches automatiquement.
• Stocker les résultats dans des fichiers ou bases de données.
• Programmer des scripts qui se lancent à des moments précis sans intervention humaine.

C’est cette automatisation qui ouvre la voie à des cas d’utilisation avancés, comme la veille automatisée, que nous verrons plus loin.

Comprendre la structure des résultats de la Search API

Lorsque vous effectuez une recherche avec la Search API, la réponse renvoyée est au format JSON. Ce format est lisible par l’homme, mais surtout pensé pour être exploité par un programme.

Prenons un exemple simplifié de résultat :

{
  "results": [
    {
      "title": "La cybersécurité en 2025 : tendances clés",
      "url": "https://exemple.com/cybersecurite-2025",
      "snippet": "Un rapport récent met en avant l’importance croissante de l’IA...",
      "date": "2025-09-20"
    },
    {
      "title": "Les nouvelles menaces en cybersécurité",
      "url": "https://exemple.com/nouvelles-menaces",
      "snippet": "Les attaques par phishing évoluent rapidement et deviennent...",
      "date": "2025-09-19"
    }
  ]
}

Chaque objet de la liste contient des informations clés :

• title : le titre de la page.
• url : le lien direct vers la source.
• snippet : un extrait de contenu pour comprendre le contexte.
• date : la date de publication si elle est disponible.

Ces données structurées sont idéales pour générer un rapport ou alimenter un tableau de bord.

Exploiter les résultats avec jq

Un outil très utile pour manipuler du JSON dans le terminal est jq.

Des formations informatique pour tous !

Débutant ou curieux ? Apprenez le développement web, le référencement, le webmarketing, la bureautique, à maîtriser vos appareils Apple et bien plus encore…

Formateur indépendant, professionnel du web depuis 2006, je vous accompagne pas à pas et en cours particulier, que vous soyez débutant ou que vous souhaitiez progresser. En visio, à votre rythme, et toujours avec pédagogie.

Découvrez mes formations Qui suis-je ?

Par exemple, si vous voulez uniquement les titres des résultats :

perplexity "Tendances SEO 2025" --json | jq '.results[].title'

Si vous souhaitez uniquement les URL :

perplexity "Tendances SEO 2025" --json | jq '.results[].url'

Et pour afficher à la fois le titre et l’URL, joliment formatés :

perplexity "Tendances SEO 2025" --json | jq -r '.results[] | "\(.title) - \(.url)"'

Vous obtenez alors une liste lisible que vous pouvez sauvegarder dans un fichier texte ou CSV.

Enregistrer les résultats dans un fichier

Pour garder une trace de vos recherches, vous pouvez rediriger la sortie vers un fichier. Exemple :

perplexity "Actualité cybersécurité" --json | jq -r '.results[] | "\(.date) | \(.title) | \(.url)"' > rapport.txt

Ce fichier rapport.txt contiendra une liste de résultats triés et prêts à être consultés.

Vous pouvez également générer un fichier CSV exploitable dans un tableur comme Excel ou Google Sheets :

perplexity "Actualité cybersécurité" --json | jq -r '.results[] | "\(.date),\(.title),\(.url)"' > rapport.csv

Intégrer la Search API dans un script Bash

Supposons que vous vouliez automatiser une recherche quotidienne sur la cybersécurité. Vous pourriez créer un petit script Bash nommé veille.sh :

#!/bin/bash

DATE=$(date +%Y-%m-%d)
FICHIER="veille_$DATE.txt"

perplexity "Actualité cybersécurité" --json | jq -r '.results[] | "\(.date) | \(.title) | \(.url)"' > $FICHIER

echo "Rapport de veille généré : $FICHIER"

Ce script crée un fichier nommé par la date du jour, contenant les résultats de recherche.

Planifier l’exécution avec cron

Cron est un planificateur de tâches sous Linux et macOS. Il permet d’exécuter automatiquement un script à une heure ou une fréquence définie.

Pour programmer notre script de veille, tapez :

crontab -e

Ajoutez une ligne comme celle-ci pour exécuter le script tous les jours à 8h du matin :

0 8 * * * /chemin/vers/veille.sh

Dès lors, chaque matin à 8h, votre script sera exécuté et un nouveau fichier de rapport sera généré automatiquement.

Vers une veille automatisée plus avancée

Ce que nous venons de mettre en place est une base solide. Mais il est possible d’aller plus loin :

• Générer un rapport PDF avec une mise en page propre.
• Envoyer automatiquement le rapport par email à une liste de destinataires.
• Stocker les résultats dans une base de données pour les analyser sur le long terme.
• Créer un dashboard web qui affiche les résultats en temps réel.

La Search API vous offre une flexibilité totale pour construire ce type d’outils.

Cas pratique : Scraping intelligent et veille automatisée

Objectif du projet :

L’objectif est de mettre en place un système qui :

1. Recherche automatiquement les dernières informations sur un sujet donné (par exemple, « cybersécurité » ou « tendances SEO »).
2. Enregistre les résultats dans un fichier structuré et lisible.
3. Peut être exécuté chaque jour sans intervention manuelle.

Nous utiliserons un script Bash et la Search API de Perplexity, puis planifierons son exécution avec cron.

Étape 1 : Préparer votre environnement

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Un compte Perplexity et une clé API valide.
• Python et pip installés sur votre machine (pour le client CLI perplexity-cli).
• jq installé pour manipuler le JSON (sudo apt install jq sous Linux, brew install jq sous macOS).
• Un terminal fonctionnel et des permissions pour créer et exécuter des scripts.

Vérifiez que perplexity-cli fonctionne :

perplexity --help

Si vous voyez les options du client, tout est prêt.

Étape 2 : Créer le script de veille

Créez un fichier nommé veille.sh dans votre répertoire préféré :

nano ~/veille.sh

Copiez-y le contenu suivant :

#!/bin/bash

# Date du jour pour nommer le fichier
DATE=$(date +%Y-%m-%d)
FICHIER="$HOME/veille_$DATE.txt"

# Sujet de la recherche
SUJET="cybersécurité"

# Exécuter la recherche avec la Search API
perplexity "$SUJET" --json | jq -r '.results[] | "\(.date) | \(.title) | \(.url)"' > $FICHIER

# Afficher un message de confirmation
echo "Rapport de veille généré : $FICHIER"

Explications :

• DATE=$(date +%Y-%m-%d) : récupère la date du jour pour générer un fichier unique.
• FICHIER="$HOME/veille_$DATE.txt" : définit le chemin du fichier de sortie.
• SUJET="cybersécurité" : ici, vous pouvez remplacer le mot-clé par n’importe quel sujet.
• La commande perplexity exécute la recherche et jq extrait la date, le titre et l’URL.
• Le résultat est enregistré dans $FICHIER.
• echo affiche un message pour savoir que le script a fonctionné.

Enregistrez et fermez le fichier (CTRL+O puis CTRL+X sous nano).

Étape 3 : Rendre le script exécutable

Avant de pouvoir lancer le script, il faut lui donner les droits d’exécution :

chmod +x ~/veille.sh

Pour en savoir plus : CHMOD : Gérer vos fichiers et dossiers depuis le terminal

Testez-le :

~/veille.sh

Vous devriez voir un message du type :

Rapport de veille généré : /home/votre_utilisateur/veille_2025-09-26.txt

Le fichier contiendra les résultats structurés de votre recherche.

Étape 4 : Automatiser avec cron

Cron permet d’exécuter votre script automatiquement à intervalles réguliers.

1. Ouvrez le planificateur de tâches cron :

crontab -e

2. Ajoutez la ligne suivante pour exécuter le script tous les jours à 8h :

0 8 * * * /home/votre_utilisateur/veille.sh

Explication de la syntaxe cron :

• 0 8 * * * : minute 0, heure 8, tous les jours, tous les mois, tous les jours de la semaine.
• /home/votre_utilisateur/veille.sh : chemin complet vers votre script.

Enregistrez et quittez. Cron exécutera désormais votre script automatiquement chaque matin.

Étape 5 : Améliorer le rapport

Vous pouvez enrichir le rapport en ajoutant :

• Une séparation claire entre chaque résultat.
• L’ajout d’extraits (snippet) pour voir un résumé du contenu.
• Un format CSV pour faciliter l’import dans Excel ou Google Sheets.

Exemple d’amélioration dans le script :

perplexity "$SUJET" --json | jq -r '.results[] | "\(.date),\(.title),\(.url),\(.snippet)"' > $FICHIER

Le fichier généré sera ainsi directement exploitable pour des analyses ou des visualisations.

Étape 6 : Déploiement et maintenance

Pour que votre veille reste efficace :

• Vérifiez régulièrement que votre clé API n’a pas expiré.
• Ajustez le sujet de recherche selon vos besoins.
• Supprimez ou archivez les anciens rapports pour éviter de saturer votre disque.
• Vous pouvez également combiner plusieurs sujets dans le script pour générer un rapport multi-thématiques.

Grâce à ce système, vous disposez d’un outil simple mais puissant de veille automatisée. La Search API de Perplexityvous permet d’obtenir des informations à jour sans effort manuel. Chaque matin, vous recevez un rapport structuré sur votre sujet d’intérêt, prêt à être consulté ou analysé.

Vous pouvez aller plus loin en intégrant ces rapports dans un tableau de bord web, en générant automatiquement des graphiques ou en déclenchant des alertes email si certains mots-clés apparaissent dans les résultats.

Ce type de solution illustre parfaitement la valeur ajoutée de la Search API : automatiser, structurer et exploiter l’information du web à votre rythme, tout en gardant le contrôle total sur vos données.

Exploitez pleinement la Search API de Perplexity

Au cours de ce tutoriel complet, nous avons exploré la Search API de Perplexity sous tous ses aspects. Nous avons commencé par comprendre ce qu’elle est et pourquoi elle représente un atout majeur pour toute personne souhaitant automatiser et structurer ses recherches.

Nous avons découvert que cette API permet de récupérer directement les résultats d’une recherche web en format JSON, ce qui facilite leur traitement et leur intégration dans vos projets. Nous avons également détaillé ses avantages : gain de temps, résultats structurés, personnalisation des requêtes, automatisation, et possibilité d’intégrer les données dans des outils ou applications variés.

Nous avons ensuite appris à installer et configurer le client CLI perplexity-cli, à réaliser nos premières requêtes depuis le terminal et à exploiter les résultats avec des outils comme jq pour extraire les informations pertinentes. Cette étape vous permet désormais de transformer vos recherches en données exploitables et de générer des rapports structurés.

Enfin, nous avons mis en place un cas pratique complet : un système de veille automatisée sur un sujet précis, capable de générer chaque jour un rapport contenant les derniers résultats de recherche. Nous avons vu comment créer le script Bash, l’exécuter manuellement, puis l’automatiser avec cron pour qu’il fonctionne sans intervention humaine. Cette mise en pratique montre clairement comment la Search API peut servir à des projets réels, qu’il s’agisse de veille SEO, cybersécurité, IA ou autres thématiques.

Conseils pour optimiser vos recherches avec la Search API

1. Choisir les bons mots-clés : plus vos requêtes sont précises, plus les résultats seront pertinents. N’hésitez pas à combiner plusieurs mots-clés pour cibler exactement l’information que vous souhaitez.
2. Limiter le nombre de résultats : la Search API permet de définir le nombre maximal de résultats par requête. Ajustez-le selon vos besoins pour éviter de récupérer trop de données inutiles.
3. Utiliser les filtres avancés : date, domaine, langue ou type de contenu. Ces filtres augmentent la pertinence des résultats et réduisent le bruit.
4. Structurer vos scripts : utilisez le JSON pour extraire uniquement les champs nécessaires, comme le titre, l’URL ou l’extrait. Cela rend l’analyse plus simple et plus rapide.
5. Automatiser avec prudence : planifiez vos scripts à des intervalles raisonnables et surveillez votre quota API pour ne pas le dépasser.

Perspectives et usages avancés

La Search API ouvre de nombreuses possibilités au-delà de la simple veille. Parmi les usages avancés :

• Intégrer les résultats dans un tableau de bord web pour visualiser en temps réel l’évolution d’un sujet.
• Générer automatiquement des alertes email ou notifications lorsqu’un mot-clé spécifique apparaît dans les résultats.
• Combiner la Search API avec d’autres outils d’analyse de données pour détecter des tendances ou anomalies.
• Créer un assistant personnel ou chatbot capable de répondre aux questions avec des informations actualisées et sourcées.
• Alimenter une base de données historique afin d’analyser les évolutions d’un marché ou d’un domaine d’expertise.

Chaque projet peut être adapté à vos besoins spécifiques : la flexibilité de la Search API permet d’automatiser et d’optimiser la recherche d’information de manière très poussée.

La Search API de Perplexity est bien plus qu’un simple moteur de recherche. Elle transforme la manière dont nous accédons à l’information en rendant la recherche automatisable, structurée et exploitable dans n’importe quel projet. Que vous soyez développeur, analyste, responsable marketing ou simple curieux, cette API vous permet de gagner du temps, d’obtenir des données fiables et d’optimiser vos processus de veille.

En suivant ce tutoriel, vous avez désormais toutes les clés pour installer l’API, lancer vos premières recherches depuis le terminal, exploiter les résultats et créer un système de veille automatisé. Vous êtes capable de passer d’une recherche manuelle et chronophage à un flux d’informations structuré et automatisé, adapté à vos besoins professionnels ou personnels.

La véritable valeur ajoutée de la Search API réside dans sa capacité à mettre la puissance du web à portée de vos scripts, pour transformer l’information brute en connaissance exploitable. Les possibilités sont infinies, et le seul frein est votre imagination.

Alban

Fondateur de l’agence Créa-troyes.
Intervenant en Freelance.
Contactez-moi

crea-troyes.fr