Semrush Projects connection guide

  • Updated on Jul 16, 2025
  • Published on Jun 26, 2025
Prev Next

This guide contains all permissions and requirements for connecting your Semrush Projects data to Supermetrics.

You can connect to data sources from the Data sources page on the Supermetrics Hub. On the Hub, you can also share an authentication link to connect to a data source you don't have direct access to.

After you connect to the data source on the Hub, you can use the data source connection in all available destinations.

Required permissions

To connect Supermetrics to Semrush Projects, you need an API account, an API key, and a Semrush subscription for API request units. Learn more about Semrush accounts and API request units.

Each API call has a cost, and the cost of requests is measured in API units. Units are determined by the type of report or request retrieved from the Semrush API, and fetching historical data requires more units than live data. One US dollar is equal to approximately 20,000 API units.

Query types

Set up your Semrush Project queries using any of the query types described below.

Reference list: Semrush Projects query types

  • Position tracking

    • Campaign dates

    • Organic overview

    • Organic positions report

    • Adwords positions report

    • Organic competitors discovery report

    • Adwords competitors discovery report

    • Organic visibility index report

    • Adwords visibility index report

  • Site audit

    • Get a list of a campaign's snapshots

    • Get text descriptions about issues

    • Get information about a campaign

    • Get information about a snapshot

    • Detailed report for an issue

    • Get page ID by an URL

    • Get information about a page

    • Get snapshots history

Connection instructions

When connecting to Semrush Projects, you need to provide your API key and select the project to use when prompted. 

  1. Select the Semrush Projects data source on the Supermetrics Hub or in the data destination.

  2. Enter your API key.

  3. If prompted, choose to make this connection shared or private.

  4. Click Start.

  5. In your data destination, select a project to include in your report and a query type.

See detailed instructions on how to connect to a data source from the Supermetrics Hub.

You can also connect to Semrush Projects from these destinations:

More resources