Ahrefs Integration — ModuleX AI

Field	Description	Required	Format
Ahrefs API Key	Ahrefs API v3 key, sent as Authorization: Bearer <key>	Yes	`-`

get_backlinks — Get the backlinks for a domain or URL with details for the referring pages (e.g., anchor and page title)

Parameters

string

required

Domain or URL to get backlinks for

array

required

List of columns to return (e.g. url_from, url_to, ahrefs_rank, anchor, page_title)

string

Mode of operation: exact, domain, subdomains, or prefix (Default: domain)

integer

Number of results to return (Default: 1000)

Response

{
  "$defs": {
    "BacklinkItem": {
      "additionalProperties": false,
      "description": "A single backlink record returned by the Ahrefs API.",
      "properties": {
        "url_from": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url From"
        },
        "url_to": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url To"
        },
        "ahrefs_rank": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Ahrefs Rank"
        },
        "anchor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Anchor"
        },
        "page_title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Page Title"
        },
        "first_seen": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "First Seen"
        },
        "last_seen": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Seen"
        },
        "domain_rating": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Domain Rating"
        },
        "extra": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Additional fields returned by the API based on the select parameter",
          "title": "Extra"
        }
      },
      "title": "BacklinkItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "backlinks": {
      "items": {
        "$ref": "#/$defs/BacklinkItem"
      },
      "title": "Backlinks",
      "type": "array"
    },
    "total": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetBacklinksOutput",
  "type": "object"
}

get_backlinks_one_per_domain — Get one backlink with the highest ahrefs_rank per referring domain for a target URL or domain

Parameters

string

required

Domain or URL to get backlinks for

array

required

List of columns to return (e.g. url_from, url_to, ahrefs_rank, anchor, page_title)

string

Mode of operation: exact, domain, subdomains, or prefix (Default: domain)

integer

Number of results to return (Default: 1000)

Response

{
  "$defs": {
    "BacklinkItem": {
      "additionalProperties": false,
      "description": "A single backlink record returned by the Ahrefs API.",
      "properties": {
        "url_from": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url From"
        },
        "url_to": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url To"
        },
        "ahrefs_rank": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Ahrefs Rank"
        },
        "anchor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Anchor"
        },
        "page_title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Page Title"
        },
        "first_seen": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "First Seen"
        },
        "last_seen": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Seen"
        },
        "domain_rating": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Domain Rating"
        },
        "extra": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Additional fields returned by the API based on the select parameter",
          "title": "Extra"
        }
      },
      "title": "BacklinkItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "backlinks": {
      "items": {
        "$ref": "#/$defs/BacklinkItem"
      },
      "title": "Backlinks",
      "type": "array"
    },
    "total": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetBacklinksOnePerDomainOutput",
  "type": "object"
}

get_referring_domains — Get the referring domains that contain backlinks to the target URL or domain

Parameters

string

required

Domain or URL to get referring domains for

array

required

List of columns to return for referring domains (e.g. domain, domain_rating, backlinks)

string

Mode of operation: exact, domain, subdomains, or prefix (Default: domain)

integer

Number of results to return (Default: 1000)

Response

{
  "$defs": {
    "ReferringDomainItem": {
      "additionalProperties": false,
      "description": "A single referring domain record returned by the Ahrefs API.",
      "properties": {
        "domain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Domain"
        },
        "domain_rating": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Domain Rating"
        },
        "backlinks": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Backlinks"
        },
        "first_seen": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "First Seen"
        },
        "last_seen": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Seen"
        },
        "extra": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Additional fields returned by the API based on the select parameter",
          "title": "Extra"
        }
      },
      "title": "ReferringDomainItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "refdomains": {
      "items": {
        "$ref": "#/$defs/ReferringDomainItem"
      },
      "title": "Refdomains",
      "type": "array"
    },
    "total": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetReferringDomainsOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Ahrefs Integration for AI Agents & Workflows

Overview

Authentication

API Key

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Google Search Console

Google Ad Manager

Google My Business

Links

​Overview

​Authentication

​API Key

​Required Credentials

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Google Search Console

Google Ad Manager

Google My Business

​Links

Overview

Authentication

API Key

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links