Si gestionas el SEO de WordPress como parte de un flujo de trabajo de desarrollo, probablemente has deseado en algún momento poder omitir el administrador y simplemente hacer una llamada a la API. A partir de la versión 4.9.8, puedes.
La API REST de AIOSEO ahora es gratuita para todos los planes, incluido Lite.
La API REST ahora tiene 2 usos distintos desde su versión original en 4.1.9. El primero es el que probablemente ya conoces: agrega campos de metadatos SEO a los puntos finales de WordPress para que los desarrolladores que crean sitios sin cabeza puedan extraer etiquetas de título, meta descripciones y esquemas directamente en su frontend.
El segundo es nuevo en la versión 4.9.8. Expone la capa de Habilidades en WordPress: 28 acciones SEO
que los usuarios de AIOSEO MCP y WP-CLI ya tienen, ahora se pueden llamar a través de HTTP desde cualquier idioma o pila. Cualquier solicitud HTTP autenticada ahora puede hacer lo que hace un agente de IA.
Hasta ahora, estas funciones requerían un plan Plus (o superior) y una instalación de complemento separada. A partir de esta versión, ninguna de las dos lo hace. El complemento está obsoleto y se ha fusionado en el núcleo, por lo que si ya has actualizado, está ahí.
Esto es lo que la nueva API REST de AIOSEO realmente te permite hacer.
En este artículo
Lo que puedes hacer a través de la API REST
En la práctica, las nuevas habilidades de AIOSEO te permiten hacer cosas como:
- Encuentra todas las publicaciones de tu sitio que carecen de una meta descripción y devuélvelas como una lista
- Actualiza títulos SEO y meta descripciones en bloque en una categoría o tipo de contenido
- Crea, actualiza o elimina redirecciones sin tocar el administrador de WordPress
- Obtén puntuaciones TruSEO para cualquier publicación para monitorear la salud SEO en un panel personalizado
- Recupera datos de rendimiento de la Consola de Búsqueda por publicación o período de tiempo
- Comprueba qué publicaciones están marcadas como huérfanas o carecen de enlaces internos
Y no estás limitado a leer datos. Cualquier script o herramienta que se conecte usando tus credenciales puede hacer cambios, de la misma manera que lo hace un agente de IA a través de AIOSEO MCP.
¿No escribes scripts tú mismo? AIOSEO MCP conecta herramientas de IA como Claude, Cursor y ChatGPT directamente a tu sitio. Las mismas habilidades, sin necesidad de código.
Nota: Algunas habilidades están vinculadas a funciones específicas de AIOSEO y requieren el plan que las incluye. Las habilidades de Link Assistant requieren Pro o superior, y las habilidades de Search Statistics requieren Elite.
El caso de uso original de WordPress sin cabeza todavía funciona
Si estás creando un sitio de WordPress sin cabeza, donde WordPress maneja el contenido y un frontend separado construido en Next.js, Gatsby o Astro maneja la visualización, AIOSEO ha admitido esto desde la versión 4.1.9. Nada sobre la configuración cambia en la versión 4.9.8. Cada punto final compatible devuelve 3 campos SEO adicionales cuando AIOSEO está activo:
aioseo_heades la salida SEO completa para el<head>de tu página: etiquetas de título, meta descripciones, URLs canónicas, datos de Open Graph y esquema JSON-LD, listo para usar como una cadena HTML.aioseo_head_jsondevuelve la misma información en formato JSON, sin el marcado HTML.aioseo_meta_datate proporciona los campos SEO sin procesar almacenados en la base de datos de AIOSEO. Puedes leerlos y actualizarlos a través de la API.
Lo único que ha cambiado es que estos campos ya no están restringidos por un plan de pago.
Qué cambió en la versión 4.9.8
Antes de esta versión, el acceso a los campos de metadatos headless o a las funcionalidades requería un plan Plus (o superior) y una instalación de complemento separada desde el gestor de funciones. Ambos han desaparecido.
Al actualizar a la versión 4.9.8, todo estará disponible automáticamente. Sin complementos que activar, sin planes requeridos.
Si tenías el complemento instalado anteriormente y ya no aparece en el gestor de funciones, es lo esperado. La funcionalidad ya está ahí, integrada en el plugin principal.
Primeros pasos
La configuración se reduce a una cosa: una Contraseña de aplicación de WordPress. Esta no es tu contraseña de inicio de sesión, sino una credencial separada que generas desde tu administrador de WordPress. Puedes crear una navegando a Usuarios >> Perfil >> Contraseñas de aplicación. Puedes revocarla en cualquier momento y es específica para cualquier herramienta o script que estés conectando.
Aquí tienes un ejemplo básico para obtener datos SEO de una publicación:
Nota: Estos ejemplos utilizan btoa() de JavaScript para la codificación Base64, que funciona en navegadores y Node.js 16+. En versiones anteriores de Node.js, reemplaza btoa('user:pass') conBuffer.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 JSONPara actualizar los campos SEO de una publicación:
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',
},
}),
});La API funciona con todos los puntos de conexión estándar de WordPress: /wp/v2/posts, /wp/v2/pages,
/wp/v2/media, /wp/v2/categories, /wp/v2/tags, y cualquier tipo de publicación personalizada con
soporte de API REST habilitado.
Para la referencia completa de funcionalidades y la documentación de puntos de conexión, consulta la documentación para desarrolladores de la API REST de AIOSEO.
Si alguna vez deseas revocar una contraseña de aplicación, puedes hacerlo desde la misma pantalla en tu administrador de WordPress donde la creaste.
Gratis para todos los planes, incluido Lite
A partir de la versión 4.9.8, la API REST de AIOSEO es gratuita para todos los planes de AIOSEO, incluido Lite.
Si gestionas el SEO a gran escala y deseas más de la API, vale la pena explorar Link Assistant (Pro) y Search Statistics (Elite). Añaden algunas de las funcionalidades más útiles de la lista. Puedes comparar planes aquí: Precios de AIOSEO.
La versión 4.9.8 también incluye otras 2 actualizaciones:
- AIOSEO MCP: Conecta clientes de IA como Claude, Cursor y ChatGPT directamente a tu SEO de WordPress.
- Nuevos modelos de generación de imágenes IA en el Generador de Imágenes IA.
La API REST ha sido una de las herramientas más útiles en AIOSEO para desarrolladores. Hacerla disponible para todos los planes significa que más personas pueden crear flujos de trabajo SEO más inteligentes y automatizados, y creo que es la decisión correcta.
¡Actualiza a la versión 4.9.8 y empieza a crear!
— Ben Rojas, Presidente de AIOSEO
Preguntas frecuentes
¿Qué puedo hacer con la API REST de AIOSEO?
A partir de la versi ilde{0}n 4.9.8, la API REST te da acceso a las 28 funcionalidades de AIOSEO, las mismas disponibles a trav ilde{e}s de MCP. Puedes actualizar meta descripciones y t ilde{i}tulos SEO, gestionar redirecciones, obtener puntuaciones TruSEO, recuperar datos de la Consola de B ilde{0}squeda y m ilde{a}s, todo mediante peticiones HTTP. Tambi ilde{e}n soporta el caso de uso original de WordPress headless: obtener la salida completa del encabezado SEO para frontends desacoplados.
" extiquest;Necesito un plan de pago de AIOSEO para usar la API REST?
No. A partir de la versi ilde{0}n 4.9.8, la API REST es gratuita para todos los planes de AIOSEO, incluido Lite. Algunas funcionalidades est ilde{a}n ligadas a caracter ilde{i}sticas espec ilde{i}ficas de AIOSEO, y esas requieren el plan que incluye dicha caracter ilde{i}stica, igual que si las usaras por cualquier otro m ilde{e}todo.
El complemento de la API REST ya no est ilde{a} en mi gestor de funcionalidades. extiquest; ext{Hay algo mal?
No. Es lo esperado. El complemento ha sido obsoleto y fusionado en el plugin principal. La API REST est ilde{a} disponible autom ilde{a}ticamente despu ilde{e}s de actualizar a la versi ilde{0}n 4.9.8. No se necesita reinstalaci ilde{0}n.
extiquest;Qu ilde{e} endpoints de WordPress soporta la API REST de AIOSEO?
Todos los endpoints est ilde{a}ndar de la API REST de WordPress: /wp/v2/posts, /wp/v2/pages, /wp/v2/media, /wp/v2/categories, /wp/v2/tags, y cualquier tipo de post personalizado con la API REST habilitada.
extiquest;Cu ilde{a}l es la diferencia entre AIOSEO MCP y la API REST?
Tanto MCP como la API REST exponen las mismas 28 funcionalidades de AIOSEO. La diferencia es qui ilde{e}n las usa. MCP es para agentes de IA: permite que herramientas como Claude, Cursor y ChatGPT act ilde{u}en en tu sitio a trav ilde{e}s del chat. La API REST es para desarrolladores: te permite llamar a esas mismas funcionalidades desde scripts, automatizaciones e integraciones personalizadas v ilde{i}a HTTP. Usa MCP cuando quieras que tu IA gestione tareas SEO. Usa la API REST cuando quieras construir algo program ilde{a}tico t ilde{u} mismo.
extiquest;C ilde{o}mo me autentico con la API REST de AIOSEO?
Usa una contrase exttext{ntilde}a de aplicaci exttext{oacute}n de WordPress. Genera una en tu administrador de WordPress en Usuarios extrightarrow Perfil extrightarrow Contrase exttext{ntilde}as de aplicaci exttext{oacute}n, luego incl exttext{uacute}yela en tus peticiones. Los ejemplos de c exttext{oacute}digo en la secci exttext{oacute}n de Inicio r exttext{aacute}pido muestran exactamente c exttext{oacute}mo formatearla.
Descargo de responsabilidad: Nuestro contenido es compatible con los lectores. Esto significa que si haces clic en algunos de nuestros enlaces, podemos ganar una comisión. Solo recomendamos productos que creemos que añadirán valor a nuestros lectores.
