Troubleshooting
Fixing API Key Errors During an Audit
Auditing your own site should be free, so an error should never cost you an afternoon. Here is what each failure means and the shortest route past it.
Step by step
- 1
Read the status code first
401 is authentication, 402 is billing, 429 is rate limiting, and a network failure with no code is almost always CORS or a blocked request.
- 2
401 unauthorized
The key is wrong, revoked, or pasted with hidden whitespace. Recreate it at the provider and paste it again in the settings drawer.
- 3
429 too many requests
You are inside a free tier window limit. Wait sixty seconds, or add a second provider key so GetSEO fails over mid run.
- 4
Quota or credit exhausted
Not a rate limit. The account has no balance left. Add credit, switch to a free tier model, or use a different provider key.
- 5
Failed to fetch with no status
The browser blocked the call. With Ollama this means OLLAMA_ORIGINS is unset; with a proxy it means the endpoint does not return permissive CORS headers.
- 6
Model not found
Model IDs get retired. Pick a current model in the settings drawer, and on OpenRouter include the vendor prefix.
Open the settings drawer from the top bar, add the key, and it is saved in your browser only. You can add several keys and GetSEO will fail over between them automatically.
Worth knowing
- Keeping two keys from different providers in the pool removes most interruptions entirely.
- Auditing here is free by design. If a provider is charging you unexpectedly, check which model your key is set to.
- Errors are shown with the provider's own message so you can act on it instead of guessing.
Troubleshooting
| Problem | Fix |
|---|---|
| Everything fails immediately after saving a key | The provider selection does not match the key type. A Groq key with the OpenAI provider selected always returns 401. |
| Works once then fails | Free tier per-minute limits. Space out runs or add failover keys. |
| Report generated but truncated | The model ran out of context. Choose a longer context model. |
Key ready? Run your free audit.
Paste your URL and get a scored report across SEO, conversion, content, accessibility, mobile and trust, with the fixes written for you.
Run a free audit