Actions29
- Backlink Actions
- SERP Actions
- Business Data Actions
- On Page Actions
- Keywords Data Actions
- Labs Actions
Overview
The "Get Referring Domains" operation of the Backlink resource in this node fetches data about domains that link back to a specified target domain, subdomain, or URL. This is useful for SEO professionals and digital marketers who want to analyze backlink profiles, understand their website's authority, monitor competitors' referring domains, or identify potential link-building opportunities.
Practical examples include:
- Retrieving a list of all domains linking to your website to assess backlink quality.
- Monitoring lost or live backlinks to maintain or improve search engine rankings.
- Filtering referring domains by status or other criteria to focus on relevant links.
Properties
| Name | Meaning |
|---|---|
| Target (Domain, Subdomain, URL) | The domain, subdomain, or specific webpage URL for which to retrieve referring domain data. Domains/subdomains should be specified without https:// or www.; pages require full absolute URLs including protocol (http:// or https://). |
| Limit (up to 1000) | Maximum number of referring domain results to return, with a cap at 1000. |
| Offset | Number of results to skip before starting to collect the output, useful for pagination. |
| Backlink Status | Filter referring domains based on backlink status: All, Live, or Lost. Defaults to Live. |
| Include Subdomains | Whether to include backlinks from subdomains of the target domain. Boolean value (true or false). |
| Include Indirect Links | Whether to include indirect backlinks (links that are not direct but still contribute). Boolean value. |
| Exclude Internal Links | Whether to exclude internal backlinks (links originating from the same domain as the target). Boolean value. |
| Filters | JSON string representing an array of filtering parameters to refine the results further. Users can refer to the external documentation for supported filters. |
| Internal List Limit (up to 1000) | Limits the number of internal list items returned, up to 1000. |
| Sort | Up to three sorting rules can be applied. Each rule consists of a field name (string) and direction (Ascending or Descending). Supported fields are documented externally. |
| Backlinks Filters | JSON string representing additional filtering parameters specifically for backlinks. Refer to external documentation for details. |
Output
The node outputs an array of JSON objects representing referring domains matching the query parameters. Each object typically contains detailed information about a referring domain such as domain name, backlink counts, status, and other SEO metrics related to backlinks.
If binary data were involved (not indicated here), it would represent downloadable content or files related to the backlinks, but this operation focuses on JSON data output.
Dependencies
- Requires an active API key credential for the DataForSEO service.
- The node sends POST requests to the DataForSEO API endpoint at
https://api.dataforseo.com/v3. - Proper configuration of the API key credential within n8n is necessary for authentication.
Troubleshooting
Common issues:
- Invalid or missing target parameter format (e.g., including
https://when only domain is expected). - Exceeding the maximum limit of 1000 results.
- Incorrect JSON formatting in the
FiltersorBacklinks Filtersproperties. - Network or authentication errors due to invalid API credentials.
- Invalid or missing target parameter format (e.g., including
Error messages:
"Something went wrong": Generic error if the requested resource-operation combination is not found or misconfigured.- API errors related to authentication or quota limits will be passed through; ensure API keys are valid and usage limits are respected.
Resolutions:
- Verify the target input format matches the expected pattern.
- Use valid JSON strings for filter properties.
- Check API key validity and permissions.
- Adjust limit and offset values within allowed ranges.