Skip to main content

How to Connect SEMrush to Whatagraph

Connect Semrush with your API key to pull Position Tracking and Domain Analytics data into your Whatagraph reports.

The Semrush integration brings your SEO and competitive data - keyword positions, domain analytics, and organic performance - into Whatagraph so you can build and create reports on it. Semrush connects with an API key, and once it's connected, you choose which Position Tracking projects and domains you want to report on.


Before You Begin

Connecting Semrush requires API access on your Semrush account:

  • A Semrush plan that includes API units (API access is available on the Business plan or as an add-on).

  • Your Semrush API key.

Note: Keep a comfortable API unit balance before connecting - around 100,000 units helps avoid interrupted data syncing. Higher result limits consume more units per request.


How to get your Semrush API key

Step 1. Log in to your Semrush account.

Step 2. Open Subscription info from your account menu (usually under your profile).

Step 3. In the API section, copy your API key. You'll paste it into Whatagraph in the next section.


How to connect Semrush in Whatagraph

Step 1. In Whatagraph, go to Data sources in the left navigation.

Step 2. Click "Add source".

Step 3. Find and select Semrush from the list of integrations.

Step 4. Fill in the connection form:

  • Account name - a label to identify this Semrush connection

  • Email - the email address on your Semrush account

  • API key - the key you copied from Semrush

Step 5. Click "Add an account".

After connecting, Whatagraph shows every Semrush project that has Position Tracking enabled, plus a Domain Analytics (Custom) option for domains that aren't part of a Position Tracking project. Select the Position Tracking projects you want to connect as sources.


How to connect a domain without Position Tracking

If a domain isn't part of a Semrush Position Tracking project, connect it with Domain Analytics (Custom) to still pull Semrush data for it.

Step 1. Select Domain Analytics (Custom).

Step 2. Fill in the fields:

  • Display limit - number of rows returned (default 10; higher limits use more API units)

  • Database - regional database code (default us)

  • Display Daily - choose Monthly (default) or Daily for how history data is shown

  • Source name - a recognizable name for the source

  • Domain - the root domain, subdomain, or URL you want to report on

  • Domain type - Root domain, Subdomain, Subfolder, or URL

Step 3. Click "Add source".

The domain is added as a source, and its Semrush Domain Analytics data becomes available to widgets even though Position Tracking isn't enabled.

Did this answer your question?