dataforseo_labs_bulk_keyword_difficulty

Analyze the ranking difficulty of up to 1,000 keywords simultaneously to assess the likelihood of achieving top-10 organic search results for targeted terms.

Instructions

This endpoint will provide you with the Keyword Difficulty metric for a maximum of 1,000 keywords in one API request. Keyword Difficulty stands for the relative difficulty of ranking in the first top-10 organic results for the related keyword. Keyword Difficulty in DataForSEO API responses indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100.

Input Schema

Name	Required	Description	Default
`keywords`	Yes	target keywords required field UTF-8 encoding maximum number of keywords you can specify in this array: 1000
`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": "target keywords\nrequired field\nUTF-8 encoding\nmaximum number of keywords you can specify in this array: 1000",
      "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