Se você gerencia o SEO do WordPress como parte de um fluxo de trabalho de desenvolvimento, provavelmente já desejou poder pular o admin e apenas fazer uma chamada de API. A partir da versão 4.9.8, você pode.
A API REST do AIOSEO agora é gratuita para todos os planos, incluindo o Lite.
A API REST agora tem 2 usos distintos desde sua versão original em 4.1.9. O primeiro é o que você provavelmente já conhece: adiciona campos de metadados de SEO aos endpoints do WordPress para que os desenvolvedores que criam sites headless possam extrair tags de título, meta descrições e schema diretamente para seu frontend.
O segundo é novo na versão 4.9.8. Ele expõe a camada de Habilidades no WordPress: 28 ações de SEO
que os usuários do AIOSEO MCP e WP-CLI já possuem, agora podem ser chamadas via HTTP de qualquer linguagem ou stack. Qualquer solicitação HTTP autenticada agora pode fazer o que um agente de IA faz.
Até agora, esses recursos exigiam um plano Plus (ou superior) e a instalação de um addon separado. A partir desta versão, nenhum dos dois é necessário. O addon foi descontinuado e mesclado ao núcleo, portanto, se você já atualizou, ele está lá.
Veja o que a nova API REST do AIOSEO realmente permite que você faça.
Neste Artigo
O Que Você Pode Fazer Via API REST
Na prática, as novas habilidades do AIOSEO permitem que você faça coisas como:
- Encontrar todas as postagens em seu site que não possuem uma meta descrição e retorná-las como uma lista
- Atualizar títulos de SEO e meta descrições em massa em uma categoria ou tipo de conteúdo
- Criar, atualizar ou excluir redirecionamentos sem tocar no admin do WordPress
- Extrair pontuações TruSEO para qualquer postagem para monitorar a saúde do SEO em um painel personalizado
- Recuperar dados de desempenho do Search Console por postagem ou período
- Verificar quais postagens estão marcadas como órfãs ou sem links internos
E você não está limitado a ler dados. Qualquer script ou ferramenta que se conecta usando suas credenciais pode fazer alterações, da mesma forma que um agente de IA faz através do AIOSEO MCP.
Não está escrevendo scripts? AIOSEO MCP conecta ferramentas de IA como Claude, Cursor e ChatGPT diretamente ao seu site. Mesmas habilidades, sem necessidade de código.
Observação: Algumas habilidades estão vinculadas a recursos específicos do AIOSEO e exigem o plano que os inclui. As habilidades do Link Assistant exigem o plano Pro ou superior, e as habilidades do Search Statistics exigem o plano Elite.
O Caso de Uso Original do WordPress Headless Ainda Funciona
Se você está construindo um site WordPress headless, onde o WordPress lida com o conteúdo e um frontend separado construído em Next.js, Gatsby ou Astro lida com a exibição, o AIOSEO suporta isso desde a versão 4.1.9. Nada sobre a configuração muda na versão 4.9.8. Cada endpoint suportado retorna 3 campos de SEO adicionais quando o AIOSEO está ativo:
aioseo_headé a saída completa de SEO para o<head>da sua página: tags de título, meta descrições, URLs canônicas, dados Open Graph e schema JSON-LD, prontos para serem inseridos como uma string HTML.aioseo_head_jsonretorna as mesmas informações em formato JSON, sem a marcação HTML.aioseo_meta_datafornece os campos brutos de SEO armazenados no banco de dados do AIOSEO. Você pode lê-los e atualizá-los através da API.
A única coisa que mudou é que esses campos não estão mais restritos a um plano pago.
O Que Mudou na Versão 4.9.8
Antes desta versão, o acesso aos campos de metadados headless ou às funcionalidades exigia um plano Plus (ou superior) e uma instalação separada do addon no gerenciador de recursos. Ambos foram removidos.
Ao atualizar para a versão 4.9.8, tudo estará disponível automaticamente. Nenhum addon para ativar, nenhum plano necessário.
Se você tinha o addon instalado antes e ele não aparece mais no gerenciador de recursos, isso é esperado. A funcionalidade já está lá, integrada ao plugin principal.
Primeiros Passos
A configuração se resume a uma coisa: uma Senha de Aplicativo do WordPress. Esta não é sua senha de login, mas sim uma credencial separada que você gera a partir do seu admin do WordPress. Você pode criar uma navegando para Usuários >> Perfil >> Senhas de Aplicativo. Você pode revogá-la a qualquer momento, e ela é específica para qualquer ferramenta ou script que você esteja conectando.
Aqui está um exemplo básico para buscar dados de SEO para uma postagem:
Observação: Estes exemplos usam btoa() do JavaScript para codificação Base64, que funciona em navegadores e no Node.js 16+. Em versões mais antigas do Node.js, substitua btoa('user:pass') porBuffer.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 atualizar os campos de SEO em uma postagem:
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',
},
}),
});A API funciona com todos os endpoints padrão do WordPress: /wp/v2/posts, /wp/v2/pages,
/wp/v2/media, /wp/v2/categories, /wp/v2/tags, e qualquer tipo de postagem personalizada com
suporte à API REST habilitado.
Para a referência completa de funcionalidades e documentação de endpoints, consulte a documentação do desenvolvedor da API REST do AIOSEO.
Se você quiser revogar uma senha de aplicativo, pode fazer isso na mesma tela do seu admin do WordPress onde a criou.
Gratuito para Todos os Planos, Incluindo o Lite
A partir da versão 4.9.8, a API REST do AIOSEO é gratuita para todos os planos do AIOSEO, incluindo o Lite.
Se você gerencia SEO em escala e deseja mais da API, o Link Assistant (Pro) e o Search Statistics (Elite) valem a pena explorar. Eles adicionam algumas das funcionalidades mais úteis da lista. Você pode comparar os planos aqui: preços do AIOSEO.
A versão 4.9.8 também inclui outras 2 atualizações:
- AIOSEO MCP: Conecte clientes de IA como Claude, Cursor e ChatGPT diretamente ao seu SEO do WordPress.
- Novos modelos de geração de imagem por IA no Gerador de Imagens por IA.
A API REST tem sido uma das ferramentas mais úteis do AIOSEO para desenvolvedores. Torná-la disponível para todos os planos significa que mais pessoas podem criar fluxos de trabalho de SEO mais inteligentes e automatizados, e eu acho que é a decisão certa.
Atualize para a versão 4.9.8 e comece a construir!
— Ben Rojas, Presidente do AIOSEO
Perguntas Frequentes
O que posso fazer com a API REST do AIOSEO?
A partir da versão 4.9.8, a API REST oferece acesso a todas as 28 funcionalidades do AIOSEO — o mesmo conjunto disponível através do MCP. Você pode atualizar meta descrições e títulos de SEO, gerenciar redirecionamentos, obter pontuações TruSEO, recuperar dados do Search Console e muito mais, tudo via requisições HTTP. Ela também suporta o caso de uso original do WordPress headless: buscar a saída completa do cabeçalho de SEO para frontends desacoplados.
Preciso de um plano pago do AIOSEO para usar a API REST?
Não. A partir da versão 4.9.8, a API REST é gratuita para todos os planos do AIOSEO, incluindo o Lite. Algumas funcionalidades estão vinculadas a recursos específicos do AIOSEO e exigem o plano que inclui esse recurso, assim como ao usá-los por qualquer outro método.
O add-on da API REST não está mais no meu gerenciador de recursos. Algo está errado?
Não. Isso é esperado. O add-on foi descontinuado e mesclado ao plugin principal. A API REST está disponível automaticamente após a atualização para a versão 4.9.8. Nenhuma reinstalação é necessária.
Quais endpoints do WordPress a API REST do AIOSEO suporta?
Todos os endpoints padrão da API REST do WordPress: /wp/v2/posts, /wp/v2/pages, /wp/v2/media, /wp/v2/categories, /wp/v2/tags e quaisquer tipos de postagem personalizados com suporte à API REST habilitado.
Qual é a diferença entre o MCP do AIOSEO e a API REST?
Tanto o MCP quanto a API REST expõem as mesmas 28 funcionalidades do AIOSEO. A diferença é quem as usa. O MCP é para agentes de IA: ele permite que ferramentas como Claude, Cursor e ChatGPT ajam em seu site através de chat. A API REST é para desenvolvedores: ela permite que você chame essas mesmas funcionalidades de scripts, automações e integrações personalizadas via HTTP. Use o MCP quando quiser que sua IA lide com tarefas de SEO. Use a API REST quando quiser construir algo programaticamente por conta própria.
Como me autentico com a API REST do AIOSEO?
Use uma Senha de Aplicativo do WordPress. Gere uma em seu painel do WordPress em Usuários → Perfil → Senhas de Aplicativo, e inclua-a em suas requisições. Os exemplos de código na seção Primeiros Passos mostram exatamente como formatá-la.
Aviso: Nosso conteúdo é apoiado pelo leitor. Isso significa que se você clicar em alguns de nossos links, poderemos ganhar uma comissão. Recomendamos apenas produtos que acreditamos que agregarão valor aos nossos leitores.
