Ahrefs - update to API v3

components/ahrefs/actions/get-backlinks-one-per-domain/get-backlinks-one-per-domain.mjs

@@ -0,0 +1,55 @@
+const ahrefs = require("../../ahrefs.app.mjs");
+
+export default {
+  name: "Get Backlinks One Per Domain",
+  key: "ahrefs-get-backlinks-one-per-domain",
+  description: "Get one backlink with the highest `ahrefs_rank` per referring domain for a target URL or domain (with details for the referring pages including anchor and page title). [See the documentation](https://docs.ahrefs.com/docs/api/site-explorer/operations/list-all-backlinks)",
+  version: "0.0.6",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    ahrefs,
+    target: {
+      propDefinition: [
+        ahrefs,
+        "target",
+      ],
+    },
+    select: {
+      propDefinition: [
+        ahrefs,
+        "select",
+      ],
+    },
+    mode: {
+      propDefinition: [
+        ahrefs,
+        "mode",
+      ],
+    },
+    limit: {
+      propDefinition: [
+        ahrefs,
+        "limit",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.ahrefs.getBacklinks({
+      $,
+      params: {
+        aggregation: "1_per_domain",
+        target: this.target,
+        select: this.select.join(","),
+        mode: this.mode,
+        limit: this.limit,
+      },
+    });
+    $.export("$summary", "Successfully retrieved backlinks data");
+    return response;
+  },
+};

components/ahrefs/actions/get-backlinks/get-backlinks.mjs

@@ -0,0 +1,54 @@
+const ahrefs = require("../../ahrefs.app.mjs");
+
+export default {
+  name: "Get Backlinks",
+  key: "ahrefs-get-backlinks",
+  description: "Get the backlinks for a domain or URL with details for the referring pages (e.g., anchor and page title). [See the documentation](https://docs.ahrefs.com/docs/api/site-explorer/operations/list-all-backlinks)",
+  version: "0.0.10",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    ahrefs,
+    target: {
+      propDefinition: [
+        ahrefs,
+        "target",
+      ],
+    },
+    select: {
+      propDefinition: [
+        ahrefs,
+        "select",
+      ],
+    },
+    mode: {
+      propDefinition: [
+        ahrefs,
+        "mode",
+      ],
+    },
+    limit: {
+      propDefinition: [
+        ahrefs,
+        "limit",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.ahrefs.getBacklinks({
+      $,
+      params: {
+        target: this.target,
+        select: this.select.join(","),
+        mode: this.mode,
+        limit: this.limit,
+      },
+    });
+    $.export("$summary", "Successfully retrieved backlinks data");
+    return response;
+  },
+};

components/ahrefs/actions/get-referring-domains/get-referring-domains.mjs

@@ -0,0 +1,55 @@
+const ahrefs = require("../../ahrefs.app.mjs");
+
+export default {
+  name: "Get Referring Domains",
+  description: "Get the referring domains that contain backlinks to the target URL or domain. [See the documentation](https://docs.ahrefs.com/docs/api/site-explorer/operations/list-refdomains)",
+  key: "ahrefs-get-referring-domains",
+  version: "0.0.18",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    ahrefs,
+    target: {
+      propDefinition: [
+        ahrefs,
+        "target",
+      ],
+    },
+    select: {
+      propDefinition: [
+        ahrefs,
+        "select",
+      ],
+      description: "An array of columns to return. [See response schema](https://docs.ahrefs.com/docs/api/site-explorer/operations/list-refdomains) for valid column identifiers.",
+    },
+    mode: {
+      propDefinition: [
+        ahrefs,
+        "mode",
+      ],
+    },
+    limit: {
+      propDefinition: [
+        ahrefs,
+        "limit",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.ahrefs.getReferringDomains({
+      $,
+      params: {
+        target: this.target,
+        select: this.select.join(","),
+        mode: this.mode,
+        limit: this.limit,
+      },
+    });
+    $.export("$summary", "Successfully retrieved referring domains data");
+    return response;
+  },
+};