> ## 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.

# Connect your app to Semrush

> Connect your app to Semrush, an SEO and competitive analysis platform, to power apps with keyword research, domain analytics, backlink data, and project management.

export const connector_0 = "Semrush"

<Note>
  The Semrush connector is for embedding Semrush data **inside your deployed Lovable app**.

  If you just want [Semrush-powered SEO research](/features/seo-aeo#research-seo-with-lovable) 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](/features/seo-aeo).
</Note>

[Semrush](https://www.semrush.com/) 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](https://developer.semrush.com/api/).

## 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.**<br />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.**<br />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.**<br />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.**<br />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.**<br />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.**<br />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.**<br />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

<Tip>
  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](https://www.semrush.com/).
</Tip>

<Note>
  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.
</Note>

### Set up your Semrush connection

<Steps>
  <Step title="Open Semrush in Connectors">
    Go to **Connectors → App connectors** and select **Semrush**.
  </Step>

  <Step title="Add a connection">
    Click **Add connection**.
  </Step>

  <Step title="Name the connection">
    In **Display name**, name the connection (for example, `Semrush Prod`). This name is only used inside Lovable to identify the connection.
  </Step>

  <Step title="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              |
  </Step>

  <Step title="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 [Who can manage connections](/integrations/introduction#who-can-manage-connections) for more information.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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.

## How to unlink projects from a {connector_0} 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:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to manage.
  </Step>

  <Step title="Select projects">
    Under **Linked projects**, check the projects you want to unlink.
  </Step>

  <Step title="Confirm">
    Click **Unlink projects** and confirm.
  </Step>
</Steps>

When unlinked, those projects will no longer have access to {connector_0} through this connection. If a project needs {connector_0} again, you can link it to any available connection.

## How to delete a {connector_0} connection

Workspace admins and owners can delete {connector_0} connections. Other members can delete a connection if they created it, or if they have been explicitly granted access to it.

<Warning>
  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.
</Warning>

Before deleting, review the **Linked projects** section to see which projects are currently using the connection.

To delete a connection:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to remove.
  </Step>

  <Step title="Review linked projects">
    Review the **Linked projects** section.
  </Step>

  <Step title="Delete">
    Under **Delete this connection**, click **Delete** and confirm.
  </Step>
</Steps>