In this article, you will find possible solutions to the errors that showed up for you while you tried to work with the WordPress plugin.

Click on a specific error name to be transferred to the troubleshooting steps:

Error code: 301

The URL to your page is redirecting to another URL and REST API is not able to work with the redirection.

When our script is trying to reach your page it is redirected to another page. Sometimes redirection is simple and is pointing to a page with the same URL but with an additional trailing slash. The issue is that script can't be redirected, it needs to point to the exact URL.

You need to reconnect with Surfer using the correct page URL without additional redirection. If you are using redirection to add a trailing slash, you need to set an exception for Surfer User Agent. The best solution is to ask the person who set this redirection for you or your hosting provider support for help. Our user-agent to set an exception for is: “SurferSEO WP Plugin.”

Error code: 401

Surfer was not able to authenticate.

Please, also make sure that you have the freshest version of the plugin installed. You can go to the “Plugins” tab of your WP account, find SurferSEO, and check if there is any update available. You can also remove and install the plugin once again.

Another option is that some plugin is making conflict with our plugin. To check this, disable all plugins, and check if this helped. If yes, activate plugins one by one, to check which one is making a conflict.
If this plugin is a security plugin, you can try to check its configuration because it may have a special option to disable REST API (a very popular security plugin WordFence has such option). If you were able to find it, you can disable it and use both plugins without an issue, if not, you can try to reach plugin support, and ask if they have such option.

The last possible reason is that your server configuration is blocking Surfer. It can be their firewall, config, or country filters. Please, reach out to your hosting provider support, describe the issue, and ask to whitelist Surfer User Agent: “SurferSEO WP Plugin.”

Error code: 403

This error means, that access to your page is forbidden, and requires additional authentication to reach it.

The most common case is that your page is password protected. Surfer is not able to bypass this. The simplest solution here is to disable additional authentication. If you can’t or do not want to do this, you can try to change the configuration in wp-admin → Settings → General, and change your WordPress Address (URL) to: https://page_login:[email protected] Then, try to reconnect to Surfer. This should allow Surfer to bypass this protection (but this cannot be guaranteed in some cases).

The second option is to whitelist the Surfer user-agent from protection, but the way to set it depends on how you set your password (it could be not possible at all). To check and set a whitelist, you need to reach the person who set protection for you or your hosting provider support.

If you do not have any password protection, but still see the issue, the most common case is when security WordPress plugins are disabling REST API – we have confirmed cases with WordFence. You can quickly check if this is the issue, by disabling any security or redirection plugins you have. If this will help, you should be able to disable this REST API protection from plugin settings to be able to use the plugin with ours. If you are not able to find it, you can reach plugin support, or our support, maybe we already solve this conflict.

Error code: 404

Surfer was not able to find the final endpoint, that it should reach to perform the task.

The first thing to check is if you have the latest version of the plugin installed. You can go to the “Plugins” tab of your WP account, find SurferSEO, and check if there is any update available.
If you do not have the latest version, please install it, and reconnect your Surfer account. If you already have the latest version, you can try to reconnect to Surfer anyway.

The second option is that your page didn’t rebuild the permalink structure. You can go to wp-admin → Settings → Permalinks, and click “save” without making any changes.

Another option is that your caching plugin stores the old routes list. You can try clearing the cache for the plugin you are using if you are using any.

The next possible issue is some conflict with other plugins. Plugins works with hooks, and badly made plugin, may prevent our plugin from registering endpoints.
To check this, temporarily disable all plugins you have, and check if this helped. If yes, please activate the plugins one by one, to check which plugin is causing a conflict, and please inform us about that plugin, to allow us to find a permanent solution for this. Although it's less common, some conflicts may be created by theme files.
To check this, simply change the theme temporarily and check if this solved the issue. If all of this fail, you can reach your hosting support and ask them why your REST API URL returns error 404, as they may have this information, or at least they should have some diagnostic tools to provide you with some help.

Code execution timeout

Script execution time on your server was exceeded. It can be a temporary issue.

The simplest solution here is to just try again. If this is happening to you very often, you should be able to increase script execution time on your server. Please do not set this to unlimited, as this will break your page, but you can set time to, for example, 60 seconds. This should fix the issue for you. You can change the execution time in your hosting settings. If you are not sure how, please ask your hosting provider support.

SSL certificate issue

This error means, that your SSL certificate is wrong. Our plugin checks the certificate so in case something is not working properly, you won’t be able to use the plugin.

This could happen for a variety of reasons. The certificate could be expired, or it was generated on your staging page, and now you have a different domain. The best solution here is to generate a new certificate for your page. Please reach your hosting provider support, they should be able to help you with that.

Unknown error

This error can mean that you have maintenance mode active or you are trying to connect using an old token.

In the maintenance mode, REST API is not active, and we can’t reach your page endpoint. You need to either disable maintenance mode or set an exception for Surfer (not all maintenance plugins have this option).
If you do not have such option enabled, we didn’t encounter a similar error in the past and do not have a ready solution for you. In this case, please contact our Support Team, please provide your page URL, and timestamp of the issue, so check what is wrong.

When it comes to using an old token, please, make sure that you have the freshest version of the plugin installed. You can go to the “Plugins” tab of your WP account, find SurferSEO, and check if there is any update available. You can also remove and install the plugin once again.

Did this answer your question?