Historical Keyword Rankings by Domain

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

DataForSEO

Historical Keyword Rankings by Domain

Review a domain’s historical Google ranking distribution and estimated search traffic. Install with a one-line Skill; pay per run.

You receive

A month-by-month view of the website's Google ranking positions, estimated visits from regular search results, and any ad results returned. Traffic figures are estimates, not actual site visits.

Start with your task

Check [website link] in [country or region] and [language] from [start month and year] to [end month and year]. Summarize monthly Google rankings and estimated search visits, with regular results and ads shown separately. Use the names and dates I give you; ask if anything is unclear.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
request`request`	`object`	Required	Required fields `target, location_code, language_code, date_from, date_to`
target`request.target`	`string`	Required	Minimum length `1` Maximum length `256`
date_to`request.date_to`	`string`	Required	Minimum length `1` Maximum length `256`
date_from`request.date_from`	`string`	Required	Minimum length `1` Maximum length `256`
language_code`request.language_code`	`string`	Required	Minimum length `1` Maximum length `256`
location_code`request.location_code`	`integer`	Required	Minimum `1` Maximum `100000000`

View raw JSON

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "target",
        "location_code",
        "language_code",
        "date_from",
        "date_to"
      ],
      "properties": {
        "target": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "date_to": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "date_from": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "language_code": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "location_code": {
          "type": "integer",
          "maximum": 100000000,
          "minimum": 1
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Review a domain’s historical Google ranking distribution and estimated search traffic. Install with a one-line Skill; pay per run.

See a website's monthly changes
Check [https://example.com] in [United States] for [English] from [January 2025] to [June 2025]. Summarize how often the site appeared near the top or lower in Google’s regular results each month, along with estimated visits from search.
Get connected
Compare two points in time
Compare [January 2024] with [December 2024] for [https://example.com] in [United States] and [English]. Explain how often the site appeared among Google's first 10 non-ad search results and how estimated monthly visits changed.
Check [website link] in [country or region] and [language] from [start month and year] to [end month and year]. Summarize monthly Google rankings and estimated search visits, with regular results and ads shown separately. Use the names and dates I give you; ask if anything is unclear.
See regular results and ads
Review [https://example.com] in [United States] for [English] from [October 2023] to [September 2024]. Compare Google results that are not ads with ads, and summarize the main monthly changes in plain language.

You receive

Start with your task

Inputs & outputs

Input schema

Result schema

See a website's monthly changes

Compare two points in time

See regular results and ads