---
title: "Introduction à l'API Surfer"
description: "Surfer disponible via API : gérez vos requêtes sans accéder à votre tableau de bord !"
url: https://docs.surferseo.com/fr/articles/5700335-introduction-a-l-api-surfer
collection: "API"
updated: 2026-11-10
language: fr
alternates: [en, de]
---

# Introduction à l'API Surfer

Surfer disponible via API : gérez vos requêtes sans accéder à votre tableau de bord !

## **Aperçu de l'API Surfer**

Surfer propose une API qui vous permet d'accéder aux fonctionnalités principales, notamment l'audit, la création de contenu, et bien plus. L'API est adaptée aux développeurs, aux spécialistes du SEO technique et aux partenaires qui souhaitent intégrer les capacités de Surfer dans leurs flux de travail ou leurs outils.

> **Success:** [L'API V2 est arrivée](https://app.surferseo.com/api/v2/docs) 🎉 Gérez les éditeurs de contenu, générez des plans, déclenchez la rédaction IA, obtenez un index d'API lisible par LLM, et bien plus !

* * *

## 🚫 Ce qui n'est pas disponible via l'API

Les fonctionnalités Surfer suivantes sont actuellement **réservées au tableau de bord** et n'ont pas de points de terminaison API :

<table data-id="0ddcba10-026b-4e80-b456-27af0ea10970" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="1203d11c-bfa1-4bc2-8b50-d978ef44e4b3"><strong>Fonctionnalité</strong></p></td><td colspan="1" rowspan="1"><p data-id="820c4f48-b898-4127-a8ea-9981f24c820d"><strong>Pourquoi c'est important</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="d518e303-ad72-4893-be6a-beefbac45571"><strong>Maillage interne</strong></p></td><td colspan="1" rowspan="1"><p data-id="fa875eef-5cb4-4912-944e-f6a4a4f68a1a">L'outil de suggestion de liens intégré à GSC de Surfer fonctionne exclusivement dans le tableau de bord</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="3bb52b63-1aa9-4311-bf20-6475a5682980"><strong>Cartes thématiques / Vue des sites</strong></p></td><td colspan="1" rowspan="1"><p data-id="7d830c51-a054-4c4f-bd90-d824ebb74709">Le clustering de mots-clés et la planification des silos de contenu sont disponibles uniquement dans l'interface</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="20e5600f-d180-41e4-9e56-18771ba5ebd8"><strong>Personnalisation des concurrents</strong></p></td><td colspan="1" rowspan="1"><p data-id="4dc921d7-9304-4d01-acb1-768465181172">Dans le tableau de bord, vous pouvez désélectionner les concurrents (par exemple Wikipedia, Pinterest) de l'analyse SERP ; l'API utilise la sélection par défaut des 10 premiers de Surfer</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="a961680d-9736-415a-a408-951459eea718"><strong>Vérificateur de plagiat</strong></p></td><td colspan="1" rowspan="1"><p data-id="c0c3dbc9-18f9-456d-b075-59b86d31d104">L'examen du plagiat avant publication s'exécute uniquement dans l'éditeur, depuis le navigateur</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="7267d0f8-e810-4d48-8aef-d5d040e90742"><strong>AI Tracker</strong></p></td><td colspan="1" rowspan="1"><p data-id="98553cf8-744c-4748-b783-f63a60403696">Le suivi et la surveillance de la visibilité dans l'IA ne sont pas exposés via l'API (pas encore, mais nous y travaillons)</p></td></tr></tbody></table>

Si vous créez un flux de travail programmatique, envisagez d'utiliser le tableau de bord pour les tâches stratégiques (cartographie thématique, sélection des concurrents, maillage interne) et l'API pour l'exécution (création d'éditeurs, génération de contenu, exécution d'audits)

* * *

## 🔒 Conditions d'accès

**Cette fonctionnalité est disponible avec le plan Peace of Mind ou Enterprise.** Pour vérifier si c'est le bon choix ou explorer d'autres options disponibles, veuillez contacter notre équipe commerciale via ce formulaire ou par email à **sales@surferseo.com**.

Toutes les demandes sans accès approprié seront bloquées, même si une clé API valide est fournie.

* * *

> **Success:** **N'oubliez pas :** Si cet article ne répond pas à vos questions, nous sommes là pour vous ! Remplissez un sondage à la fin de cet article, ou contactez-nous via **chat** ou à : **support@surferseo.com!**

## ⚙ Que pouvez-vous faire avec l'API ?

Vous pouvez automatiser des actions avec des requêtes API sans ouvrir l'application web Surfer à chaque fois. Cela inclut :

-   Créer et gérer les requêtes **Content Editor**
    
-   Générer du contenu via **Surfer AI**
    
-   Exécuter les rapports **Audit**
    
-   Accéder aux données **SERP Analyzer**
    
-   Générer des liens partageables
    
-   Extraire des données structurées pour des tableaux de bord personnalisés
    
-   Détecter le contenu généré par l'IA dans votre texte (AI Detector)
    
-   Humaniser le texte (paraphraser pour un ton plus naturel tout en conservant le sens)
    
-   ... et bien d'autres, décrits dans notre documentation de l'API !
    

* * *

## 📚 Documentation API

### **Surfer API V1**

Détails sur les points de terminaison, l'authentification et les formats de requête/réponse, disponibles ici 👉 [Documentation de l'API Surfer V1](https://app.surferseo.com/api/v1/docs#section/Introduction).  

> **Info:** Si vous recherchez la documentation des outils **Audit**, **SERP Analyzer**, **AI Detector** et **Humanizer**, elle n'est actuellement disponible que dans l'API V1.

### **API Surfer V2**

Pour tous les détails sur les points de terminaison, l'authentification et les formats de requête/réponse, naviguez ici 👉 [Documentation de l'API Surfer V2](https://app.surferseo.com/api/v2/docs).

**Quoi de neuf dans V2 :**

\- **Gestion de Content Editor** : créer et gérer des documents Content Editor via l'API.

\- **Nouveau Content Score** : accédez aux scores basés sur le modèle de notation mis à jour (couvre à la fois le SEO et la visibilité IA).

\- **Génération de plan** : générer des plans de contenu par programmation.

\- **Surfer AI** : déclencher la rédaction Surfer AI via l'API.

> **Success:** Vous construisez une intégration LLM ou un agent ? [/llms.txt](https://app.surferseo.com/llms.txt) est un index lisible par machine en texte brut de notre documentation API V2. Profitez-en !

* * *

## Questions fréquemment posées (FAQ)

### Comment m'authentifier auprès de l'API Surfer ?

L'API Surfer utilise des clés API pour l'authentification. Si vous êtes déjà abonné au plan **Peace of Mind** ou **Enterprise** et avez besoin de votre clé API, contactez-nous via le Live Chat ou par email à [support@surferseo.com](mailto:support@surferseo.com).

Vous devez authentifier vos appels en tant que propriétaire du compte. Aucun autre membre, y compris les administrateurs, ne peut le faire. En savoir plus sur les rôles [ici](https://docs.surferseo.com/en/articles/5700295-organizations-and-members.md).

Incluez votre clé API dans l'en-tête de la requête en utilisant le champ `API-KEY`. Les requêtes sans clé valide ou effectuées sans le plan ou module complémentaire requis recevront une réponse **401 "Access Denied"**.

### J'ai perdu ma clé API : comment en obtenir une nouvelle ?

Si vous avez perdu votre clé API, vous pouvez en demander une nouvelle via notre Support à [support@surferseo.com](mailto:support@surferseo.com). Nous vous renverrons votre clé ou, si vous le souhaitez, nous en générerons une nouvelle à la place.

### Y a-t-il un environnement de test ou de sandbox disponible ?

Nous n'offrons pas actuellement d'environnement de sandbox. Toutes les requêtes API que vous envoyez consommeront les limites réelles de votre compte et compteront dans le quota de votre plan.

### L'accès à l'API inclut-il tous les outils automatiquement ?

L'accès à l'API ne déverrouille pas automatiquement tous les outils compatibles avec l'API. Si votre plan ou module complémentaire n'inclut pas des outils comme **Audit** ou **SERP Analyzer**, les points de terminaison associés ne fonctionneront pas, même avec une clé API valide.

Vous pouvez recevoir des erreurs telles que **403 « Forbidden »**, **422 « Quota exceeded »**, ou **500 « Internal server error »**, selon l'outil et l'appel.

## Ressources supplémentaires

[Exemples d'utilisation de l'API Surfer](https://docs.surferseo.com/en/articles/8201326-surfer-api-examples-of-use.md)

[Documentation de l'API Surfer](https://app.surferseo.com/api/v1/docs#section/Introduction)

​[Dépannage de l'API Surfer](https://docs.surferseo.com/en/articles/8196553-surfer-api-troubleshooting.md)
