Semrush
Details an integration available for Semrush, built and maintained by Umbraco HQ.
Last updated
Was this helpful?
Details an integration available for Semrush, built and maintained by Umbraco HQ.
Last updated
Was this helpful?
This integration provides a keywords search tool powered by .
To ensure compatibility, check the Dependencies tab on NuGet for the required Umbraco CMS version. For example, see .
Once the package is installed, the integration is made available in the Umbraco backoffice as a Content App.
The Content App is available for all types of content items as well as for all user groups.
A keyword search can be initiated using a content field as a starting point, or by entering a custom phrase. The results can be filtered for different metrics across markets.
Administrators are provided with additional features for managing the connectivity with their organization's account with Semrush.
For more detail on the integration, its purpose, and how2 it was built, please see the .
The easiest way to configure the integration is to make use of an application Umbraco has pre-configured with Semrush. With this in place, the authorization flow will go through a proxy website Umbraco maintains before redirecting back to your Umbraco backoffice.
From version 1.2.0, we introduced an alternate approach that requires a little more setup. It removes the need for relying on any services from Umbraco when using the integration.
To use this you need to setup your own app with Semrush and use an extended configuration like this:
The authorization mode is toggled by the UseUmbracoAuthorization
flag, which by default is set to true
meaning that previous versions are not impacted.
The used service is provided using the AuthorizationImplementationFactory
method, depending on the type of authorization selected.
The authorization controller uses the window.postMessage
interface for cross-window communications when redirecting from the semrush authorization server.
Authorization specific methods are exposed by the and implemented by two services:
If you are selecting your own authorization flow that uses the AuthorizationService
, the redirect URL will be this one: /umbraco/api/semrushauthorization/oauth
, from . Please make sure to set to correct URL in the settings of the website and in the configuration of your Semrush app.