# Moz

Moz is an SEO software suite providing keyword research, site audits, rank tracking, and competitive insights to boost organic search visibility

- **Category:** marketing automation
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `MOZ`
- **Version:** 20260316_00

## Tools

### Fetch Metadata Index

**Slug:** `MOZ_FETCH_METADATA_INDEX`

Tool to fetch current index metadata from Moz via JSON-RPC. Returns an index ID that changes when the data in the index is updated. Use when you need to track index updates or verify the current index state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | No | Optional unique identifier for the JSON-RPC request (min 24 chars). If not provided, a UUID will be generated automatically. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Fetch Site Metrics

**Slug:** `MOZ_FETCH_SITE_METRICS`

Tool to fetch site metrics from Moz including Domain Authority, Page Authority, Spam Score, and link counts. Use when you need SEO metrics for a domain or specific URL. Returns comprehensive link and authority data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | No | Unique identifier for the JSON-RPC request (min 24 characters). Auto-generated if not provided. |
| `site_query` | object | Yes | Site query parameters containing the target domain/URL and scope. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Global Top Root Domains

**Slug:** `MOZ_GET_GLOBAL_TOP_ROOT_DOMAINS`

Tool to get the top 500 root domains across the entire web index sorted by Domain Authority. Returns the highest authority domains globally with Domain Authority, Spam Score, and linking domains count. Use when you need to identify the most authoritative domains on the web.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (1-500). Controls how many top domains are included in the response. |
| `next_token` | string | No | Cursor for fetching the next set of results from a previous request. If set, return the next page of results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get API Usage Data

**Slug:** `MOZ_GET_USAGE_DATA`

Tool to get API usage data including the number of rows consumed. Use when you need to track API usage for a specific time range or the current billing period.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end` | string | No | End of time period in Unix time (seconds since 1970-01-01 UTC). Default is current time. |
| `start` | string | No | Start of time period in Unix time (seconds since 1970-01-01 UTC). Default is start of current month. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Global Top Pages

**Slug:** `MOZ_GLOBAL_TOP_PAGES`

Tool to fetch global top pages from Moz. Use when you need a paginated list of highest authority pages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (1-50). Defaults to server default when omitted. |
| `next_token` | string | No | Cursor for fetching the next page of results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Index Metadata

**Slug:** `MOZ_INDEX_METADATA`

Tool to fetch link index metadata from Moz. Use when you need the current index ID (which changes when the index updates) and the dates of Spam Score model updates. Use after authenticating with Moz API.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Link Status

**Slug:** `MOZ_LINK_STATUS`

Tool to check if source URLs link to a target URL. Use when you need to verify inbound links from multiple sources to a target.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `target` | string | Yes | The target URL to check inbound links against. |
| `sources` | array | Yes | List of source URLs to test linking to the target (1 to 50 URLs). |
| `source_scope` | string ("page" | "subdomain" | "root_domain") | No | Scope for the source URLs: one of 'page', 'subdomain', or 'root_domain'. If omitted, defaults to 'page'. |
| `target_scope` | string ("page" | "subdomain" | "root_domain") | No | Scope for the target URL: one of 'page', 'subdomain', or 'root_domain'. If omitted, defaults to 'page'. Broader scopes ('subdomain', 'root_domain') match links across more URLs than intended and can produce false positives when verifying a specific page-level link. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Global Top Domains

**Slug:** `MOZ_LIST_GLOBAL_TOP_DOMAINS`

Tool to get the top ranking domains globally based on Domain Authority. Use when you need the highest authority domains in the entire Moz index.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of results to return. Defaults to 50 if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Global Top Pages (JSON-RPC)

**Slug:** `MOZ_LIST_GLOBAL_TOP_PAGES`

Tool to fetch global top ranking pages from Moz using JSON-RPC API. Use when you need to retrieve the highest Page Authority pages in the entire Moz index.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Lookup Quota Information

**Slug:** `MOZ_LOOKUP_QUOTA`

Tool to lookup API quota information including remaining rows, quota limits, and usage across different quota types. Use when you need to check current quota status without consuming quota.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Quota path to lookup. Common paths: 'api.limits.data.rows' for data row quota, 'api.limits.beta.rows' for beta row quota, 'api.limits.mozscape.rows' for mozscape quota. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Top Pages

**Slug:** `MOZ_POST_TOP_PAGES`

Tool to fetch the top pages on a target domain from Moz. Top pages are identified as pages with the most external links. Use when you need a list of high-authority pages on a specific domain or subdomain, sorted by Page Authority or other metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | The sort order for results. Common values: 'page_authority' (default), 'domain_authority', 'external_pages_to_page'. Prefix with '-' for descending order (e.g., '-page_authority'). |
| `limit` | integer | No | Maximum number of results to return (1-1000). Defaults to server default when omitted. |
| `scope` | string ("page" | "subdomain" | "root_domain") | No | The scope of the query. Options: 'page', 'subdomain', or 'root_domain'. Defaults to 'page' if omitted. |
| `filter` | string | No | Filter for results based on HTTP status codes. Example: 'http_code:200' to only include pages with HTTP 200 status. |
| `target` | string | Yes | The domain or URL to query for top pages. |
| `next_token` | string | No | Pagination token for fetching the next page of results. Use the 'next_token' value from a previous response. |
| `daily_history_deltas` | array | No | Array of strings specifying daily history delta metrics to include in the response. |
| `daily_history_values` | array | No | Array of strings specifying daily history value metrics to include in the response. |
| `monthly_history_deltas` | array | No | Array of strings specifying monthly history delta metrics to include in the response. |
| `monthly_history_values` | array | No | Array of strings specifying monthly history value metrics to include in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Usage Data

**Slug:** `MOZ_USAGE_DATA`

Tool to fetch API usage and quota details from Moz. Use when you need to monitor current plan, quota usage, and rate limits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `target` | string | No | Optional target URL when probing anchor_text or url_metrics. |
| `resource` | string | No | Specific resource type label, e.g., 'url_metrics'. |
| `timeframe` | string ("daily" | "monthly") | No | Timeframe hint (used for labeling only). |
| `probe_endpoint` | string ("index_metadata" | "anchor_text" | "url_metrics") | No | Which endpoint to probe to extract usage headers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |