DataForSEO icon

DataForSEO

DataForSEO

Actions28

Overview

The node integrates with the DataForSEO API to retrieve bulk spam scores for multiple targets such as pages, domains, or subdomains. This operation is useful for SEO professionals and digital marketers who want to assess the spam risk associated with a large list of URLs or domains in one request. It helps identify potentially harmful backlinks or suspicious web properties that could negatively impact search engine rankings.

Typical use cases include:

  • Bulk auditing of backlink profiles to detect spammy links.
  • Monitoring multiple domains or webpages for spam signals.
  • Preparing data for link cleanup or disavow processes.

For example, a user can input up to 1000 URLs or domains and receive spam score metrics for each, enabling efficient large-scale SEO analysis.

Properties

Name Meaning
Targets A collection of up to 1000 targets (pages, domains, or subdomains) to analyze for spam scores. Each target can be:
- A domain or subdomain specified without https:// or www. prefix.
- A full webpage URL including http:// or https://.
Note: All URLs in a single request must not belong to more than 100 different domains.

Output

The node outputs an array of JSON objects where each object corresponds to a target from the input list. Each object contains the spam score data retrieved from the DataForSEO API for that specific target. The exact structure depends on the API response but typically includes fields such as:

  • Target URL or domain
  • Spam score metrics (numerical values indicating spam risk)
  • Additional metadata related to the spam evaluation

The output does not include binary data; it is purely JSON-formatted spam score information.

Dependencies

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

Troubleshooting

  • Error: "Something went wrong"
    This generic error may occur if the API call fails or if the input parameters are invalid. Check that:

    • The "Targets" property is correctly formatted and does not exceed 1000 entries.
    • The URLs/domains follow the required format (domains without protocol and www, pages with full URL).
    • The total number of distinct domains in the request does not exceed 100.
    • The API credentials are valid and have sufficient quota.

  • API Rate Limits or Quota Exceeded
    If the API returns rate limit errors, consider reducing the batch size or upgrading your DataForSEO plan.

  • Invalid URL Format
    Ensure domains do not include protocols or "www." prefixes, and page URLs include the full absolute URL with protocol.

Links and References

Discussion