Documentation Index
Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt
Use this file to discover all available pages before exploring further.
The Semrush connector is for embedding Semrush data inside your deployed Lovable app.If you just want Semrush-powered SEO research while building (keyword ideas, domain analysis, competitive insights for the agent to reason over), you don’t need this connector. See Optimize your app for SEO and AI search.
- Access SEO data including keywords, backlinks, and domain analytics
- Manage Semrush projects and position tracking campaigns
- Retrieve organic and paid search insights
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 Lovable in chat to link their project to it.Prerequisites
Before connecting Semrush, make sure you have:- A Semrush account
- Lovable workspace owner or admin role
All API requests made through this connector consume Semrush API units according to your Semrush plan. Billing and quota are handled directly by Semrush, not Lovable.
Set up your Semrush connection
Name the connection
In Display name, name the connection (for example,
Semrush Prod). This name is only used inside Lovable to identify the connection.View scopes (optional)
Expand Advanced settings to view the Semrush API scopes Lovable will request. All scopes are required for the gateway to reach every supported endpoint and cannot be deselected:
| Scope | Semrush permission | What Lovable 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 access this connection
Under Who can access this connection, decide who in your workspace can use the connection:
- Only you (default): only the person creating the connection can use it and its associated data.
- Invite specific people: only you and explicitly added workspace members can use the connection and its associated data.
- Invite entire workspace: click Invite entire workspace to make the connection available to everyone in your Lovable workspace.
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, Lovable redirects you instead.Sign in to Semrush if prompted, review the requested permissions, and click Allow.You’ll be redirected back to Lovable with a confirmation.
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.
How to unlink projects from a connection
Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects. To unlink projects:
When unlinked, those projects will no longer have access to through this connection. If a project needs again, you can link it to any available connection.