Google Historical Rank Overview Live

{
  "$defs": {
    "DataforseoLabsGoogleHistoricalRankOverviewLiveRequestInfo": {
      "properties": {
        "correlate": {
          "anyOf": [
            {
              "description": "correlate data with previously obtained datasetsoptional fielddefault value: trueif you use this parameter, our system will correlate data you obtain now with previously obtained datasetsthis parameter is intended to mitigate any inconsistencies that may result from changes to our databasewe recommend always setting correlate to true",
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "date_from": {
          "anyOf": [
            {
              "description": "starting date of the time rangeoptional fieldif you don't specify this field, the data will be provided for the previous 6 monthsminimal possible value: 2020-10-01date format: \"yyyy-mm-dd\"",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "date_to": {
          "anyOf": [
            {
              "description": "ending date of the time rangeoptional fieldif you don't specify this field, the today's date will be used by defaultdate format: \"yyyy-mm-dd\"example:\"2021-04-01\"",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "ignore_synonyms": {
          "anyOf": [
            {
              "description": "ignore highly similar keywordsoptional fieldif set to true, only data based on core keywords will be returned, data for all highly similar keywords will be excluded; default value: false",
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "include_clickstream_data": {
          "anyOf": [
            {
              "description": "include or exclude data from clickstream-based metrics in the resultoptional fieldif the parameter is set to true, you will receive clickstream_etv, clickstream_gender_distribution, and clickstream_age_distribution fields with clickstream data in the response;default value: false;Note: historical clickstream data is available from 2024/05 (May, 2024);with this parameter enabled, you will be charged double the price for the request;learn more about how clickstream-based metrics are calculated in",
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "language_code": {
          "anyOf": [
            {
              "description": "language coderequired field if you don't specify language_nameNote: it is required to specify either language_name or language_codeyou can receive the list of available locations with their language_code by making a separate request to the",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "language_name": {
          "description": "full name of the languagerequired field if you don't specify language_codeNote: it is required to specify either language_name or language_codeyou can receive the list of available locations with their language_name by making a separate request to the",
          "type": "string"
        },
        "location_code": {
          "description": "location coderequired field if you don't specify location_nameNote: it is required to specify either location_name or location_codeyou can receive the list of available locations with their location_code by making a separate request to the",
          "type": "integer"
        },
        "location_name": {
          "description": "full name of the locationrequired field if you don't specify location_codeNote: it is required to specify either location_name or location_codeyou can receive the list of available locations with their location_name by making a separate request to the Kingdom",
          "type": "string"
        },
        "tag": {
          "anyOf": [
            {
              "description": "user-defined task identifieroptional fieldthe character limit is 255you can use this parameter to identify the task and match it with the resultyou will find the specified tag value in the data object of the response",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "target": {
          "description": "domainrequired fieldthe domain name of the target websitethe domain should be specified without and www.",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "body": {
      "items": {
        "anyOf": [
          {
            "oneOf": [
              {
                "$ref": "#/$defs/DataforseoLabsGoogleHistoricalRankOverviewLiveRequestInfo"
              }
            ],
            "type": "object"
          },
          {
            "type": "null"
          }
        ]
      },
      "type": "array"
    }
  },
  "required": [],
  "type": "object"
}