Si vous gérez le SEO WordPress dans le cadre d'un flux de développement, vous avez probablement souhaité à un moment donné pouvoir ignorer l'administration et simplement effectuer un appel API. À partir de la version 4.9.8, c'est possible.
L'API REST AIOSEO est désormais gratuite pour tous les plans, y compris Lite.
L'API REST a désormais 2 utilisations distinctes depuis sa version originale en 4.1.9. La première est celle que vous connaissez probablement déjà : elle ajoute des champs de métadonnées SEO aux points de terminaison WordPress afin que les développeurs créant des sites headless puissent extraire les balises de titre, les méta-descriptions et le schéma directement dans leur frontend.
La seconde est nouvelle dans la version 4.9.8. Elle expose la couche des Capacités dans WordPress : 28 actions SEO
que les utilisateurs d'AIOSEO MCP et de WP-CLI connaissent déjà, désormais appelables via HTTP depuis n'importe quel langage ou pile. Toute requête HTTP authentifiée peut désormais faire ce qu'un agent IA fait.
Jusqu'à présent, ces fonctionnalités nécessitaient un plan Plus (ou supérieur) et l'installation d'un module complémentaire séparé. Depuis cette version, ce n'est plus le cas. Le module complémentaire est déprécié et fusionné dans le cœur du système, donc si vous avez déjà mis à jour, il est là.
Voici ce que la nouvelle API REST AIOSEO vous permet réellement de faire.
Dans cet article
Ce que vous pouvez faire via l'API REST
En pratique, les nouvelles capacités d'AIOSEO vous permettent de faire des choses comme :
- Trouver tous les articles de votre site qui n'ont pas de méta-description et les retourner sous forme de liste
- Mettre à jour les titres SEO et les méta-descriptions en masse sur une catégorie ou un type de contenu
- Créer, mettre à jour ou supprimer des redirections sans toucher à l'administration de WordPress
- Extraire les scores TruSEO pour n'importe quel article afin de surveiller la santé SEO dans un tableau de bord personnalisé
- Récupérer les données de performance de la Search Console par article ou par période
- Vérifier quels articles sont marqués comme orphelins ou manquent de liens internes
Et vous n'êtes pas limité à la lecture des données. Tout script ou outil qui se connecte en utilisant vos identifiants peut apporter des modifications, de la même manière qu'un agent IA le fait via AIOSEO MCP.
Vous n'écrivez pas vous-même les scripts ? AIOSEO MCP connecte des outils d'IA comme Claude, Cursor et ChatGPT directement à votre site. Mêmes capacités, aucun code requis.
Remarque : Certaines capacités sont liées à des fonctionnalités spécifiques d'AIOSEO et nécessitent le plan qui les inclut. Les capacités de Link Assistant nécessitent Pro ou supérieur, et les capacités de Search Statistics nécessitent Elite.
Le cas d'utilisation original de WordPress headless fonctionne toujours
Si vous construisez un site WordPress headless, où WordPress gère le contenu et un frontend séparé construit en Next.js, Gatsby ou Astro gère l'affichage, AIOSEO le supporte depuis la version 4.1.9. Rien dans la configuration ne change dans la version 4.9.8. Chaque point de terminaison supporté renvoie 3 champs SEO supplémentaires lorsque AIOSEO est actif :
aioseo_headest la sortie SEO complète pour le<head>de votre page : balises de titre, méta-descriptions, URL canoniques, données Open Graph et schéma JSON-LD, prêts à être insérés sous forme de chaîne HTML.aioseo_head_jsonrenvoie les mêmes informations au format JSON, sans le balisage HTML.aioseo_meta_datavous donne les champs SEO bruts stockés dans la base de données d'AIOSEO. Vous pouvez les lire et les mettre à jour via l'API.
La seule chose qui a changé, c'est que ces champs ne sont plus réservés aux plans payants.
Ce qui a changé dans la version 4.9.8
Avant cette version, l'accès aux champs de métadonnées headless ou aux fonctionnalités nécessitait un plan Plus (ou supérieur) et une installation séparée du module complémentaire depuis le gestionnaire de fonctionnalités. Les deux ont disparu.
Lorsque vous mettez à jour vers la version 4.9.8, tout est automatiquement disponible. Aucun module complémentaire à activer, aucun plan requis.
Si vous aviez le module complémentaire installé auparavant et qu'il n'apparaît plus dans le gestionnaire de fonctionnalités, c'est normal. La fonctionnalité est déjà là, intégrée au plugin principal.
Premiers pas
La configuration se résume à une chose : un Mot de passe d'application WordPress. Ce n'est pas votre mot de passe de connexion, mais une identification distincte que vous générez depuis votre administration WordPress. Vous pouvez en créer un en naviguant vers Utilisateurs >> Profil >> Mots de passe d'application. Vous pouvez le révoquer à tout moment, et il est spécifique à l'outil ou au script que vous connectez.
Voici un exemple de base pour récupérer les données SEO d'un article :
Remarque : Ces exemples utilisent la fonction btoa() de JavaScript pour l'encodage Base64, qui fonctionne dans les navigateurs et Node.js 16+. Sur les versions antérieures de Node.js, remplacez btoa('user:pass') parBuffer.from('user:pass').toString('base64').
const response = await fetch('https://yoursite.com/wp-json/wp/v2/posts/123', {
headers: {
Authorization: 'Basic ' + btoa('your_username:your_application_password'),
},
});
const post = await response.json();
const seoHead = post.aioseo_head; // Full <head> SEO output as HTML
const seoJson = post.aioseo_head_json; // Same data as JSONPour mettre à jour les champs SEO d'un article :
await fetch('https://yoursite.com/wp-json/wp/v2/posts/123', {
method: 'POST',
headers: {
Authorization: 'Basic ' + btoa('your_username:your_application_password'),
'Content-Type': 'application/json',
},
body: JSON.stringify({
aioseo_meta_data: {
title: 'Updated SEO Title',
description: 'Updated meta description',
},
}),
});L'API fonctionne avec tous les points de terminaison WordPress standard : /wp/v2/posts, /wp/v2/pages,
/wp/v2/media, /wp/v2/categories, /wp/v2/tags, et tout type de publication personnalisé avec
le support de l'API REST activé.
Pour la référence complète des fonctionnalités et la documentation des points de terminaison, consultez les docs développeurs de l'API REST AIOSEO.
Si vous souhaitez révoquer un mot de passe d'application, vous pouvez le faire depuis le même écran de votre administration WordPress où vous l'avez créé.
Gratuit pour tous les plans, y compris Lite
À partir de la version 4.9.8, l'API REST AIOSEO est gratuite pour tous les plans AIOSEO, y compris Lite.
Si vous gérez le SEO à grande échelle et que vous souhaitez plus de fonctionnalités de l'API, Link Assistant (Pro) et Search Statistics (Elite) valent la peine d'être explorés. Ils ajoutent certaines des fonctionnalités les plus utiles de la liste. Vous pouvez comparer les plans ici : Tarifs AIOSEO.
4.9.8 inclut également 2 autres mises à jour :
- AIOSEO MCP : Connectez des clients IA comme Claude, Cursor et ChatGPT directement à votre SEO WordPress.
- Nouveaux modèles de génération d'images IA dans le Générateur d'images IA.
L'API REST a été l'un des outils les plus utiles d'AIOSEO pour les développeurs. La rendre disponible pour tous les plans signifie que plus de personnes peuvent créer des flux de travail SEO plus intelligents et plus automatisés, et je pense que c'est la bonne décision.
Mettez à jour vers la version 4.9.8 et commencez à construire !
— Ben Rojas, Président d'AIOSEO
Questions fréquemment posées
Que puis-je faire avec l'API REST AIOSEO ?
À partir de la version 4.9.8, l'API REST vous donne accès aux 28 fonctionnalités d'AIOSEO — le même ensemble disponible via MCP. Vous pouvez mettre à jour les méta-descriptions et les titres SEO, gérer les redirections, obtenir les scores TruSEO, récupérer les données de la Search Console, et plus encore, le tout via des requêtes HTTP. Elle prend également en charge le cas d'utilisation original de WordPress headless : récupérer la sortie complète de l'en-tête SEO pour les frontends découplés.
Ai-je besoin d'un plan AIOSEO payant pour utiliser l'API REST ?
Non. À partir de la version 4.9.8, l'API REST est gratuite pour tous les plans AIOSEO, y compris Lite. Certaines fonctionnalités sont liées à des fonctionnalités spécifiques d'AIOSEO, et celles-ci nécessitent le plan qui inclut cette fonctionnalité, tout comme leur utilisation par tout autre moyen.
Le module complémentaire API REST n'est plus dans mon gestionnaire de fonctionnalités. Y a-t-il un problème ?
Non. C'est normal. Le module complémentaire a été déprécié et fusionné dans le plugin principal. L'API REST est disponible automatiquement après la mise à jour vers la version 4.9.8. Aucune réinstallation n'est nécessaire.
Quels points de terminaison WordPress l'API REST d'AIOSEO prend-elle en charge ?
Tous les points de terminaison standard de l'API REST WordPress : /wp/v2/posts, /wp/v2/pages, /wp/v2/media, /wp/v2/categories, /wp/v2/tags, et tous les types de publication personnalisés avec le support de l'API REST activé.
Quelle est la différence entre AIOSEO MCP et l'API REST ?
MCP et l'API REST exposent tous deux les mêmes 28 fonctionnalités d'AIOSEO. La différence réside dans qui les utilise. MCP est destiné aux agents IA : il permet à des outils comme Claude, Cursor et ChatGPT d'agir sur votre site via le chat. L'API REST est destinée aux développeurs : elle vous permet d'appeler ces mêmes fonctionnalités à partir de scripts, d'automatisations et d'intégrations personnalisées via HTTP. Utilisez MCP lorsque vous souhaitez que votre IA gère les tâches SEO. Utilisez l'API REST lorsque vous souhaitez créer quelque chose de programmatique vous-même.
Comment puis-je m'authentifier auprès de l'API REST d'AIOSEO ?
Utilisez un mot de passe d'application WordPress. Générez-en un dans votre administration WordPress sous Utilisateurs → Profil → Mots de passe d'application, puis incluez-le dans vos requêtes. Les exemples de code dans la section Démarrage montrent exactement comment le formater.
Divulgation : Notre contenu est financé par nos lecteurs. Cela signifie que si vous cliquez sur certains de nos liens, nous pouvons gagner une commission. Nous ne recommandons que les produits qui, selon nous, apporteront de la valeur à nos lecteurs.
