Skip to main content

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.
Semrush is an SEO, keyword research, and competitive analysis platform that lets your Lovable 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 appExample promptDescription
SEO performance dashboardUse 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 workspaceUse 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 appUse 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 reportsUse 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 monitoringUse 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 reportsUse 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 finderUse 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
When you connect Semrush through Lovable, you can either use an existing Semrush account or create a new one during the connection flow.
  • If you create a new Semrush account through Lovable, you’ll get free Semrush credits on Semrush’s free plan, subject to free plan limits and daily usage caps.
  • If you connect an existing Semrush account instead, your current Semrush subscription limits apply.
Learn more at semrush.com.
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

1

Open Semrush in Connectors

Go to Connectors → App connectors and select Semrush.
2

Add a connection

Click Add connection.
3

Name the connection

In Display name, name the connection (for example, Semrush Prod). This name is only used inside Lovable to identify the connection.
4

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:
ScopeSemrush permissionWhat Lovable reads
User identityuser.idThe connected Semrush user’s identity
User limitsuser.limitsThe connected user’s Semrush API quota
URL reportsurl.infoURL-level organic and paid search data
Domain reportsdomains.infoDomain-level rankings, traffic, and competitive data
Backlinksbacklinks.infoBacklink profiles, anchors, and referring domains
Subfolder reportssubfolders.infoOrganic data for subfolders of a domain
Projectsprojects.infoThe connected user’s Semrush projects
Position trackingpositiontracking.infoPosition tracking campaigns and reports
5

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.
See Connection-level access for more information.
6

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.
When connected, anyone building in a project can ask Lovable in chat to link their project to Semrush. Your Lovable 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.
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:
1

Open Connectors

Open Connectors, then go to App connectors, and select .
2

Open the connection

Open the connection you want to manage.
3

Select projects

Under Linked projects, check the projects you want to unlink.
4

Confirm

Click Unlink projects and confirm.
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.

How to delete a connection

Workspace admins and owners can delete connections.
Deleting a connection is permanent and cannot be undone. It will remove the credentials from all linked projects, and any apps using this connection will stop working until a new connection is added.
Before deleting, review the Linked projects section to see which projects are currently using the connection. To delete a connection:
1

Open Connectors

Open Connectors, then go to App connectors, and select .
2

Open the connection

Open the connection you want to remove.
3

Review linked projects

Review the Linked projects section.
4

Delete

Under Delete this connection, click Delete and confirm.