Skip to content
  • There are no suggestions because the search field is empty.

Guide: Using Semrush with Databox

Last updated:

HOW TO

How to connect Semrush to Databox

IN THIS SECTION

How to connect Semrush to Databox

To connect a Semrush Account in Databox, go to  Data Manager > + New Data Source. Type Semrush in the search bar and click on the green Connect button. 

This will open the   Authorization window, which is where you will be prompted to enter your Semrush login credentials, authorize the Databox app, and up to 5 Competitors URLs (optional).

Pro Tip: In order to report on competitors data in Databox, you must manually enter Competitors URLs (without 'http://").
If you choose not to enter any Competitor URLs, Position Tracking metrics will only return data for your URL domain.

There are a few additional prompts that you must fill out when connecting your data source. These are required so we can get all the important information for your setup.

  • You will be asked to select a project. After you have selected a Project, you will be be asked to select a Campaign. If you have no Campaigns associated with the Project, you will still be able to connect, but some metrics that are specific to Campaigns will not work. When such a metric is placed on a Databoard, you will receive an error message stating that the connected campaign does not exist.
  • The prompts after will be for the tracking / targeting setup. You will be offered 4 options:

Screenshot 2024-04-23 at 7.40.31 PM

  • These 4 options correspond to the following options on SEMrush’s UI:

Screenshot 2024-04-23 at 7.42.53 PM

  • The next prompt will then be about the your database setup:

c5620f06-92a3-44e8-93e8-22a08f28f548

  • This can be accessed on the same location as the information about the tracking setup:

Screenshot 2024-04-23 at 7.47.06 PM

Most of the Competitive Research and Keyword Research reports/metrics fall under this category. If these are not properly set, then discrepancies are likely to occur.

Which Semrush plans can be connected with Databox? 

Due to our partnership with Semrush and the way they've made data available to us, all Semrush accounts and plans can be connected with Databox. 

You do not have to purchase API units to sync your data with Databox. We will use your Semrush login credentials to pull Semrush data to Databox.

How to report on Project data

Pro Tip: Position Tracking must be configured so you can report on project data for the Semrush integration. Without this, the connection can fail once a metric is added on a Databoard. Follow the steps below to set this up:

In Your Semrush Account, navigate to My Projects > Position Tracking column > Set up.

Learn more about Configuring Position Tracking here

When you set up a Project in Semrush, make sure that you enter your Domain without www. The Domain should be entered in the form "urlname.com" and not as "www.urlname.com".

Note that the Project Domain cannot be changed for existing projects. Instead, a new Project with the Project Domain in the correct form has to be created. Historical data can be pulled into the new Project.

If the Project Domain is not set correctly, this can cause missing keywords for the "Top Keywords by Position" Metric. 

How to report on multiple Position Tracking Campaigns within 1 project

Pro Tip: In order to support multiple Position Tracking Campaigns within one project, each Campaign must be added as a separate Data Source in Databox.

If you are using multiple Position Tracking Campaigns, you will need to copy the exact Business Name from your Semrush Account and link it with your Semrush Data Source in Databox. In order to display the correct data in Databox, the Business Name must be identical to what is shown in your Semrush Account. 
To find your  Business Name in Semrush, follow the steps below:
  1. Navigate to Management > Projects 
     
  2. Select the project whose Business Name you would like to access

     

  3. Select  Positioning Tracking
     
  4. In the upper righthand corner, click the Settings icon and select Tracking + Project Name
     
  5. Copy the Business Name from the Business Name for Local Map Pack textbox
    If you are adding a new Semrush Data Source in Databox, paste the Business Name in the Business Name field in the Activate Semrush window during the connection process. 

  If you have already connected the Semrush account in Databox, you will need to edit the Data Source and enter the Business Name to retrieve the relevant data. 

Pro Tip: To add or edit Business Name for an existing Data Source, please contact help@databox.com.
In your email, specify Databox Account(s) and Semrush Data Source(s) that you'd like to edit.

How to report on Competitors data from Semrush   

When you connect your Semrush Data Source to Databox, you can specify the competitors you want to monitor and compare your data against. This can be done during the initial connection process or by editing the Data Source. 

Pro Tip: To add or edit Competitors for an existing Data Source, please contact help@databox.com.
In your email, specify which Databox Account(s) and Semrush Data Source(s) you'd like to edit.

The given Metrics will display data only for the given competitors. These metrics are:

  • Visibility trend by Competitor
  • Estimated traffic by Competitor
  • Average position by Competitor

What's the maximum amount of historical data initially available when you use a new Semrush Metric in Databox?

Data is synced for the Metrics that are being used in your Account, so when you first use a new Semrush Metric, the maximum amount of historical data available is 36 months. Historical data is available for the following metrics:

  • Relative Visibility
  • Absolute Visibility
  • Estimated Traffic
  • Average Position
  • Average Position by Competitor
  • Keywords Tracked
  • Top Keywords by Position
  • Top Keywords by CPC
  • Top Keywords by Volume
  • Keywords in TOP 3
  • Keywords in TOP 10
  • Keywords in TOP 20
  • Keywords in TOP 100

Other Metrics don't have any historical data available. Data will start to sync once you first use a new Semrush Metric in your Account.

Pro Tip:  In order to start syncing data for a Metric, you can add it to your Metrics screen, use it in a Scorecard, set a Goal around it, create an Alert for it, or add it to a Databoard. Learn more  here

The amount of historical data you're able to access in Databox is dependent on your Databox plan. Learn more here.

What time zone does Semrush data sync in? 

Semrush data is synced in UTC.

How often does Semrush data sync?

All Semrush Data Sources will sync once a day with Databox. Learn more here.

Metric Considerations

As of April 2025, due to architectural and product changes, some dimensional metrics have been restructured and are now available as dimensions within a new placeholder metric. The list of affected metrics is provided below.

Old Metric Name New Metric New Dimension (Breakdown by)
Authority Score by Competitor By Competitor Metrics Authority Score by Competitor
Competition Level by Competitor By Competitor Metrics Competition Level by Competitor
Common Referring Domains by Competitor By Competitor Metrics Common Referring Domains by Competitor
Referring Domains by Competitor By Competitor Metrics Referring Domains by Competitor
Backlinks by Competitor By Competitor Metrics Backlinks by Competitor
Position by Keyword (Domain Adwords) By Keyword (Domain Adwords) Metrics Position by Keyword (Domain Adwords)
Previous Position by Keyword (Domain Adwords) By Keyword (Domain Adwords) Metrics Previous Position by Keyword (Domain Adwords)
Position Difference by Keyword (Domain Adwords) By Keyword (Domain Adwords) Metrics Position Difference by Keyword (Domain Adwords)
Search Volume by Keyword (Domain Adwords) By Keyword (Domain Adwords) Metrics Search Volume by Keyword (Domain Adwords)
CPC by Keyword (Domain Adwords) By Keyword (Domain Adwords) Metrics CPC by Keyword (Domain Adwords)
Traffic by Keyword (Domain Adwords) By Keyword (Domain Adwords) Metrics Traffic by Keyword (Domain Adwords)
Traffic Cost by Keyword (Domain Adwords) By Keyword (Domain Adwords) Metrics Traffic Cost by Keyword (Domain Adwords)
Competition by Keyword (Domain Adwords) By Keyword (Domain Adwords) Metrics Competition by Keyword (Domain Adwords)
Number of Results by Keyword (Domain Adwords) By Keyword (Domain Adwords) Metrics Number of Results by Keyword (Domain Adwords)
Position by Keyword (Domain Organic) By Keyword (Domain Adwords) Metrics Position by Keyword (Domain Organic)
Previous Position by Keyword (Domain Organic) By Keyword (Domain Adwords) Metrics Previous Position by Keyword (Domain Organic)
Position Difference by Keyword (Domain Organic) By Keyword (Domain Adwords) Metrics Position Difference by Keyword (Domain Organic)
Search Volume by Keyword (Domain Organic) By Keyword (Domain Adwords) Metrics Search Volume by Keyword (Domain Organic)
CPC by Keyword (Domain Organic) By Keyword (Domain Adwords) Metrics CPC by Keyword (Domain Organic)
Traffic by Keyword (Domain Organic) By Keyword (Domain Adwords) Metrics Traffic by Keyword (Domain Organic)
Traffic Cost by Keyword (Domain Organic) By Keyword (Domain Adwords) Metrics Traffic Cost by Keyword (Domain Organic)
Competition by Keyword (Domain Organic) By Keyword (Domain Adwords) Metrics Competition by Keyword (Domain Organic)
Number of Results by Keyword (Domain Organic) By Keyword (Domain Adwords) Metrics Number of Results by Keyword (Domain Organic)
Keyword Counts by Landing Page By Landing Pages Metrics Keyword Counts by Landing Page
Estimated Traffic by Landing Page By Landing Pages Metrics Estimated Traffic by Landing Page
Average Position by Landing Page By Landing Pages Metrics Average Position by Landing Page
Total Volume by Landing Page By Landing Pages Metrics Total Volume by Landing Page
 

Granularity Restrictions

  • Due to API limitations, hourly granularity is not supported. This may affect visualization options for Charts in Databox.

    For example, if a Semrush Metric is used on a Line or Bar Chart with ''Yesterday'' Date Range selected, hourly data won't be displayed on the Chart.
    However, the big number above the Chart will accurately reflect the Metric value for the selected Date Range.

    Learn more about Granularity here