L’API Perplexity permet d’ajouter de la recherche web sourcée dans vos outils, vos automatisations ou vos applications internes. Elle peut répondre à une question, chercher des informations récentes et renvoyer une synthèse avec des sources exploitables.
Dans ce guide, on voit comment utiliser l’API Perplexity concrètement : créer une clé API, choisir le bon modèle, faire un premier appel, connecter l’API à n8n ou Make, estimer le coût et éviter les erreurs classiques.
En bref : Comment utiliser l’API Perplexity en 5 étapes ?
Pour démarrer simplement, utilisez le modèle sonar, envoyez une requête courte, puis récupérez le champ choices[0].message.content. Vous pourrez ensuite ajouter les sources, ajuster le modèle ou connecter la réponse à vos outils métier.
C’est quoi l’API Perplexity ?
L’API Perplexity permet d’envoyer une question à Perplexity depuis un outil externe : n8n, Make, un script, une application interne ou un tableau de bord.
Son intérêt principal est d’obtenir une réponse basée sur des informations web récentes. C’est donc une API intéressante pour la veille, l’analyse de marché, l’enrichissement de données ou la mise à jour de contenus.
Quelle différence entre Sonar API et Search API ?
Perplexity propose plusieurs API, mais deux sont importantes à connaître au départ : Sonar API et Search API.
Pour une PME, Sonar API est le meilleur point de départ. Elle fournit directement une réponse exploitable, avec des sources. La Search API est plus utile si vous voulez récupérer des résultats bruts et les traiter vous-même ensuite.
Quelle différence avec l’API ChatGPT ?
Perplexity est plus adaptée aux recherches web récentes avec sources. ChatGPT, Claude ou Gemini restent plus pertinents pour rédiger, reformuler ou traiter des documents internes.
Comment obtenir une clé API Perplexity ?
Pour utiliser l’API Perplexity, vous devez créer une clé API. Cette clé permet à vos outils de s’authentifier auprès de Perplexity.
Sans clé API, impossible d’appeler Perplexity depuis n8n, Make, Python ou un autre service.
Comment créer son accès API ?
Le parcours est simple :
- connectez-vous à votre compte Perplexity ;
- accédez à la console API ;
- créez un API Group ;
- ajoutez vos informations de facturation si nécessaire ;
- générez une clé API ;
- copiez-la dans un endroit sécurisé.
Un API Group sert à regrouper vos clés API, vos crédits et vos paramètres de facturation. Pour tester, un seul groupe suffit. Si vous gérez plusieurs projets ou clients, vous pourrez en créer d’autres plus tard.
L’API fonctionne avec des crédits API. Il n’est pas nécessaire d’avoir un abonnement Perplexity Pro, mais vous devez disposer de crédits pour effectuer des appels.
Comment sécuriser sa clé API ?
Une clé API doit rester privée. Ne la mettez jamais dans un fichier public, un dépôt GitHub ou du code côté front-end.
Stockez-la plutôt dans :
- une variable d’environnement ;
- les credentials n8n ;
- la connexion sécurisée Make ;
- un gestionnaire de mots de passe.
Si une clé est exposée, supprimez-la et générez-en une nouvelle.
Quel modèle Perplexity choisir ?
Perplexity propose plusieurs modèles Sonar. Le bon choix dépend surtout de votre besoin : veille simple, recherche plus complète, raisonnement complexe ou rapport approfondi.
Les frais de requête varient selon la taille du contexte de recherche : Low, Medium ou High. Plus le contexte est large, plus la recherche peut être complète, mais plus la requête coûte cher.
Pour une PME, commencez avec sonar. Passez à sonar-pro si les réponses manquent de profondeur. Gardez sonar-reasoning-pro pour les analyses complexes et sonar-deep-research pour des rapports ponctuels, pas pour des workflows qui tournent tous les jours.
Comment faire un premier appel à l’API Perplexity ?
Une fois votre clé API créée, vous pouvez faire un premier test avec cURL ou Python.
Comment tester l’API Perplexity avec cURL ?
Voici un exemple simple avec l’endpoint Sonar :
curl --request POST \
--url https://api.perplexity.ai/v1/sonar \
--header "Authorization: Bearer $PERPLEXITY_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "sonar",
"messages": [
{
"role": "user",
"content": "Quelles sont les grandes tendances de l'automatisation pour les PME en 2026 ?"
}
]
}'
Avant d’exécuter la commande, ajoutez votre clé API en variable d’environnement :
export PERPLEXITY_API_KEY="votre_cle_api"
Si la requête fonctionne, Perplexity renvoie une réponse au format JSON.
Comment utiliser l’API Perplexity avec Python ?
Perplexity est compatible avec le SDK OpenAI. Vous pouvez donc utiliser une structure proche d’un appel OpenAI classique, en changeant simplement le base_url.
Installez d’abord le SDK :
pip install openai
Puis utilisez ce code :
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("PERPLEXITY_API_KEY"),
base_url="https://api.perplexity.ai"
)
response = client.chat.completions.create(
model="sonar",
messages=[
{
"role": "user",
"content": "Quelles sont les dernières tendances no-code pour les PME ?"
}
]
)
print(response.choices[0].message.content)
Cette méthode est pratique si vous utilisez déjà OpenAI dans vos outils. Vous pouvez tester Perplexity sans réécrire toute votre logique.
Comment lire la réponse de l’API ?
Les champs les plus utiles sont :
Dans une automatisation simple, vous allez surtout récupérer :
choices[0].message.content
Pour une veille ou une analyse, conservez aussi les sources et le coût. Cela permet de vérifier les réponses et de suivre le budget réel.
Comment connecter Perplexity à n8n ou Make ?
L’API Perplexity peut être utilisée avec du code, mais elle est aussi très pratique dans des outils no-code comme n8n et Make.
Pour une PME, c’est souvent le meilleur point d’entrée : pas besoin de développer une application complète, il suffit d’ajouter Perplexity dans un workflow existant.
Option 1 : utiliser le module natif
n8n propose un node Perplexity. Make propose aussi une intégration Perplexity AI.
C’est l’option la plus simple si vous voulez aller vite :
- ajoutez le module Perplexity ;
- connectez votre clé API ;
- choisissez le modèle ;
- écrivez votre prompt ;
- récupérez la réponse dans l’étape suivante.
Exemple de prompt avec une variable :
Analyse les dernières actualités de cette entreprise : {{nom_entreprise}}.
Retourne :
- un résumé en 5 lignes ;
- les informations importantes ;
- les sources utilisées.
Option 2 : utiliser un appel HTTP
L’appel HTTP est plus flexible. Il permet de contrôler précisément l’endpoint, les headers et le body JSON.
La configuration est la même dans n8n et Make :
Exemple de body :
{
"model": "sonar",
"messages": [
{
"role": "user",
"content": "Résume les dernières actualités sur {{entreprise}} cette semaine."
}
]
}
La logique est simple : n8n ou Make envoie la question à Perplexity, puis récupère la réponse pour l’ajouter dans Google Sheets, Airtable, Notion, Slack, Gmail ou un autre outil.
Quel workflow simple créer avec Perplexity ?
Le meilleur premier cas d’usage est une veille concurrentielle.
Ce workflow est simple, peu coûteux et facile à mesurer. C’est donc un bon test avant d’aller vers des automatisations plus ambitieuses.
Combien coûte l’API Perplexity ?
L’API Perplexity fonctionne avec une tarification à l’usage. Vous payez selon le modèle utilisé, le volume de tokens et les frais de requête liés au contexte de recherche.
La formule à retenir :
Coût total = coût des tokens + frais de requête
Ce point est important, car l’API n’est pas uniquement facturée au token.
Comment fonctionne la facturation ?
Chaque appel peut inclure :
Pour un usage classique avec sonar, les coûts restent assez prévisibles. Ils augmentent surtout avec le nombre de requêtes.
Quel budget prévoir pour 1 000 requêtes avec Sonar ?
Prenons une hypothèse simple :
- modèle : sonar ;
- contexte : Low ;
- 500 tokens en entrée ;
- 300 tokens en sortie ;
- 1 000 requêtes par mois.
Dans cet exemple, l’essentiel du coût vient du frais de requête, pas des tokens.
Combien coûte Perplexity selon le volume ?
Ces chiffres sont des estimations. Le coût réel dépend de la longueur des prompts, de la longueur des réponses et du contexte de recherche choisi.
Pourquoi faire attention à Sonar Deep Research ?
sonar-deep-research peut facturer plusieurs éléments supplémentaires : citations, recherches et tokens de raisonnement.
Il est donc à réserver aux analyses ponctuelles. Pour une automatisation régulière, utilisez plutôt sonar ou sonar-pro.
Quels cas d’usage pour une PME ?
L’API Perplexity est surtout intéressante pour automatiser des recherches répétitives. Elle permet de gagner du temps sans demander à une équipe de consulter plusieurs sources à la main.
Comment automatiser une veille concurrentielle ?
Une PME peut créer un workflow qui surveille chaque semaine ses concurrents.
Exemple :
- la liste des concurrents est stockée dans Google Sheets ;
- n8n lit chaque ligne ;
- Perplexity cherche les actualités récentes ;
- le résumé est ajouté dans le tableau ;
- un email récapitulatif est envoyé à l’équipe.
Prompt possible :
Recherche les actualités récentes concernant l’entreprise suivante : {{nom_entreprise}}.
Retourne :
les nouveautés importantes ;les annonces récentes ;les sources utilisées ;une synthèse en 5 lignes.
Ce cas d’usage est un bon point de départ, car il est simple à tester et directement utile pour une équipe commerciale, marketing ou dirigeante.
Quelles erreurs éviter avec l’API Perplexity ?
Voici les erreurs les plus fréquentes à éviter avant de mettre une automatisation en production.
Avant de passer en production, testez toujours votre workflow sur quelques lignes. Vérifiez la qualité des réponses, les sources, le coût et le comportement en cas d’erreur.
Faut-il utiliser l’API Perplexity dans une PME ?
Oui, si votre PME veut automatiser une recherche web répétitive : veille concurrentielle, suivi de marché, enrichissement de données ou mise à jour de contenus.
Non, si vous cherchez surtout un outil de rédaction, de traitement documentaire interne ou de génération créative. Dans ces cas, une API comme OpenAI, Claude ou Gemini peut être plus adaptée.
