You can navigate through the issues by clicking on one on the list below:
1. Error code: 301
Summary: 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.
2. Error code: 401
Summary: Surfer was not able to authenticate.
First, please make sure that you have the most up-to-date 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 possibility is that one of your other plugins is in conflict with our plugin. To check this, disable all of your plugins temporarily, and check if this helped. If yes, activate your plugins back, one by one, to check which one was causing the conflict. We'd appreciate any feedback about other plugins interfering with ours. You can reach us at [email protected] or via our live chat.
If the plugin is a security plugin, please check its configuration. It may have a special option to disable REST API protection which may be enabled by default (just as with a very popular security plugin WordFence).
If you were able to find this option, 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 an 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.”
Our user-agent to set an exception for is SurferSEO WP Plugin.
3. Error code: 403
Summary: Access to your page is most likely 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 actually set your password (in some instances, it can not be 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 this error appears, 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. This will help isolate the issue. If the issue is no longer present, try to disable the 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 out to your plugin support or to our Support team for assistance.
4. Error code: 404
Summary: Surfer was not able to find the final endpoint that it should reach to perform the task.
First, please make sure that you have the most up-to-date 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 there is an update, make sure to install it and reconnect your Surfer account. You can also remove the plugin, install it once again, and then reconnect your Surfer account.
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. Try clearing the cache for the plugin caching plugin you are using.
The next possible issue is a conflict with other plugins. Plugins work with hooks and badly made plugins 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 which plugin was causing the interference. You can reach us at [email protected] or via our live chat.
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 fails, 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.
5. Code execution timeout
Summary: Script execution time on your server was exceeded. It can be a temporary issue.
The most simple solution here is just to try again. If this is happening to you very often, you should try to increase the 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. That should be enough to 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 for support.
6. SSL certificate issue
Summary: Your SSL certificate is most likely 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.
7. Unknown error
Summary: 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 your plugin does not allow you to set an exception, we do not have other alternative solutions at this time. In this case, please contact our Support Team, and provide your page URL and the timestamp of the issue so we can 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.
8. Other issues
If you are facing any other issues that were not listed above, we recommend first getting familiar with the information below. If you still need help, we advise reaching out to our Support team.
The plugin supports two basic WordPress editors/builders: Gutenberg and Classic Editor. If you are using a different editor, the plugin will not work at this time.
For now, by default, you can use the plugin only to export content to your WordPress posts. However, with more advanced programming knowledge, you can also use our Filter method to be able to update not only posts but also pages.
For now, you can only choose from the WP posts that were published no longer than 30 days ago. As a workaround, you can choose the publication date of the WP post you want to update to anything within the last 30 days, update that WP post using the plugin, and then change the publication date back to the previous one.
Do you still need help? Don't worry! You can contact us at [email protected] or via live chat by clicking the icon in the bottom-right corner.