dataforseo_labs_google_historical_keyword_data

Analyze Google historical keyword data, including search volume, cost-per-click, competition, and monthly trends since August 2021. Ideal for keyword research and paid search strategy based on location and language.

Instructions

This endpoint provides Google historical keyword data for specified keywords, including search volume, cost-per-click, competition values for paid search, monthly searches, and search volume trends. You can get historical keyword data since August, 2021, depending on keywords along with location and language combination

Input Schema

Name	Required	Description	Default
`keywords`	Yes	keywords required field The maximum number of keywords you can specify: 700 The maximum number of characters for each keyword: 80 The maximum number of words for each keyword phrase: 10 the specified keywords will be converted to lowercase format, data will be provided in a separate array note that if some of the keywords specified in this array are omitted in the results you receive, then our database doesn't contain such keywords and cannot return data on them you will not be charged for the keywords omitted in the results
`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": {
    "keywords": {
      "description": "keywords\nrequired field\nThe maximum number of keywords you can specify: 700\nThe maximum number of characters for each keyword: 80\nThe maximum number of words for each keyword phrase: 10\nthe specified keywords will be converted to lowercase format, data will be provided in a separate array\nnote that if some of the keywords specified in this array are omitted in the results you receive, then our database doesn't contain such keywords and cannot return data on them\nyou will not be charged for the keywords omitted in the results",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "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": [
    "keywords"
  ],
  "type": "object"
}

DataForSEO MCP Server