Skip to main content

How do I create Moz metrics?

Updated

Visualize, discover, and act on your SEO data by creating Moz data feed metrics.

Connecting PowerMetrics to your Moz data

When connecting Klipfolio to your Moz data, you'll be asked to enter your Moz Access ID and Secret Key.

Finding your Moz Access ID and Secret Key

  1. Log in to your Moz Pro or Community account.
  2. Then, click the following link or enter it into your browser: https://moz.com/products/api/keys
  3. Click Manage Mozscape API Key.
  4. Under Credentials, copy your Access ID and Secret Key.

Creating Moz data feed metrics

When you create Moz data feed metrics, you:

Connecting to your Moz account and adding a data feed

Every metric needs a data feed. As you create metrics, you’ll either create a new data feed or select one from your list of existing data feeds. Learn more about data feeds.

To create a new data feed for your metric:

  1. In the left navigation sidebar click the + button beside Metrics and select See all services.
  2. On the Where is your data? page, under Data Feed Services, select Moz.
  3. Click +New data feed > Select Moz data.
  4. Select a pre-built data source from the left section of the Choose a pre-built or custom connection page or click +Create a custom Moz data source.
  5. If you chose a pre-built data source for your data feed:
    • Enter a Company URL (the URL of the website you want to get data from) and your Moz Access ID and Secret Key.
    • If you want to modify the pre-built data request, click Switch to Custom settings.
      Note: If you switch back to the Basic settings page after making changes in the Custom settings page, your changes will not be saved.
    • If you clicked Switch to custom settings: Modify the Query URL to get the data you want. You can use the existing information in the Query URL text box as a base. It was auto-filled based on the pre-built data source you selected earlier. If you need help writing your query, refer to the Moz API documentation.
  6. If you chose a custom-built data source for your data feed:
    • Edit the Query URL to return the data you're looking for. Replace <yourDomainURL> with the URL of the website you want to get data from. Then, replace <yourAccessID> (it appears twice in the query URL) and <yourAPISecret> with your own information. If you need help writing your query, refer to the Moz API documentation.
  7. Click Get data.
  8. Ensure this is the data you’re looking for. Then, click Continue. Next step - refine the data in the data feed editor.

To use an existing data feed for your metric:

  1. In the left navigation sidebar, click Data Feeds.
  2. In your list of Data Feeds, select the one you want to use for your metric.
  3. Click the Metrics tab in the right-side pane.
  4. Click +Add metric and proceed to Configuring your metric.

Refining data in the data feed editor

You’ve arrived in the data feed editor where you can choose to either accept the automatic settings or make changes.

If you’re happy with the automatic settings:

If you want to make changes:

  • Moz returns data in a JSON format. The method for refining and editing JSON source data is slightly different than when dealing with source data that’s already in a tabular format. Learn how to refine and edit JSON source data feeds.
  • Some common adjustments include changing the data format or names for columns, updating the data feed name, and combining columns using formulas - there are many customization options available.
  • If you want to adjust the original query, click the tile under Data service.
  • When you’re finished editing the data feed, click Save data feed and proceed to Configuring your metric.

Note: After you’re finished creating a metric with this data feed, you can return to it and use it to make more data feed metrics. In the left navigation sidebar, click Data Feeds. Select the desired data feed from the list and click +Add metric.

Configuring your metric

When you configure a data feed metric, you select the measure and dimensions from the data feed to include in the metric and choose settings that determine how the data will be visualized. Go here for detailed instructions on configuring your metric.

Next steps – Interacting with your data

Now that you're connected and have some metrics, it's time to start learning from your data and tracking your progress.

Here are a few suggestions for interacting with your data:

More about Moz's API and queries

See the reference table below for API related information and sample queries.

API Documentation Moz API documentation
Authentication Method API Key Authentication
Response Format JSON
API Limits and Notes The default value for Limit is 25. The maximum value is 50. The Offset parameter specifies a number of results to skip past. Offsets greater than 100,000 return an empty array.
Sample Queries

Top Pages by Authority:

http://lsapi.seomoz.com/linkscape/top-pages/<yourDomainURL>?Offset=0&Limit=50&Cols=34359738372&Sort=page_authority&AccessID=<yourAccessID>&Expires={hash.getExpiryTime(240);}&Signature={hash.append("<yourAccessID>").appendNewLine().append(hash.getExpiryTime(240)).encodeHmacSha1("<yourAPISecret>").encodeBase64().encodeURL().printDigest();}

URL Metrics:

http://lsapi.seomoz.com/linkscape/url-metrics/<yourDomainURL>?Cols=182537206068411005&AccessID=<yourAccessID>&Expires={hash.getExpiryTime(240);}&Signature={hash.append("<yourAccessID>”).appendNewLine().append(hash.getExpiryTime(240)).encodeHmacSha1("<yourAPISecret>").encodeBase64().encodeURL().printDigest();}

Anatomy of a Moz query in PowerMetrics

The following is an example of a typical Moz API query in PowerMetrics, including brief explanations of the key elements:

  • This is an optional Moz API parameter that returns metrics selected by the user. See About cols parameters (below) for more details.
  • This represents a Unix timestamp.
  • This indicates signed authentication. Moz API queries require hashed signatures. To learn more, see PowerMetrics: Signed Authentication Builder.
  • This indicates the end of the hashed signature and must be entered in this order.

About cols parameters

Use the cols parameter to specify which metrics you want to return. Each metric comes with a bit flag value. You can retrieve more than one metric by summing each bit flag value together.

Once you have finished writing your query, set the request message format:

  1. At data format, select JSON.
  2. Select the Method that is appropriate to the query.
  3. Select Submit.

Related articles