DataForSEO icon

DataForSEO

DataForSEO

Actions29

Overview

The node integrates with the DataForSEO API to retrieve backlink summary data for a specified target, which can be a domain, subdomain, or specific URL. It is designed to provide insights into backlinks related to the target, including their status (live, lost, or all), and allows filtering and limiting of results.

This node is beneficial for SEO professionals and digital marketers who want to analyze backlink profiles to monitor link health, identify lost links, or understand the backlink landscape of competitors or their own websites.

Practical examples:

  • Getting a summary of live backlinks pointing to a client's website to assess current link-building effectiveness.
  • Monitoring lost backlinks over time to identify potential issues or negative SEO attacks.
  • Filtering backlinks by specific criteria to focus on high-quality or relevant links.

Properties

Name Meaning
Target (Domain, Subdomain, URL) The domain, subdomain, or webpage URL for which backlink data is requested. Domains/subdomains should be specified without https:// or www.; pages require full absolute URLs including protocol (http:// or https://).
Backlink Status Filters backlinks by their status. Options are: All (all backlinks), Live (currently active backlinks), and Lost (backlinks that have been lost).
Include Subdomains Boolean flag indicating whether backlinks from subdomains should be included in the results.
Include Indirect Links Boolean flag indicating whether indirect backlinks (e.g., links through redirects or intermediate pages) should be included.
Internal List Limit (up to 1000) Limits the number of internal backlink entries returned, up to a maximum of 1000. Default is 10.
Backlinks Filters A string representing an array of filtering parameters to refine backlink results. Users can apply advanced filters as documented in the DataForSEO API documentation.

Output

The node outputs an array of JSON objects representing backlink summary data for the specified target. Each object contains detailed backlink metrics and attributes according to the DataForSEO API response schema for backlink summaries.

If binary data were involved (not indicated here), it would typically represent downloadable reports or files, but this node focuses on JSON backlink summary data only.

Dependencies

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

Troubleshooting

  • Common issues:

    • Invalid or missing target parameter format (e.g., including https:// when not required for domains).
    • Exceeding API rate limits or quota restrictions imposed by DataForSEO.
    • Incorrect or expired API credentials leading to authentication errors.
    • Providing invalid filter syntax in the "Backlinks Filters" property.

  • Error messages and resolutions:

    • "Something went wrong": Generic error if the operation or resource mapping fails internally; ensure correct Resource and Operation selections.
    • API authentication errors: Verify API key validity and permissions.
    • Validation errors from the API about input parameters: Check the formatting of the target and filters.
    • Network or timeout errors: Confirm internet connectivity and DataForSEO service availability.

Links and References

Discussion