DataForSEO icon

DataForSEO

DataForSEO

Overview

The node integrates with the DataForSEO API to retrieve historical backlink summary data for a specified domain. It is designed to fetch backlink metrics over a defined time range, which can help SEO professionals and digital marketers analyze the backlink profile trends of a website historically.

Common scenarios where this node is beneficial include:

  • Tracking the growth or decline of backlinks to a domain over time.
  • Analyzing backlink acquisition patterns for competitive research.
  • Monitoring the effectiveness of link-building campaigns by comparing backlink summaries across different periods.

Practical example: A user wants to see how many backlinks their website had each month in the past year to evaluate the impact of recent SEO efforts.

Properties

Name Meaning
Target Domain The domain to analyze for backlinks, specified without the https:// prefix or www. subdomain.
Date From (Optional) The start date of the historical period to retrieve backlink summary data from. Minimum allowed is January 1, 2019. If not set, the earliest available date will be used.
Date To (Optional) The end date of the historical period. Defaults to today's date if not specified.

Output

The node outputs an array of JSON objects representing the historical backlink summary data for the specified domain and date range. Each object typically contains backlink metrics aggregated over specific time intervals (e.g., daily, weekly, monthly), such as total backlinks, referring domains, and other relevant backlink statistics.

If the API supports binary data output for this operation, it is not indicated in the provided code or properties, so the output is expected to be purely JSON-formatted backlink summary data.

Dependencies

  • Requires an active connection to the DataForSEO API via an API key credential configured in n8n.
  • The node sends POST requests to the DataForSEO API endpoint at https://api.dataforseo.com/v3.
  • Proper API credentials must be set up in n8n to authenticate requests.

Troubleshooting

  • Common issues:

    • Invalid or missing target domain format (must exclude https:// and www.).
    • Date range outside supported limits (dates before 2019-01-01 may be rejected).
    • Missing or invalid API credentials leading to authentication errors.
    • Network connectivity problems preventing access to the DataForSEO API.
  • Error messages:

    • "Something went wrong": Generic error thrown if the requested resource-operation combination is not found or if an unexpected failure occurs during execution. Verify that the resource and operation parameters are correct.
    • Authentication errors: Check that the API key credential is correctly configured and has necessary permissions.
    • Validation errors related to input properties: Ensure the target domain and dates conform to the required formats and constraints.

Links and References

Discussion