Semrush - Setup & usage
Follow these steps to connect Semrush, create connected KPIs, and keep syncs healthy.
Before you connect
Confirm you have admin or integrator access to the Semrush account you want to measure.
Connection uses API key.
Only connect accounts your organisation owns or is authorised to report on.
Create the key in Semrush
Sign in with a Business tier SEO Toolkit subscription.
Open Subscription info → API units.
Generate an API key, purchase units if needed, and copy the key.
Connect in Elevale
Open Workspace Settings → Integrations, find Semrush, and paste the API key.
Elevale checks the key before saving it.
Create KPIs
On KPIs & Dashboards, create a Connected KPI, choose Semrush, and pick a data point.
Organic, paid, and backlink metrics use the domain you enter on the KPI.
Position Tracking metrics ask for a campaign. Site Audit metrics ask for a project.
Weekly sync is enough for most SEO reviews.
Troubleshooting
Invalid key - generate a new key under Subscription info → API units.
No units - buy API units in Semrush, then resync the KPI.
No campaign or project - create the Position Tracking campaign or Site Audit project in Semrush first.
Create connected KPIs
On KPIs & Dashboards, create a KPI, choose Connected, and pick your Semrush connection.
Select a data point from the catalog (see the Data points article in this folder for the full list).
Set a sync frequency. An initial sync runs after save; use Resync on the KPI card for on-demand updates.
Review last sync time and error messages on the KPI detail page. Reconnect in Integrations if auth expires.
Sync frequency guidance
Daily - traffic, ads, engineering, and operational metrics reviewed weekly.
Weekly - summary KPIs for leadership dashboards.
Monthly / quarterly - finance and board-level accounting metrics.
Match frequency to how often you review the metric. Use Resync after configuration changes.
Disconnect and data retention
Disconnect from Workspace Settings → Integrations to revoke stored credentials and stop scheduled syncs.
Previously synced KPI history remains until you delete or convert those KPIs.
Subprocessors and data handling: Subprocessors and integrations