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.
Les fonctionnalités Surfer suivantes sont actuellement réservées au tableau de bord et n'ont pas de points de terminaison API :
Fonctionnalité | Pourquoi c'est important |
Maillage interne | L'outil de suggestion de liens intégré à GSC de Surfer fonctionne exclusivement dans le tableau de bord |
Cartes thématiques / Vue des sites | Le clustering de mots-clés et la planification des silos de contenu sont disponibles uniquement dans l'interface |
Personnalisation des concurrents | 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 |
Vérificateur de plagiat | L'examen du plagiat avant publication s'exécute uniquement dans l'éditeur, depuis le navigateur |
AI Tracker | 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) |
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)
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 à [email protected].
Toutes les demandes sans accès approprié seront bloquées, même si une clé API valide est fournie.
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 !
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.
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.
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.
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 à [email protected].
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.
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".
Si vous avez perdu votre clé API, vous pouvez en demander une nouvelle via notre Support à [email protected]. Nous vous renverrons votre clé ou, si vous le souhaitez, nous en générerons une nouvelle à la place.
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 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.
