Get Bulk Backlinks and Ranks

Author: GTFalcao

components/dataforseo/actions/get-backlink-summary/get-backlink-summary.mjs

@@ -5,7 +5,7 @@ export default {
   key: "dataforseo-get-backlink-summary",
   name: "Get Backlink Summary",
   description:
-    "Get an overview of backlinks data available for a given domain, subdomain, or webpage. [See the documentation](https://docs.dataforseo.com/v3/backlinks/summary/live/?bash)",
+    "Get an overview of backlinks data available for a given domain, subdomain, or webpage. [See the documentation](https://docs.dataforseo.com/v3/backlinks/summary/live/)",
   version: "0.0.1",
   type: "action",
   methods: {
@@ -92,7 +92,7 @@ export default {
         dataforseo,
         "additionalOptions",
       ],
-      description: "Additional parameters to send in the request. [See the documentation](https://docs.dataforseo.com/v3/backlinks/summary/live/?bash) for all available parameters. Values will be parsed as JSON where applicable.",
+      description: "Additional parameters to send in the request. [See the documentation](https://docs.dataforseo.com/v3/backlinks/summary/live/) for all available parameters. Values will be parsed as JSON where applicable.",
     },
   },
   async run({ $ }) {

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

@@ -5,7 +5,7 @@ export default {
   key: "dataforseo-get-backlinks",
   name: "Get Backlinks",
   description:
-    "Get a list of backlinks and relevant data for a given domain, subdomain, or webpage. [See the documentation](https://docs.dataforseo.com/v3/backlinks/backlinks/live/?bash)",
+    "Get a list of backlinks and relevant data for a given domain, subdomain, or webpage. [See the documentation](https://docs.dataforseo.com/v3/backlinks/backlinks/live/)",
   version: "0.0.1",
   type: "action",
   methods: {
@@ -73,7 +73,7 @@ export default {
         dataforseo,
         "additionalOptions",
       ],
-      description: "Additional parameters to send in the request. [See the documentation](https://docs.dataforseo.com/v3/backlinks/backlinks/live/?bash) for all available parameters. Values will be parsed as JSON where applicable.",
+      description: "Additional parameters to send in the request. [See the documentation](https://docs.dataforseo.com/v3/backlinks/backlinks/live/) for all available parameters. Values will be parsed as JSON where applicable.",
     },
   },
   async run({ $ }) {

components/dataforseo/actions/get-bulk-backlinks/get-bulk-backlinks.mjs

@@ -0,0 +1,46 @@
+import dataforseo from "../../dataforseo.app.mjs";
+
+export default {
+  key: "dataforseo-get-bulk-ranks",
+  name: "Get Bulk Ranks",
+  description:
+    "Get the number of backlinks pointing to specified  domains, subdomains, and pages. [See the documentation](https://docs.dataforseo.com/v3/backlinks/bulk_backlinks/live/)",
+  version: "0.0.1",
+  type: "action",
+  methods: {
+    getBulkBacklinks(args = {}) {
+      return this._makeRequest({
+        path: "/backlinks/bulk_backlinks/live",
+        method: "post",
+        ...args,
+      });
+    },
+  },
+  props: {
+    dataforseo,
+    targets: {
+      type: "string[]",
+      label: "Targets",
+      description: "Up to 1000 domains, subdomains or webpages to get number of backlinks for. A domain or a subdomain should be specified without `https://` and `www`. A page should be specified with absolute URL (including `http://` or `https://`",
+    },
+    tag: {
+      propDefinition: [
+        dataforseo,
+        "tag",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.getBulkBacklinks({
+      $,
+      data: [
+        {
+          targets: this.targets,
+          tag: this.tag,
+        },
+      ],
+    });
+    $.export("$summary", "Successfully retrieved bulk backlinks");
+    return response;
+  },
+};

components/dataforseo/actions/get-bulk-ranks/get-bulk-ranks.mjs

@@ -0,0 +1,53 @@
+import dataforseo from "../../dataforseo.app.mjs";
+
+export default {
+  key: "dataforseo-get-bulk-ranks",
+  name: "Get Bulk Ranks",
+  description:
+    "Get rank scores of specified domains, subdomains, and pages. [See the documentation](https://docs.dataforseo.com/v3/backlinks/bulk_ranks/live/)",
+  version: "0.0.1",
+  type: "action",
+  methods: {
+    getBacklinksBulkRanks(args = {}) {
+      return this._makeRequest({
+        path: "/backlinks/bulk_ranks/live",
+        method: "post",
+        ...args,
+      });
+    },
+  },
+  props: {
+    dataforseo,
+    targets: {
+      type: "string[]",
+      label: "Targets",
+      description: "Up to 1000 domains, subdomains or webpages to get `rank` for. A domain or a subdomain should be specified without `https://` and `www`. A page should be specified with absolute URL (including `http://` or `https://`",
+    },
+    rankScale: {
+      propDefinition: [
+        dataforseo,
+        "rankScale",
+      ],
+    },
+    tag: {
+      propDefinition: [
+        dataforseo,
+        "tag",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.getBacklinksBulkRanks({
+      $,
+      data: [
+        {
+          targets: this.targets,
+          rank_scale: this.rankScale,
+          tag: this.tag,
+        },
+      ],
+    });
+    $.export("$summary", "Successfully retrieved bulk ranks");
+    return response;
+  },
+};

components/dataforseo/dataforseo.app.mjs

@@ -96,7 +96,7 @@ export default {
       type: "string[]",
       label: "Backlinks Filters",
       description:
-        "You can use this field to filter the initial backlinks that will be included in the dataset for aggregated metrics for your target. [See the documentation](https://docs.dataforseo.com/v3/backlinks/filters/?bash) for more information. Example: `[\"dofollow\", \"=\", true]`",
+        "You can use this field to filter the initial backlinks that will be included in the dataset for aggregated metrics for your target. [See the documentation](https://docs.dataforseo.com/v3/backlinks/filters/) for more information. Example: `[\"dofollow\", \"=\", true]`",
       optional: true,
     },
     rankScale: {