Semrush is available as an app + chat connector: one shared connection that works in the project chat while you build and in your published apps.
Semrush is an SEO, keyword research, and competitive analysis platform that lets your RShift Sites app work with search data, domain analytics, and marketing insights managed in your Semrush account. It’s designed for apps that surface SEO data, track keyword positions, or build dashboards on top of Semrush projects.
With Semrush, your app can:
- Access SEO data including keywords, backlinks, and domain analytics
- Manage Semrush projects and position tracking campaigns
- Retrieve organic and paid search insights
The Semrush connector targets Semrush’s OAuth-protected APIs, including the Projects API, URL, domain, backlinks, and subfolder reports, and position tracking. It’s a good fit when your app needs to read SEO data from your Semrush account or extend Semrush workflows with custom interfaces.
See Semrush’s developer documentation for API availability and limits: Semrush API docs.
Common use cases and example apps
| Example app | Example prompt | Description |
|---|---|---|
| SEO performance dashboard | Use Semrush and build a dashboard that shows my domain’s organic traffic, keyword rankings, and backlink growth over time. | Surface Semrush SEO metrics in a focused internal view. The app pulls domain analytics and keyword data from Semrush projects and renders charts so marketing teams can monitor performance without opening Semrush. |
| Keyword research workspace | Use Semrush and build a keyword research tool where I can search keywords, see volume and difficulty, and save lists. | Create a structured workflow on top of Semrush keyword data. The app queries Semrush for keyword metrics, lets users organize results into lists, and saves selections for later review. |
| Competitor tracking app | Use Semrush and build an app that tracks competitor domains and shows their top keywords, traffic estimates, and backlinks. | Turn Semrush competitive data into a monitoring tool. The app fetches data for a configured set of competitor domains and highlights changes in rankings, traffic, and backlink profiles over time. |
| Position tracking reports | Use Semrush and build a weekly report that summarizes keyword position changes across my Semrush projects. | Deliver recurring SEO updates from Semrush project data. The app reads position tracking campaigns, compares week-over-week movement, and produces a digest stakeholders can review at a glance. |
| Backlink monitoring | Use Semrush and build an app that lists new and lost backlinks for my domain and flags high-authority links. | Monitor link profile changes from Semrush. The app fetches backlink data, surfaces gains and losses, and highlights links worth investigating based on domain authority. |
| Client-facing SEO reports | Use Semrush and build a client portal that shows each client their keyword rankings, traffic trends, and project status. | Share Semrush insights with clients in a branded interface. The app maps Semrush projects to clients, renders the relevant metrics, and gives clients a read-only view of their SEO performance. |
| Content opportunity finder | Use Semrush and build a tool that surfaces keyword opportunities based on search volume, difficulty, and current rankings. | Help content teams prioritize what to write next. The app combines Semrush keyword and ranking data to identify gaps and recommend topics with the best potential return. |
How to connect Semrush
Workspace admins and owners can set up Semrush conenctions. You can create multiple Semrush connections by authorizing different Semrush accounts.
When the connection is created, Semrush becomes available across all projects in the workspace. Anyone building in a project can ask RShift Sites in the project chat to link their project to it.
Prerequisites
Before connecting Semrush, make sure you have:
- A Semrush account
- RShift Sites workspace owner or admin role
Set up your Semrush connection
Open Semrush in Connectors
Go to Connectors and select Semrush.
Add a connection
Click Add connection.
Name the connection
In Display name, name the connection (for example, Semrush Prod). This name is only used inside RShift Sites to identify the connection.
View scopes (optional)
Expand Advanced settings to view the Semrush API scopes RShift Sites will request. All scopes are required for the gateway to reach every supported endpoint and cannot be deselected:
| Scope | Semrush permission | What RShift Sites reads |
|---|---|---|
| User identity | user.id |
The connected Semrush user’s identity |
| User limits | user.limits |
The connected user’s Semrush API quota |
| URL reports | url.info |
URL-level organic and paid search data |
| Domain reports | domains.info |
Domain-level rankings, traffic, and competitive data |
| Backlinks | backlinks.info |
Backlink profiles, anchors, and referring domains |
| Subfolder reports | subfolders.info |
Organic data for subfolders of a domain |
| Projects | projects.info |
The connected user’s Semrush projects |
| Position tracking | positiontracking.info |
Position tracking campaigns and reports |
Choose who can use this connection
Under Sharing, the connection is private to you by default and shows a Private label. To share it, click Share with others. Then add workspace members by email, or click Invite entire workspace to make the connection available to everyone in your RShift Sites workspace.
See Who can use connections and clients for more information.
Connect to Semrush and authorize
Click Connect. The Semrush authorization window opens, so make sure your browser doesn’t block pop-ups. If it does, RShift Sites redirects you instead.
Sign in to Semrush if prompted, review the requested permissions, and click Allow.
You’ll be redirected back to RShift Sites with a confirmation.
When connected, anyone building in a project can ask RShift Sites in the project chat to link their project to Semrush. Your RShift Sites apps can then start using Semrush to read SEO data, manage projects, and build dashboards on top of your Semrush account.
Limitations
The Semrush connector cannot:
- Call legacy Semrush endpoints that require API-key (
?key=…) query-string authentication - Receive Semrush webhooks or event notifications
- Support per-end-user authentication (each connection uses a single shared Semrush authorization)
- Bypass Semrush API quotas or rate limits. Usage counts against your Semrush plan.
Manage your {connector_0} connection
Connections are managed from Connectors: select {connector_0}, then open the connection.
- Unlink projects to remove {connector_0} access from specific projects while keeping the connection available for others. See Unlink projects from a connection for the steps.
- Delete the connection to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use {connector_0} stop working until a new connection is added. See Delete a connection for the steps and who can delete.