This guide will walk you through how to authenticate or reauthenticate Searchmetrics in Supermetrics for Google Sheets, Data Studio, and Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and the Supermetrics API.
Before you begin
To connect Supermetrics to Searchmetrics, you need:
- The Administrator access level
- An API key and API secret
- A Searchmetrics account with export credits
- Every data request costs Searchmetrics export credits, even when just testing queries. Learn more about this in Searchmetrics' API documentation.
Get your API key and API secret
Follow the instructions in the Searchmetrics' documentation to generate your API key and API secret.
Save these credentials — you'll need them to complete the steps below.
Instructions
- Open a new Google Sheets file.
- Click Add-ons → Supermetrics → Launch to open the sidebar.
- Under Data source, select Searchmetrics.
- Enter your API key and API secret, and click Start.
- Navigate to Report configuration.
- Under Query type, select the query type.
- Type URL(s), separated with commas or new lines.
- Select a country.
- Open the Supermetrics data source gallery.
- Navigate to Searchmetrics and click Try.
- Click Authorize.
- If you're authenticating the data source for the first time, log in with the Google Account you use with Supermetrics. Click Allow.
- Click Authorize.
- Enter your API key and API secret, and click Start.
- Under Query type, select the query type.
- Type URL(s), separated with commas or new lines.
- Select a country.
- Click Connect on the top right-hand side.
- Click Create report.
- Click Add to report.
Connections
If you use Excel and no other Supermetrics products, you’ll be able to connect accounts to data sources and share these connections with your team. You can manage connections either within the add-in sidebar or via the Supermetrics Team Site. Learn more about shared connections.
Before you can authenticate the data source in Excel, you need to install the Supermetrics add-in.
- Open an Excel file.
- Click Data → Show Supermetrics.
- Under Data source, select Searchmetrics.
- Choose to make this connection shared or private.
- Enter your API key and API secret, and click Start.
- Navigate to Report configuration.
- Under Query type, select the query type.
- Type URL(s), separated with commas or new lines.
- Select a country.
Explore our guides to set up data transfers to various destinations.
- BigQuery
- Data warehouses and cloud storage (Amazon S3, Google Cloud Storage, Snowflake, Azure Storage, or Azure Synapse)
- The Supermetrics API
Reauthenticate the data source
Troubleshooting
- If you encounter an authentication error such as “authentication failed”, “you need to reauthenticate” or similar, see this guide.
- If you're missing an account from the drop-down list, follow these steps.
- If you encounter a permission error such as “user permission denied” or similar, follow this guide.