DataForSEO icon

DataForSEO

DataForSEO

Overview

This node integrates with the DataForSEO API to retrieve backlink statistics in bulk. Specifically, the "Get Bulk Backlink Stats" operation allows users to query backlink metrics for up to 1000 targets (pages, domains, or subdomains) in a single request. This is useful for SEO professionals and digital marketers who want to analyze backlink profiles at scale, monitor link-building campaigns, or perform competitive backlink research.

Practical examples include:

  • Aggregating backlink counts and quality metrics for multiple client websites.
  • Comparing backlink profiles of competitor domains or specific landing pages.
  • Automating regular backlink audits across a portfolio of sites.

Properties

Name Meaning
Targets A collection of up to 1000 targets to analyze. Each target can be a domain, subdomain, or webpage URL. Domains and subdomains should be specified without https:// or www. prefixes. Webpage URLs must be absolute, including http:// or https://. The targets in one request cannot belong to more than 100 different domains.

Output

The node outputs an array of JSON objects, each representing backlink statistics for one of the specified targets. The exact structure depends on the DataForSEO API response but typically includes backlink counts, referring domains, link quality metrics, and other relevant backlink data.

If the API provides binary data (e.g., reports or files), it would be included accordingly, but this operation primarily returns structured JSON data summarizing backlink stats.

Dependencies

  • Requires an active DataForSEO API account and a valid API key credential configured in n8n.
  • The node sends POST requests to https://api.dataforseo.com/v3.
  • Proper network connectivity to the DataForSEO API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Exceeding the limit of 1000 targets per request or specifying targets from more than 100 different domains will likely cause errors.
    • Incorrectly formatted URLs (e.g., missing protocol for page URLs or including www. in domains) may lead to invalid request errors.
    • API authentication failures if the API key credential is missing or invalid.
  • Error messages:

    • "Something went wrong": Generic error indicating the requested resource-operation combination was not found or improperly configured.
    • API errors returned by DataForSEO (e.g., quota exceeded, invalid parameters) will be propagated; check the error message for details.
  • Resolutions:

    • Validate input targets conform to formatting rules.
    • Ensure API credentials are correctly set up in n8n.
    • Split large target lists into smaller batches respecting domain limits.

Links and References

Discussion