Guide: Using SEMrush with Databox


How to connect SEMrush to Databox


How to connect SEMrush to Databox

To connect a SEMrush Account in Databox, go to  Data Sources > + New connection. 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 API Key (required) and up to 5 Competitor URLs (optional).

  • API Key: The API Key in SEMrush can be found by navigating to User Profile > API > Begin: Get API Key
  • Competitor Fields: In order to report on competitor data in Databox, you must manually enter Competitor URLs. Competitor fields need to be inserted manually. If you choose to not enter any Competitor URLs, Position Tracking metrics will only return data for your URL domain. 

How to report on Project data

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 "" and not as "".

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 connection 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. 
     Navigate to Management > Projects 
     Select the project whose Business Name you would like to access
     Select  Positioning Tracking
     In the upper righthand corner, click the Settings icon and select Tracking + Project Name
     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. 
To enter the Business Name for an existing SEMrush connection in Databox:
     Navigate to the  Data Manager
      Find SEMrush Data Source, using the Search bar if necessary 
      Next to the Details button, click on the arrow and select Edit
     In the  Business Name field, paste the exact Business Name from SEMrush

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 connection. 

To add or edit Competitors for an existing Data Source connection, navigate to Data Manager and select your SEMrush Data Source. From the Details drop-down menu select Edit. Add competitors and save the changes.   

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

How much historical data is synced when you first connect SEMrush to Databox?

When you connect a new SEMrush Data Source in Databox, 3 months worth of historical data is initially synced. 

For "Keyword" Metrics, such as "Top Keywords by position", only keywords that have been tracked in the past 33 days are synced with Databox. 

All the SEMrush Metrics are of the Overall Total Value Data Type, which means that some Metrics have no retroactive history (the total current value will be displayed for these Metrics), except for Keyword Metrics.
Pro Tip: Once your SEMrush Data Source is connected and actively syncing data, we store the data that's collected in our own database. This allows us to accumulate more data over time as more data syncs are made so that you can report on more historical SEMrush data in your Databox reports. Learn more here

What time zone does SEMrush data sync in? 

SEMrush data is synced in UTC.

Which SEMrush plans have API access?

SEMrush API units are only available on SEMrush's Business Plan. Learn more about SEMrush API Access here

How often does SEMrush data sync?

By default, all connected SEMrush connections will sync once a day. This is because API units are charged inside SEMrush, and a complete day of hourly data syncs would use 10,500 API units. 

If you're interested in lowering your SEMrush costs, you can reduce the sync frequency further to once per week or once per month. Please contact [email protected] for more information.

How to access pre-built SEMrush Templates

 Navigate to Databoards > Template Library
 In the Data Source drop-down list, select SEMrush
 To view a preview of the Template populated with dummy data, click Preview
 To pull the Template into your Account and re-populate it with your own SEMrush data, click Use Template
 Select the appropriate SEMrush Data Source from the drop-down list to complete the process. The Databoard will be re-populated with data from the selected SEMrush Account and can be found on the  Databoards page
Pro Tip: Once the Databoard is available on the Databoards page, it is completely disconnected from the public Template. Therefore, you can further customize this Databoard to meet your specific needs using the Designer.

Popular SEMrush Templates

SEMrush: Position Tracking SEMrush (Keywords & Audits)
This dashboard displays the change in your online presence based on your keyword rankings over time.
SEMRush (Keywords and Audits) dashboard gives you a full view of your SEO visibility as well as any errors that occurred.

How to build a Databoard using SEMrush data

 Navigate to  Databoards > + New Databoard > Start Blank
 Click on the Datablock Library icon on the lefthand side of the Designer
 Select the appropriate SEMrush Account from the Data Source drop-down list in the Datablock Library
 View the list of pre-built SEMrush Datablocks in the Datablock Library. Drag and drop your selected Datablock onto your Databoard    

 If a pre-built Datablock isn't available for your use case, click on the  Visualization Types icon under the Datablock Library icon

 View the list of Visualizations available in Databox. Drag and drop your selected Visualization onto your Databoard
 Click on the Datablock on the Databoard to open the corresponding Datablock Settings on the righthand side of the Designer
 Select the appropriate SEMrush Data Source and Metric in the righthand Datablock Settings. This will update the Datablock and it will populate the Datablock with the corresponding data
 Complete steps 4-8 until your Databoard is complete

Popular SEMrush Metrics

Visibility Trend Keywords in Top 3 Top Keywords by Position

View a full list of SEMrush Metrics available in Databox here.

Additional Information

  • The behavior of the "Top Keywords by Position" Metric
  • If a keyword position falls out of the top 100, it will be displayed as n/a in SEMrush. However, in Databox we need to show a piece of data for the keyword since we cannot display a blank value. That is why we display the position value of 101 for these keywords. This does not mean that the keyword is in the 101st position, but rather that the keyword is not among the top 100 keywords by position and is marked n/a in SEMrush - has no displayed value.
    Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

    Still need help? Contact Us Contact Us