> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SEMRush Connector

## Intro

SEMRush is a competitive intelligence suite for online marketing, from SEO and PPC to social media and video advertising research.  To learn more about the SEMRush API, visit their page ([https://www.semrush.com/api-documentation/](https://www.semrush.com/api-documentation/ "https://www.semrush.com/api-documentation/") ).

You connect to your SEMRush account in the Data Center. This topic discusses the fields and menus that are specific to the SEMRush connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

## Prerequisites

To connect to your SEMRush account and create a DataSet, you must have a SEMRush API key. For more information about getting going with SEMRush and obtaining an API key, see [https://www.semrush.com/api-use/](https://www.semrush.com/api-use/ "https://www.semrush.com/api-use/").

## Connecting to Your SEMRush Account

This section enumerates the options in the **Credentials** and **Details** panes in the SEMRush Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your SEMRush account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> API Key </p></td><td colspan="1" rowspan="1"><p> Enter your SEMRush API key. </p></td></tr></tbody></table>

Once you have entered valid SEMRush credentials, you can use the same account any time you go to create a new SEMRush DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the SEMRush report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p> Overview </p></td><td colspan="1" rowspan="1"><p> Returns a summary of your SEMRush data. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Domain </p></td><td colspan="1" rowspan="1"><p> Returns competitive information for a specified website domain. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Keywords </p></td><td colspan="1" rowspan="1"><p> Returns competitive information for a specified keyword or keyword expression. </p></td></tr><tr><td colspan="1" rowspan="1"><p> URL </p></td><td colspan="1" rowspan="1"><p> Returns competitive information for a specified landing page URL. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Backlinks </p></td><td colspan="1" rowspan="1"><p> Returns backlinks information for a specified regional database. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Display Advertising </p></td><td colspan="1" rowspan="1"><p> Returns competitive information for a specified advertiser and publisher. </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Domain </p></td><td colspan="1" rowspan="1"><p> Enter the domain of the website you want to retrieve information for, in the format <span class="mt-font-courier-new"><a href="http://example.com" rel="noopener" target="_blank"> example.com </a></span>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Advertiser Domain </p></td><td colspan="1" rowspan="1"><p> Enter the website domain of the advertiser you want to retrieve information for, in the format <span class="mt-font-courier-new"><a href="http://example.com" rel="noopener" target="_blank"> example.com </a></span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Publisher Domain </p></td><td colspan="1" rowspan="1"><p> Enter the website domain of the publisher you want to retrieve information for, in the format <span class="mt-font-courier-new"><a href="http://example.com" rel="noopener" target="_blank"> example.com </a></span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Phrase </p></td><td colspan="1" rowspan="1"><p> Enter a keyword or keyword expression you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> URL </p></td><td colspan="1" rowspan="1"><p> Enter the URL of a landing page you want to retrieve information for. Use the format <span class="mt-font-courier-new"><span class="nowiki"><a href="http://example.com" rel="noopener" target="_blank"> [http://example.com](http://example.com) </a></span></span>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Database </p></td><td colspan="1" rowspan="1"><p> Select the regional database you want to retrieve data from. Select none to query all databases. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Target </p></td><td colspan="1" rowspan="1"><p> Enter a target domain (e.g. <span class="mt-font-courier-new"><span class="nowiki"><a href="http://www.example.com" rel="noopener" target="_blank"> [www.example.com](http://www.example.com) </a></span></span> ), root domain (e.g. <span class="nowiki"><span class="mt-font-courier-new"><a href="http://example.com" rel="noopener" target="_blank"> example.com </a></span></span> ), or URL (e.g. <span class="nowiki"><span class="mt-font-courier-new"><a href="http://example.com" rel="noopener" target="_blank"> [http://example.com](http://example.com) </a></span></span> ) for the "Backlinks" report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Target Type </p></td><td colspan="1" rowspan="1"><p> Select the target type for the target you entered in the <b> Target </b> field. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Target List </p></td><td colspan="1" rowspan="1"><p> Enter a comma-separated list of domains (e.g. <span class="mt-font-courier-new"><span class="nowiki"><a href="http://www.example.com" rel="noopener" target="_blank"> [www.example.com](http://www.example.com) </a></span></span> ), root domains (e.g. <span class="nowiki"><span class="mt-font-courier-new"><a href="http://example.com" rel="noopener" target="_blank"> example.com </a></span></span> ), and/or URLs (e.g. <span class="nowiki"><span class="mt-font-courier-new"><a href="http://example.com" rel="noopener" target="_blank"> [http://example.com](http://example.com) </a></span></span> ) you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Target Type List </p></td><td colspan="1" rowspan="1"><p> Enter a comma-separated list of target types matching the targets you entered for <b> Target List </b>. Target types are as follows: </p><ul><li><p><span class="mt-font-courier-new"> domain </span></p></li><li><p><span class="mt-font-courier-new"> root-domain </span></p></li><li><p><span class="mt-font-courier-new"> url </span></p></li></ul><p> For example, if your target list was <span class="mt-font-courier-new"><a href="http://example.com" rel="noopener" target="_blank"> example.com </a>, <a href="http://www.example.com" target="_blank" title="http://www.example.com"> [http://www.example.com](http://www.example.com) </a>, <a href="http://www.example.com" rel="noopener" target="_blank"> [www.example.com](http://www.example.com) </a></span>, you would enter <span class="mt-font-courier-new"> root domain, url, domain </span> in this field. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Year (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the year you want to retrieve information for. If you combine this with <b> Month </b>, you can pull data for a specific month. </p>
<Note><div class="info-box-wrapper"><div class="info-box-icon-container"><span class="info-box-icon" /></div><div class="info-box-content-container"><div class="info-box-content"><span><b> Note: </b> The SEMRush databases for the US (Google and Bing), the UK, Canada, Australia, France, Italy, Germany, Spain, Russia, and Brazil have data going back to January 2012. Those for Belgium, Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong, and Singapore have data going back as far as January 2014. </span></div></div></div> </Note></td></tr><tr><td colspan="1" rowspan="1"><p> Month (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the month you want to retrieve information for. If you combine this with <b> Year </b>, you can pull data for a specific month. </p> <Note><div class="info-box-wrapper"><div class="info-box-icon-container"><span class="info-box-icon" /></div><div class="info-box-content-container"><div class="info-box-content"><span><b> Note: </b> The SEMRush databases for the US (Google and Bing), the UK, Canada, Australia, France, Italy, Germany, Spain, Russia, and Brazil have data going back to January 2012. Those for Belgium, Netherlands, Israel, Ireland, Denmark, Finland, Norway, Sweden, Switzerland, Poland, Turkey, Argentina, Mexico, Hong Kong, and Singapore have data going back as far as January 2014. </span></div></div></div> </Note></td></tr><tr><td colspan="1" rowspan="1"><p> Report Type </p></td><td colspan="1" rowspan="1"><p> Select a daily or monthly report type. <b> Daily </b> returns the daily history of the domain for the last month only. <b> Monthly </b> returns the entire monthly history of the domain. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Display Positions </p></td><td colspan="1" rowspan="1"><p> Select the display position you want to retrieve information for. Options are as follows: </p><ul><li><p><b> New </b>. Shows keywords for which a domain entered Google's top 20 organic or paid search results. </p></li><li><p><b> Lost </b>. Shows keywords that no longer bring a domain into Google's top 20 organic or paid search results. </p></li><li><p><b> Rise </b>. Shows keywords that helped a domain to get a higher ranking in Google's top 20 organic or paid search results. </p></li><li><p><b> Fall </b>. Shows keywords that are currently helping a domain remain in Google's top 20 organic or paid search results but whose ranking has decreased. </p></li></ul></td></tr><tr><td colspan="1" rowspan="1"><p> Device Type </p></td><td colspan="1" rowspan="1"><p> Select a device type you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Report Columns </p></td><td colspan="1" rowspan="1"><p> Select the type of data you want to retrieve. If no columns are selected, you will receive the report's default columns. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sort By </p></td><td colspan="1" rowspan="1"><p> Select the type of data you want to sort by. If no column is selected, the default sort order will be used. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Display Limit </p></td><td colspan="1" rowspan="1"><p> Enter the number of rows you want to be returned. If you do not enter a value here, Domo requests the first 500 rows of data. The report may contain fewer rows than you request. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").
