DataForSEO icon

DataForSEO

DataForSEO

Overview

The "Get Domain Rank Overview" operation in the Labs resource of this node fetches an overview of a domain's ranking data. It is useful for SEO professionals and digital marketers who want to analyze how a specific domain performs in search engine rankings across different locations and languages. This operation provides insights into keyword rankings, visibility, and other domain-level SEO metrics.

Practical examples include:

  • Monitoring your own website’s domain rank performance in a target country and language.
  • Comparing competitor domains’ ranking overviews to identify strengths and weaknesses.
  • Tracking changes in domain rank after SEO campaigns or website updates.

Properties

Name Meaning
Target Domain The domain to analyze, specified without the https:// or www. prefix (e.g., example.com).
Location Full name of the location to target the ranking data for (e.g., United Kingdom). This filters the results by geographic region. Supported locations are listed in the external documentation.
Language Full name of the language to filter the ranking data by (e.g., English). Supported languages are listed in the external documentation.
Ignore Synonyms Boolean flag to ignore highly similar keywords. If set to true, only core keywords will be returned, excluding all highly similar keywords.
Limit Number specifying the maximum number of results to return, up to 1000. Defaults to 100.
Offset Number specifying the offset for pagination, starting from 0. Defaults to 0.

Output

The output is a JSON array where each item contains detailed information about the domain's ranking overview. Typical fields may include keyword rankings, search volume, position changes, visibility scores, and other SEO metrics related to the domain's performance.

If binary data were supported, it would represent downloadable reports or raw data files, but this operation primarily returns structured JSON data.

Dependencies

  • Requires an active API key credential for the DataForSEO service.
  • The node makes HTTP POST requests to the DataForSEO API endpoint at https://api.dataforseo.com/v3.
  • Users must ensure that the API key has permissions to access the Labs resource and specifically the domain rank overview operation.
  • Supported locations and languages must be referenced from the official DataForSEO documentation to provide valid input values.

Troubleshooting

  • Invalid domain format: Ensure the target domain does not include https:// or www. prefixes.
  • Unsupported location or language: Verify that the location and language names match those supported by the DataForSEO API; incorrect names may cause errors or empty results.
  • API quota exceeded or authentication errors: Check that the API key is valid, active, and has sufficient quota.
  • Empty or incomplete results: Adjust the limit and offset parameters to paginate through results if the dataset is large.
  • Network or connectivity issues: Confirm network access to the DataForSEO API endpoint.

Common error messages typically indicate invalid parameters, authentication failures, or rate limiting. Resolving these involves correcting input values, renewing credentials, or waiting before retrying.

Links and References

Discussion