Open navigation

How to connect data to Power BI using the Supermetrics API


Supermetrics offers two ways of pulling data to Power BI: via API (a weblink) and with the help of a custom connector that offers an interface and lists your queries.

This guide applies to connecting your data to Power BI using the Supermetrics API weblink. To use our Power BI connector, see our guide on installing the Supermetrics connector for Power BI.

Using the Supermetrics Query Manager, you can easily create queries and connect your data from various data sources to Power BI via the Supermetrics API. Once you're set up, you can schedule refreshes for your data in Power BI.

We recommend using the KEY-JSON output format. Follow these steps to turn KEY-JSON data into a table in Power BI.

Before you begin

See Power BI’s documentation to learn more about connecting to a data source.


  1. Log in to the Supermetrics Hub.
  2. In the sidebar, click API.
  3. Select for Supermetrics API from the dropdown menu next to the page title.
  4. Click Select data source.
  5. Select a data source and connection to use. 
  6. In the sidebar on the left, build your query. Click Run to test it and review your data in the preview.
  7. From the URL format options, select K-JSON
  8. Copy the K-JSON URL.

    The query URL includes an API key that gives anyone with the URL access to your data. Treat this as you would a password and keep it safe. If you need to share the URL publicly, use the Short URL option that does not display your API key.

  9. Open your PowerBI workbook.
  10. Navigate to Home → Get data.
  11. Search for and select Web, then click Connect.
  12. In the From Web view, select the Basic setting, and paste the query URL you copied from the Query Manager into the URL field. Click OK.
  13. Give your data source a memorable name.
  14. Click Close & Apply in the top menu bar to complete the setup.

Convert KEY-JSON to a table in Power BI

These instructions are based on these steps in Stack Overflow.

  1. Define the KEYJSON output format in the URL you generated in the Query Manager. Replace the value after /data/ with keyjson.

    For example, a URL ending in /query/data/powerbi would become a URL ending in /query/data/keyjson.

  2. Open the Power BI query editor.
  3. Convert the list "to table".
  4. Click the expand column icon for "Column1".
  5. You'll see a popup that lists every column in your query.
  6. Select your columns and click OK. Unclick the Use original column name as prefix option to avoid having "Column1" as a prefix in every column.
  7. Select data types for your columns. Power BI interprets all columns as "Text" by default.
  8. Click Close & Apply.

More resources

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.