OnlyAI SEO

Documentation

Setup guide

Install the plugin, connect it to OnlyAI Cloud and check that everything works.

1. Install the plugin

Download onlyai-seo.zip from the home page. In WordPress go to Plugins, Add New, Upload Plugin, choose the file, install and activate. You can also unzip it into wp-content/plugins/ yourself.

2. Connect OnlyAI Cloud

Open OnlyAI SEO, Settings. In the OnlyAI Cloud card paste the hub_... key from Dashboard, API keys and press Connect. The plugin checks the key straight away and shows your plan and how many requests are left today.

The plugin talks to https://onlyaiseo.com/wp-json/onlyai-hub/v1. There is nothing else to configure.

Moving from another SEO plugin?

Open OnlyAI SEO, Settings, Import, pick Yoast SEO, Rank Math, All in One SEO or SEOPress and press Preview. It lists what would be imported and writes nothing. Press Import when it looks right, then deactivate the old plugin.

Big sites: the command line

With WP-CLI: wp onlyai-seo import yoast --dry-run (then without --dry-run), wp onlyai-seo score, wp onlyai-seo redirects import|export|copy and wp onlyai-seo settings export|import. Settings also has a "Getting set up" checklist.

3. Test the key from a terminal

You can check a key without touching WordPress:

curl -H "Authorization: Bearer hub_YOUR_KEY" \
  https://onlyaiseo.com/wp-json/onlyai-hub/v1/ping
# {"ok":true,"version":"1.0.0"}

To see whether the service itself is up, open onlyaiseo.com/api/health. It answers with yes or no for each part and never shows secrets.

4. If something fails

  • 401, missing or invalid key. The key is wrong, was revoked, or was copied with a space. Make a new one in the dashboard.
  • 429, daily limit reached. Your account may make as many requests in any 24 hours as your plan allows, counted across all of its keys and sites. Wait for older requests to age out or upgrade in Dashboard, Billing.
  • 502, the AI engine failed or timed out. Try again in a moment. Requests that fail are not counted.
  • 503, OnlyAI Cloud is not available. The service is not fully set up or is restarting. Try again later; if it lasts, email [email protected].