SE Ranking · Schema

SE Ranking Keyword Research Result

Keyword data returned from SE Ranking keyword research endpoints including search volume, difficulty, CPC, and SERP features.

SEOKeyword ResearchRank TrackingBacklinksCompetitor AnalysisWebsite AuditAI SearchGEODigital Marketing

Properties

Name	Type	Description
keyword	string	The search query term.
volume	integer	Average monthly search volume for the keyword.
difficulty	integer	Keyword difficulty score 0-100 estimating ranking competition.
cpc	number	Cost Per Click in USD for paid search ads targeting this keyword.
competition	number	Paid search competition level between 0 and 1.
intents	array	Search intent classifications for the keyword.
serp_features	array	SERP features present for this keyword such as featured snippets, local packs, image carousels.
trend	array	Monthly search volume trend data for the last 12 months.
country_code	string	ISO 3166-1 alpha-2 country code for the data region.
region_id	integer	SE Ranking internal region identifier.
keyword_count	integer	Number of words in the keyword phrase.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/se-ranking/main/json-schema/se-ranking-keyword-research.json",
  "title": "SE Ranking Keyword Research Result",
  "description": "Keyword data returned from SE Ranking keyword research endpoints including search volume, difficulty, CPC, and SERP features.",
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "description": "The search query term."
    },
    "volume": {
      "type": "integer",
      "description": "Average monthly search volume for the keyword.",
      "minimum": 0
    },
    "difficulty": {
      "type": "integer",
      "description": "Keyword difficulty score 0-100 estimating ranking competition.",
      "minimum": 0,
      "maximum": 100
    },
    "cpc": {
      "type": "number",
      "description": "Cost Per Click in USD for paid search ads targeting this keyword.",
      "minimum": 0
    },
    "competition": {
      "type": "number",
      "description": "Paid search competition level between 0 and 1.",
      "minimum": 0,
      "maximum": 1
    },
    "intents": {
      "type": "array",
      "description": "Search intent classifications for the keyword.",
      "items": {
        "type": "string",
        "enum": ["informational", "navigational", "commercial", "transactional"]
      }
    },
    "serp_features": {
      "type": "array",
      "description": "SERP features present for this keyword such as featured snippets, local packs, image carousels.",
      "items": {
        "type": "string"
      }
    },
    "trend": {
      "type": "array",
      "description": "Monthly search volume trend data for the last 12 months.",
      "items": {
        "type": "integer",
        "minimum": 0
      },
      "maxItems": 12
    },
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code for the data region.",
      "pattern": "^[A-Z]{2}$"
    },
    "region_id": {
      "type": "integer",
      "description": "SE Ranking internal region identifier."
    },
    "keyword_count": {
      "type": "integer",
      "description": "Number of words in the keyword phrase.",
      "minimum": 1
    }
  },
  "required": ["keyword"]
}