> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect

> How to connect the Semrush data source to Adriel: retrieve an API key, pick a report type, and set the target.

Semrush is an SEO and competitive-intelligence platform covering keyword research, organic and paid search visibility, backlink analysis, and site authority. Connecting it brings Semrush domain analytics, position tracking, and backlink surfaces into Adriel dashboards.

## Before you connect

The following are required:

* A Semrush account with API access. Most endpoints require a Business or Enterprise tier.
* A Semrush API key. Sign in to Semrush, open **Account / Profile** in the top-right corner, select the **Subscription info** tab, and copy the **API Key** from the **API Units** section.
* Sufficient remaining **API Units** on the Semrush subscription. Every report call consumes units billed to the account that owns the key.
* For position tracking, an existing Semrush project (campaign) with tracked keywords.
* A target domain and a Semrush regional database (for example `us`, `uk`, `de`, `mobile-us`, `il-ext`) for domain analytics. The database is the regional index that determines which SERP corpus the figures are computed against.

## Connect Semrush

<Steps>
  <Step title="Select the data source">
    On the **Data Sources** page, search for **Semrush** and select it.
  </Step>

  <Step title="Enter the API key and report type">
    Paste the **API Key** into the field, then choose a **Report type** from the drop-down list. Semrush exposes a large set of report types spanning traffic, backlinks, domain and keyword analytics, and overview reports. To connect multiple report types, repeat this flow once for each.
  </Step>

  <Step title="Configure the report fields">
    Fill in the required and optional fields shown for the selected report type. Common fields include **Name** (an identifiable name for the data source), **Target** (a comma-separated list of domains, subdomains, and subfolders, up to 200), and **Display Date**. When a display date is set, data from that date through the most recent day is retrieved on the initial connection and new data is added over time; when it is left unset, only data within the default date range is accessible.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. The initial sync runs in the background.
  </Step>
</Steps>

## What gets imported

Position tracking exposes keyword rank, visibility, share of voice, and top-N keyword counts. Domain analytics covers organic and paid keyword counts, traffic, and traffic cost. Backlink data includes total backlinks, referring domains, and new and lost link counts. Authority Score is also available.

For the complete list of report types, metrics, breakdowns, and regional database values, see the [Semrush data reference](/data-sources/o-z/semrush/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="API units exhausted and the data source disconnected">
    Each report request consumes API units from the Semrush subscription tied to the key. High-frequency dashboards or many viewers can exhaust the monthly budget on smaller plans. When Semrush returns unit-exhaustion errors, the data source is disconnected until additional units are purchased or the budget resets.
  </Accordion>

  <Accordion title="Numbers change after switching the database">
    Domain and keyword figures come from the selected regional Semrush database. Switching the database (for example from `us` to `uk`) produces different figures because the underlying SERP corpus differs. Comparisons across databases are not like-for-like.
  </Accordion>

  <Accordion title="Position-tracking rows are duplicated per keyword tag">
    In position-tracking organic reports, each keyword and URL pair is emitted once per tag assigned to the keyword. Keywords with no tag surface as a single row labeled `no tag`. Numeric metrics default to mean aggregation to prevent inflation from this duplication.
  </Accordion>

  <Accordion title="Recent dates appear empty in trends reports">
    Reports in the trends family are not finalized until roughly 10 days after the index day. Very recent dates are skipped until Semrush publishes the complete data.
  </Accordion>

  <Accordion title="Position tracking defaults to the last 90 days">
    When no start date is supplied for a tracking report, the connector defaults to 90 days ago. Specify a custom start date to extend the range, subject to Semrush retention.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Semrush data reference" href="/data-sources/o-z/semrush/data-reference">
    Report types, metrics, breakdowns, and regional databases for Semrush.
  </Card>

  <Card title="Semrush FAQs" href="/data-sources/o-z/semrush/faqs">
    Common questions and expected behaviors for the Semrush data source.
  </Card>

  <Card title="How to connect SISTRIX" href="/data-sources/o-z/sistrix/how-to-connect">
    Connect an alternative SEO visibility platform.
  </Card>

  <Card title="How to connect SE Ranking" href="/data-sources/o-z/se-ranking/how-to-connect">
    Connect another keyword rank-tracking and SEO data source.
  </Card>
</CardGroup>