Get backlinks history

Author: GTFalcao

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

@@ -0,0 +1,69 @@
+import dataforseo from "../../dataforseo.app.mjs";
+
+export default {
+  key: "dataforseo-get-backlinks-history",
+  name: "Get Backlinks History",
+  description:
+    "Get historical backlinks data back to the beginning of 2019. [See the documentation](https://docs.dataforseo.com/v3/backlinks/history/live/)",
+  version: "0.0.1",
+  type: "action",
+  methods: {
+    getBacklinksHistory(args = {}) {
+      return this._makeRequest({
+        path: "/backlinks/history/live",
+        method: "post",
+        ...args,
+      });
+    },
+  },
+  props: {
+    dataforseo,
+    target: {
+      type: "string",
+      label: "Target Domain",
+      description: "Domain should be specified without `https://` and `www`",
+    },
+    dateFrom: {
+      type: "string",
+      label: "Starting Date",
+      description:
+        "Starting date of the time range, in `YYYY-MM-DD` format. Default and minimum value is `2019-01-01`",
+      optional: true,
+    },
+    dateTo: {
+      type: "string",
+      label: "End Date",
+      description:
+        "End date of the time range, in `YYYY-MM-DD` format. Default is today's date",
+      optional: true,
+    },
+    rankScale: {
+      propDefinition: [
+        dataforseo,
+        "rankScale",
+      ],
+    },
+    tag: {
+      propDefinition: [
+        dataforseo,
+        "tag",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.getBacklinksHistory({
+      $,
+      data: [
+        {
+          target: this.target,
+          date_from: this.dateFrom,
+          date_to: this.dateTo,
+          rank_scale: this.rankScale,
+          tag: this.tag,
+        },
+      ],
+    });
+    $.export("$summary", "Successfully retrieved backlinks history");
+    return response;
+  },
+};

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

@@ -91,7 +91,7 @@ export default {
         },
       ],
     });
-    $.export("$summary", "Successfully retrieved backlink summary");
+    $.export("$summary", "Successfully retrieved backlinks data");
     return response;
   },
 };