Actions28
- Backlink Actions
- SERP Actions
- Business Data Actions
- On Page Actions
- Keywords Data Actions
- Labs Actions
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 in SEO analysis workflows where understanding backlink profiles is crucial. For example, digital marketers can use it to monitor the health of backlinks, identify lost links, or analyze backlink distribution across subdomains and indirect links.
Practical examples:
- Fetching a summary of live backlinks for a client’s website domain to assess current link-building effectiveness.
- Retrieving backlink summaries including lost links to investigate potential drops in search rankings.
- Limiting the number of backlinks returned to focus on the most relevant or recent links.
Properties
| Name | Meaning |
|---|---|
| Target (Domain, Subdomain, URL) | The domain, subdomain, or webpage URL to get backlink summary data for. Domains/subdomains should be specified without https:// or www.; pages require full absolute URLs including http:// or https://. |
| Backlink Status | Filter backlinks by their status. Options: All (all backlinks), Live (currently active backlinks), Lost (backlinks that are no longer active). |
| Include Subdomains | Boolean flag to include backlinks from subdomains of the target. |
| Include Indirect Links | Boolean flag to include indirect backlinks (links that may not directly point to the target but are related). |
| Internal List Limit (up to 1000) | Limits the number of internal backlink list results returned, with a maximum of 1000. Default is 10. |
| Backlinks Filters | A string representing an array of filtering parameters to refine backlink results. Users can apply various filters as documented in the DataForSEO API documentation here. |
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 as provided by the DataForSEO API, such as counts of live and lost backlinks, referring domains, and other backlink-related statistics.
If binary data were involved (not indicated here), it would typically represent downloadable reports or files, but this operation focuses on JSON data output.
Dependencies
- Requires an active DataForSEO API account with valid API credentials (API key/token).
- The node expects these credentials to be configured within n8n under the appropriate credential type for authentication.
- Internet access to reach the DataForSEO API endpoint at
https://api.dataforseo.com/v3.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Incorrectly formatted target strings (e.g., including
https://when only domain is expected) may lead to errors or empty results. - Exceeding the internal list limit beyond 1000 will likely result in validation errors.
- Improperly formatted filters in the
Backlinks Filtersproperty may cause the API to reject the request.
Error messages:
"Something went wrong": Generic error indicating failure during execution, possibly due to network issues, invalid parameters, or API errors. Check input parameters and API credentials.- Credential-related errors: Ensure the API key/token is correctly set up in n8n credentials.
- Validation errors from the API: Review the format and values of input properties, especially filters and target formatting.