Collecting data from Semrush

This guide explains how to collect data from Semrush. To learn how to collect data from a different data source, go back to the Available data sources in Adverity overview.


For a list of the fields that you can collect from Semrush, see Semrush.

  • Semrush can collect a maximum of 1 million rows per single report. To fetch more data than this, split your fetch into smaller date ranges in the Initial Fetch step of creating a datastream.

Creating a datastream to collect data from Semrush

The basics of creating a datastream to collect data from any data source are explained in our guide to Creating a datastream. This guide contains information about the specific steps to create a datastream to fetch data from Semrush.

Authorization: Allow Adverity to access Semrush

To set up a new authorization to fetch data from Semrush, follow these steps:

  1. In the Authorization step of the datastream wizard, click Access Semrush using your credentials.

  2. Click Next.

  1. Select one of the following options:

    • Click Semrush (API key) to authorize Adverity using an API key:

      1. Create an API key as described in the Semrush documentation.

      2. In Adverity, in the API key field, enter the key you have created.

    • Click Semrush (OAuth) to authorize Adverity by logging into your Semrush account.

  1. Click Authorize.

Configuration: Choose the data you want to collect from Semrush

To choose what data to collect and customize the Semrush datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  1. In Report type, select the type of data to collect from Semrush. The fields you need to configure in the following steps differ according to the report type you select.

  1. In Domains, Phrases, Projects, and URLs, select the domains, phrases, projects, and URLs for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

  1. In Databases, select the databases for which to collect data.

  2. In Display positions, select the display positions for which to collect data.

  3. In Time granularity, choose whether to collect data using monthly or daily granularity.

  1. In Fields, change the list of fields that you want to see in your data extract.

  1. In Top filter, select a filter to apply to the data you collect.

  2. In Display limit, select the number of rows of data you want to collect.

  3. In Sort result by, select the criteria by which you want to sort the data you collect.

  4. In Sorting order, choose whether to sort the data in ascending or descending order.

What's next?