dataforseo_labs_google_historical_serp

Analyze historical Google SERPs by retrieving search engine results data, featured snippets, and ranking dynamics for specific keywords and locations over time.

Instructions

This endpoint will provide you with Google SERPs collected within the specified time frame. You will also receive a complete overview of featured snippets and other extra elements that were present within the specified dates. The data will allow you to analyze the dynamics of keyword rankings over time for the specified keyword and location.

Input Schema

Name	Required	Description	Default
`keyword`	Yes	target keyword
`language_code`	No	language code required field example: en	en
`location_name`	No	full name of the location required field in format "Country" example: United Kingdom	United States

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "keyword": {
      "description": "target keyword",
      "type": "string"
    },
    "language_code": {
      "default": "en",
      "description": "language code\n        required field\n        example:\n        en",
      "type": "string"
    },
    "location_name": {
      "default": "United States",
      "description": "full name of the location\nrequired field\nin format \"Country\"\nexample:\nUnited Kingdom",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "type": "object"
}

DataForSEO MCP Server