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
1
Select the data source
On the Data Sources page, search for Semrush and select it.
2
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.
3
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.
4
Submit
Click Submit to complete the connection. The initial sync runs in the background.
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.Troubleshooting
API units exhausted and the data source disconnected
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.
Numbers change after switching the database
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.Position-tracking rows are duplicated per keyword tag
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.Recent dates appear empty in trends reports
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.
Position tracking defaults to the last 90 days
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.
Related
Semrush data reference
Report types, metrics, breakdowns, and regional databases for Semrush.
Semrush FAQs
Common questions and expected behaviors for the Semrush data source.
How to connect SISTRIX
Connect an alternative SEO visibility platform.
How to connect SE Ranking
Connect another keyword rank-tracking and SEO data source.
