AHahrefs
Competitive Analysis

Content gap

Changed on

Compare organic and paid keyword rankings for a target and its competitors. Use where to find keyword gaps.

post/competitive-analysis/content-gap

Request

  • Base URL
    https://api.ahrefs.com/v3
  • URL
    https://api.ahrefs.com/v3/competitive-analysis/content-gap
  • Auth
    HTTP bearer

Request body

selectstring[] required

A list of columns to return. See response schema for valid column identifiers.

whereobject

The filter expression. The following column identifiers are recognized (this differs from the identifiers recognized by the select parameter).

competitor_1.paid_position: The best paid ranking position for competitor 1.
type: integer nullable

competitor_1.paid_position_kind: The kind of the best paid position for competitor 1.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_1.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 1.
type: integer nullable

competitor_1.paid_url: The best-ranking paid URL for competitor 1.
type: url nullable

competitor_1.position: The best organic ranking position for competitor 1.
type: integer nullable

competitor_1.position_kind: The kind of the best organic position for competitor 1.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_1.traffic (10 units): The estimated organic traffic from the keyword for competitor 1.
type: integer nullable

competitor_1.url: The best-ranking organic URL for competitor 1.
type: url nullable

competitor_2.paid_position: The best paid ranking position for competitor 2.
type: integer nullable

competitor_2.paid_position_kind: The kind of the best paid position for competitor 2.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_2.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 2.
type: integer nullable

competitor_2.paid_url: The best-ranking paid URL for competitor 2.
type: url nullable

competitor_2.position: The best organic ranking position for competitor 2.
type: integer nullable

competitor_2.position_kind: The kind of the best organic position for competitor 2.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_2.traffic (10 units): The estimated organic traffic from the keyword for competitor 2.
type: integer nullable

competitor_2.url: The best-ranking organic URL for competitor 2.
type: url nullable

competitor_3.paid_position: The best paid ranking position for competitor 3.
type: integer nullable

competitor_3.paid_position_kind: The kind of the best paid position for competitor 3.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_3.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 3.
type: integer nullable

competitor_3.paid_url: The best-ranking paid URL for competitor 3.
type: url nullable

competitor_3.position: The best organic ranking position for competitor 3.
type: integer nullable

competitor_3.position_kind: The kind of the best organic position for competitor 3.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_3.traffic (10 units): The estimated organic traffic from the keyword for competitor 3.
type: integer nullable

competitor_3.url: The best-ranking organic URL for competitor 3.
type: url nullable

competitor_4.paid_position: The best paid ranking position for competitor 4.
type: integer nullable

competitor_4.paid_position_kind: The kind of the best paid position for competitor 4.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_4.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 4.
type: integer nullable

competitor_4.paid_url: The best-ranking paid URL for competitor 4.
type: url nullable

competitor_4.position: The best organic ranking position for competitor 4.
type: integer nullable

competitor_4.position_kind: The kind of the best organic position for competitor 4.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_4.traffic (10 units): The estimated organic traffic from the keyword for competitor 4.
type: integer nullable

competitor_4.url: The best-ranking organic URL for competitor 4.
type: url nullable

competitor_5.paid_position: The best paid ranking position for competitor 5.
type: integer nullable

competitor_5.paid_position_kind: The kind of the best paid position for competitor 5.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_5.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 5.
type: integer nullable

competitor_5.paid_url: The best-ranking paid URL for competitor 5.
type: url nullable

competitor_5.position: The best organic ranking position for competitor 5.
type: integer nullable

competitor_5.position_kind: The kind of the best organic position for competitor 5.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_5.traffic (10 units): The estimated organic traffic from the keyword for competitor 5.
type: integer nullable

competitor_5.url: The best-ranking organic URL for competitor 5.
type: url nullable

competitor_6.paid_position: The best paid ranking position for competitor 6.
type: integer nullable

competitor_6.paid_position_kind: The kind of the best paid position for competitor 6.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_6.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 6.
type: integer nullable

competitor_6.paid_url: The best-ranking paid URL for competitor 6.
type: url nullable

competitor_6.position: The best organic ranking position for competitor 6.
type: integer nullable

competitor_6.position_kind: The kind of the best organic position for competitor 6.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_6.traffic (10 units): The estimated organic traffic from the keyword for competitor 6.
type: integer nullable

competitor_6.url: The best-ranking organic URL for competitor 6.
type: url nullable

competitor_7.paid_position: The best paid ranking position for competitor 7.
type: integer nullable

competitor_7.paid_position_kind: The kind of the best paid position for competitor 7.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_7.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 7.
type: integer nullable

competitor_7.paid_url: The best-ranking paid URL for competitor 7.
type: url nullable

competitor_7.position: The best organic ranking position for competitor 7.
type: integer nullable

competitor_7.position_kind: The kind of the best organic position for competitor 7.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_7.traffic (10 units): The estimated organic traffic from the keyword for competitor 7.
type: integer nullable

competitor_7.url: The best-ranking organic URL for competitor 7.
type: url nullable

competitor_8.paid_position: The best paid ranking position for competitor 8.
type: integer nullable

competitor_8.paid_position_kind: The kind of the best paid position for competitor 8.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_8.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 8.
type: integer nullable

competitor_8.paid_url: The best-ranking paid URL for competitor 8.
type: url nullable

competitor_8.position: The best organic ranking position for competitor 8.
type: integer nullable

competitor_8.position_kind: The kind of the best organic position for competitor 8.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_8.traffic (10 units): The estimated organic traffic from the keyword for competitor 8.
type: integer nullable

competitor_8.url: The best-ranking organic URL for competitor 8.
type: url nullable

competitor_9.paid_position: The best paid ranking position for competitor 9.
type: integer nullable

competitor_9.paid_position_kind: The kind of the best paid position for competitor 9.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_9.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 9.
type: integer nullable

competitor_9.paid_url: The best-ranking paid URL for competitor 9.
type: url nullable

competitor_9.position: The best organic ranking position for competitor 9.
type: integer nullable

competitor_9.position_kind: The kind of the best organic position for competitor 9.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_9.traffic (10 units): The estimated organic traffic from the keyword for competitor 9.
type: integer nullable

competitor_9.url: The best-ranking organic URL for competitor 9.
type: url nullable

competitor_10.paid_position: The best paid ranking position for competitor 10.
type: integer nullable

competitor_10.paid_position_kind: The kind of the best paid position for competitor 10.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_10.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 10.
type: integer nullable

competitor_10.paid_url: The best-ranking paid URL for competitor 10.
type: url nullable

competitor_10.position: The best organic ranking position for competitor 10.
type: integer nullable

competitor_10.position_kind: The kind of the best organic position for competitor 10.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_10.traffic (10 units): The estimated organic traffic from the keyword for competitor 10.
type: integer nullable

competitor_10.url: The best-ranking organic URL for competitor 10.
type: url nullable

competitor_11.paid_position: The best paid ranking position for competitor 11.
type: integer nullable

competitor_11.paid_position_kind: The kind of the best paid position for competitor 11.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_11.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 11.
type: integer nullable

competitor_11.paid_url: The best-ranking paid URL for competitor 11.
type: url nullable

competitor_11.position: The best organic ranking position for competitor 11.
type: integer nullable

competitor_11.position_kind: The kind of the best organic position for competitor 11.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_11.traffic (10 units): The estimated organic traffic from the keyword for competitor 11.
type: integer nullable

competitor_11.url: The best-ranking organic URL for competitor 11.
type: url nullable

competitor_12.paid_position: The best paid ranking position for competitor 12.
type: integer nullable

competitor_12.paid_position_kind: The kind of the best paid position for competitor 12.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_12.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 12.
type: integer nullable

competitor_12.paid_url: The best-ranking paid URL for competitor 12.
type: url nullable

competitor_12.position: The best organic ranking position for competitor 12.
type: integer nullable

competitor_12.position_kind: The kind of the best organic position for competitor 12.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_12.traffic (10 units): The estimated organic traffic from the keyword for competitor 12.
type: integer nullable

competitor_12.url: The best-ranking organic URL for competitor 12.
type: url nullable

competitor_13.paid_position: The best paid ranking position for competitor 13.
type: integer nullable

competitor_13.paid_position_kind: The kind of the best paid position for competitor 13.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_13.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 13.
type: integer nullable

competitor_13.paid_url: The best-ranking paid URL for competitor 13.
type: url nullable

competitor_13.position: The best organic ranking position for competitor 13.
type: integer nullable

competitor_13.position_kind: The kind of the best organic position for competitor 13.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_13.traffic (10 units): The estimated organic traffic from the keyword for competitor 13.
type: integer nullable

competitor_13.url: The best-ranking organic URL for competitor 13.
type: url nullable

competitor_14.paid_position: The best paid ranking position for competitor 14.
type: integer nullable

competitor_14.paid_position_kind: The kind of the best paid position for competitor 14.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_14.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 14.
type: integer nullable

competitor_14.paid_url: The best-ranking paid URL for competitor 14.
type: url nullable

competitor_14.position: The best organic ranking position for competitor 14.
type: integer nullable

competitor_14.position_kind: The kind of the best organic position for competitor 14.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_14.traffic (10 units): The estimated organic traffic from the keyword for competitor 14.
type: integer nullable

competitor_14.url: The best-ranking organic URL for competitor 14.
type: url nullable

competitor_15.paid_position: The best paid ranking position for competitor 15.
type: integer nullable

competitor_15.paid_position_kind: The kind of the best paid position for competitor 15.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_15.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 15.
type: integer nullable

competitor_15.paid_url: The best-ranking paid URL for competitor 15.
type: url nullable

competitor_15.position: The best organic ranking position for competitor 15.
type: integer nullable

competitor_15.position_kind: The kind of the best organic position for competitor 15.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_15.traffic (10 units): The estimated organic traffic from the keyword for competitor 15.
type: integer nullable

competitor_15.url: The best-ranking organic URL for competitor 15.
type: url nullable

competitor_16.paid_position: The best paid ranking position for competitor 16.
type: integer nullable

competitor_16.paid_position_kind: The kind of the best paid position for competitor 16.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_16.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 16.
type: integer nullable

competitor_16.paid_url: The best-ranking paid URL for competitor 16.
type: url nullable

competitor_16.position: The best organic ranking position for competitor 16.
type: integer nullable

competitor_16.position_kind: The kind of the best organic position for competitor 16.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_16.traffic (10 units): The estimated organic traffic from the keyword for competitor 16.
type: integer nullable

competitor_16.url: The best-ranking organic URL for competitor 16.
type: url nullable

competitor_17.paid_position: The best paid ranking position for competitor 17.
type: integer nullable

competitor_17.paid_position_kind: The kind of the best paid position for competitor 17.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_17.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 17.
type: integer nullable

competitor_17.paid_url: The best-ranking paid URL for competitor 17.
type: url nullable

competitor_17.position: The best organic ranking position for competitor 17.
type: integer nullable

competitor_17.position_kind: The kind of the best organic position for competitor 17.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_17.traffic (10 units): The estimated organic traffic from the keyword for competitor 17.
type: integer nullable

competitor_17.url: The best-ranking organic URL for competitor 17.
type: url nullable

competitor_18.paid_position: The best paid ranking position for competitor 18.
type: integer nullable

competitor_18.paid_position_kind: The kind of the best paid position for competitor 18.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_18.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 18.
type: integer nullable

competitor_18.paid_url: The best-ranking paid URL for competitor 18.
type: url nullable

competitor_18.position: The best organic ranking position for competitor 18.
type: integer nullable

competitor_18.position_kind: The kind of the best organic position for competitor 18.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_18.traffic (10 units): The estimated organic traffic from the keyword for competitor 18.
type: integer nullable

competitor_18.url: The best-ranking organic URL for competitor 18.
type: url nullable

competitor_19.paid_position: The best paid ranking position for competitor 19.
type: integer nullable

competitor_19.paid_position_kind: The kind of the best paid position for competitor 19.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_19.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 19.
type: integer nullable

competitor_19.paid_url: The best-ranking paid URL for competitor 19.
type: url nullable

competitor_19.position: The best organic ranking position for competitor 19.
type: integer nullable

competitor_19.position_kind: The kind of the best organic position for competitor 19.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_19.traffic (10 units): The estimated organic traffic from the keyword for competitor 19.
type: integer nullable

competitor_19.url: The best-ranking organic URL for competitor 19.
type: url nullable

competitor_20.paid_position: The best paid ranking position for competitor 20.
type: integer nullable

competitor_20.paid_position_kind: The kind of the best paid position for competitor 20.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_20.paid_traffic (10 units): The estimated paid traffic from the keyword for competitor 20.
type: integer nullable

competitor_20.paid_url: The best-ranking paid URL for competitor 20.
type: url nullable

competitor_20.position: The best organic ranking position for competitor 20.
type: integer nullable

competitor_20.position_kind: The kind of the best organic position for competitor 20.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

competitor_20.traffic (10 units): The estimated organic traffic from the keyword for competitor 20.
type: integer nullable

competitor_20.url: The best-ranking organic URL for competitor 20.
type: url nullable

competitors_count: The number of competitors with an organic ranking for the keyword.
type: integer

competitors_count_in_range: The number of competitors with an organic ranking within competitor_position_from and competitor_position_to.
type: integer

competitors_paid_bottom_count: The number of competitors appearing in bottom ads.
type: integer

competitors_paid_count: The number of competitors appearing in top or bottom ads.
type: integer

competitors_paid_top_count: The number of competitors appearing in top ads.
type: integer

cpc: Cost Per Click shows the average price that advertisers pay for each ad click in paid search results for a keyword, in USD cents.
type: integer nullable

event_entities: Events found in a keyword.
type: array(string)

intents.branded: User intent: branded. The user is searching for a specific brand or company name.
type: boolean

intents.commercial: User intent: commercial. The user is comparing products or services before making a purchase decision.
type: boolean

intents.informational: User intent: informational. The user is looking for information or an answer to a specific question.
type: boolean

intents.local: User intent: local. The user is looking for information relevant to a specific location or nearby services.
type: boolean

intents.navigational: User intent: navigational. The user is searching for a specific website or web page.
type: boolean

intents.transactional: User intent: transactional. The user is ready to complete an action, often a purchase.
type: boolean

is_main_position: Excludes positions in AI Overviews, Sitelinks, Top stories, Image packs, Videos, Discussions and forums, and posts on X (Twitter).
type: boolean

keyword: The keyword your target ranks for.
type: string

keyword_difficulty (10 units): An estimation of how hard it is to rank in the top 10 organic search results for a keyword on a 100-point scale.
type: integer nullable

language: The SERP language.
type: string

last_update: The date when we last checked search engine results for a keyword.
type: datetime

location_entities: Locations found in a keyword.
type: array(string)

organisation_entities: Organizations found in a keyword.
type: array(string)

person_entities: Persons found in a keyword.
type: array(string)

product_entities: Products found in a keyword.
type: array(string)

serp_features: The SERP features that appear in search results for a keyword.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_features_count: The number of SERP features that appear in search results for a keyword.
type: integer

target.paid_position: The best paid ranking position for the target.
type: integer nullable

target.paid_position_kind: The kind of the best paid position for the target.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

target.paid_traffic (10 units): The estimated paid traffic from the keyword for the target.
type: integer nullable

target.paid_url: The best-ranking paid URL for the target.
type: url nullable

target.position: The best organic ranking position for the target.
type: integer nullable

target.position_has_thumbnail: The top position has a thumbnail.
type: boolean nullable

target.position_has_video: The top position has a video.
type: boolean nullable

target.position_kind: The kind of the best organic position for the target.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

target.traffic (10 units): The estimated organic traffic from the keyword for the target.
type: integer nullable

target.url: The best-ranking organic URL for the target.
type: url nullable

volume (10 units): An estimation of the number of searches for a keyword over the latest month.
type: integer nullable

words: The number of words in a keyword.
type: integer

work_entities: Works found in a keyword.
type: array(string)

order_bystring[]

Columns to order results by, with optional :asc or :desc direction.

  • competitor_1.paid_description
  • competitor_1.paid_display_url
  • competitor_1.paid_position
  • competitor_1.paid_position_kind
  • competitor_1.paid_title
  • competitor_1.paid_traffic
  • competitor_1.paid_url
  • competitor_1.position
  • competitor_1.position_kind
  • competitor_1.traffic
  • competitor_1.url
  • competitor_2.paid_description
  • competitor_2.paid_display_url
  • competitor_2.paid_position
  • competitor_2.paid_position_kind
  • competitor_2.paid_title
  • competitor_2.paid_traffic
  • competitor_2.paid_url
  • competitor_2.position
  • competitor_2.position_kind
  • competitor_2.traffic
  • competitor_2.url
  • competitor_3.paid_description
  • competitor_3.paid_display_url
  • competitor_3.paid_position
  • competitor_3.paid_position_kind
  • competitor_3.paid_title
  • competitor_3.paid_traffic
  • competitor_3.paid_url
  • competitor_3.position
  • competitor_3.position_kind
  • competitor_3.traffic
  • competitor_3.url
  • competitor_4.paid_description
  • competitor_4.paid_display_url
  • competitor_4.paid_position
  • competitor_4.paid_position_kind
  • competitor_4.paid_title
  • competitor_4.paid_traffic
  • competitor_4.paid_url
  • competitor_4.position
  • competitor_4.position_kind
  • competitor_4.traffic
  • competitor_4.url
  • competitor_5.paid_description
  • competitor_5.paid_display_url
  • competitor_5.paid_position
  • competitor_5.paid_position_kind
  • competitor_5.paid_title
  • competitor_5.paid_traffic
  • competitor_5.paid_url
  • competitor_5.position
  • competitor_5.position_kind
  • competitor_5.traffic
  • competitor_5.url
  • competitor_6.paid_description
  • competitor_6.paid_display_url
  • competitor_6.paid_position
  • competitor_6.paid_position_kind
  • competitor_6.paid_title
  • competitor_6.paid_traffic
  • competitor_6.paid_url
  • competitor_6.position
  • competitor_6.position_kind
  • competitor_6.traffic
  • competitor_6.url
  • competitor_7.paid_description
  • competitor_7.paid_display_url
  • competitor_7.paid_position
  • competitor_7.paid_position_kind
  • competitor_7.paid_title
  • competitor_7.paid_traffic
  • competitor_7.paid_url
  • competitor_7.position
  • competitor_7.position_kind
  • competitor_7.traffic
  • competitor_7.url
  • competitor_8.paid_description
  • competitor_8.paid_display_url
  • competitor_8.paid_position
  • competitor_8.paid_position_kind
  • competitor_8.paid_title
  • competitor_8.paid_traffic
  • competitor_8.paid_url
  • competitor_8.position
  • competitor_8.position_kind
  • competitor_8.traffic
  • competitor_8.url
  • competitor_9.paid_description
  • competitor_9.paid_display_url
  • competitor_9.paid_position
  • competitor_9.paid_position_kind
  • competitor_9.paid_title
  • competitor_9.paid_traffic
  • competitor_9.paid_url
  • competitor_9.position
  • competitor_9.position_kind
  • competitor_9.traffic
  • competitor_9.url
  • competitor_10.paid_description
  • competitor_10.paid_display_url
  • competitor_10.paid_position
  • competitor_10.paid_position_kind
  • competitor_10.paid_title
  • competitor_10.paid_traffic
  • competitor_10.paid_url
  • competitor_10.position
  • competitor_10.position_kind
  • competitor_10.traffic
  • competitor_10.url
  • competitor_11.paid_description
  • competitor_11.paid_display_url
  • competitor_11.paid_position
  • competitor_11.paid_position_kind
  • competitor_11.paid_title
  • competitor_11.paid_traffic
  • competitor_11.paid_url
  • competitor_11.position
  • competitor_11.position_kind
  • competitor_11.traffic
  • competitor_11.url
  • competitor_12.paid_description
  • competitor_12.paid_display_url
  • competitor_12.paid_position
  • competitor_12.paid_position_kind
  • competitor_12.paid_title
  • competitor_12.paid_traffic
  • competitor_12.paid_url
  • competitor_12.position
  • competitor_12.position_kind
  • competitor_12.traffic
  • competitor_12.url
  • competitor_13.paid_description
  • competitor_13.paid_display_url
  • competitor_13.paid_position
  • competitor_13.paid_position_kind
  • competitor_13.paid_title
  • competitor_13.paid_traffic
  • competitor_13.paid_url
  • competitor_13.position
  • competitor_13.position_kind
  • competitor_13.traffic
  • competitor_13.url
  • competitor_14.paid_description
  • competitor_14.paid_display_url
  • competitor_14.paid_position
  • competitor_14.paid_position_kind
  • competitor_14.paid_title
  • competitor_14.paid_traffic
  • competitor_14.paid_url
  • competitor_14.position
  • competitor_14.position_kind
  • competitor_14.traffic
  • competitor_14.url
  • competitor_15.paid_description
  • competitor_15.paid_display_url
  • competitor_15.paid_position
  • competitor_15.paid_position_kind
  • competitor_15.paid_title
  • competitor_15.paid_traffic
  • competitor_15.paid_url
  • competitor_15.position
  • competitor_15.position_kind
  • competitor_15.traffic
  • competitor_15.url
  • competitor_16.paid_description
  • competitor_16.paid_display_url
  • competitor_16.paid_position
  • competitor_16.paid_position_kind
  • competitor_16.paid_title
  • competitor_16.paid_traffic
  • competitor_16.paid_url
  • competitor_16.position
  • competitor_16.position_kind
  • competitor_16.traffic
  • competitor_16.url
  • competitor_17.paid_description
  • competitor_17.paid_display_url
  • competitor_17.paid_position
  • competitor_17.paid_position_kind
  • competitor_17.paid_title
  • competitor_17.paid_traffic
  • competitor_17.paid_url
  • competitor_17.position
  • competitor_17.position_kind
  • competitor_17.traffic
  • competitor_17.url
  • competitor_18.paid_description
  • competitor_18.paid_display_url
  • competitor_18.paid_position
  • competitor_18.paid_position_kind
  • competitor_18.paid_title
  • competitor_18.paid_traffic
  • competitor_18.paid_url
  • competitor_18.position
  • competitor_18.position_kind
  • competitor_18.traffic
  • competitor_18.url
  • competitor_19.paid_description
  • competitor_19.paid_display_url
  • competitor_19.paid_position
  • competitor_19.paid_position_kind
  • competitor_19.paid_title
  • competitor_19.paid_traffic
  • competitor_19.paid_url
  • competitor_19.position
  • competitor_19.position_kind
  • competitor_19.traffic
  • competitor_19.url
  • competitor_20.paid_description
  • competitor_20.paid_display_url
  • competitor_20.paid_position
  • competitor_20.paid_position_kind
  • competitor_20.paid_title
  • competitor_20.paid_traffic
  • competitor_20.paid_url
  • competitor_20.position
  • competitor_20.position_kind
  • competitor_20.traffic
  • competitor_20.url
  • competitors_count
  • competitors_count_in_range
  • competitors_paid_bottom_count
  • competitors_paid_count
  • competitors_paid_top_count
  • cpc
  • entities
  • intents.branded
  • intents.commercial
  • intents.informational
  • intents.local
  • intents.navigational
  • intents.transactional
  • keyword
  • keyword_difficulty
  • language
  • last_update
  • serp_features
  • serp_features_count
  • target.paid_description
  • target.paid_display_url
  • target.paid_position
  • target.paid_position_kind
  • target.paid_title
  • target.paid_traffic
  • target.paid_url
  • target.position
  • target.position_has_thumbnail
  • target.position_has_video
  • target.position_kind
  • target.traffic
  • target.url
  • volume
limitinteger

The number of results to return.

timeoutinteger

A manual timeout duration in seconds.

country'ad' | 'ae' | 'af' | 'ag' | 'ai' | 'al' | 'am' | 'ao' | 'ar' | 'as' | 'at' | 'au' | 'aw' | 'az' | 'ba' | 'bb' | 'bd' | 'be' | 'bf' | 'bg' | 'bh' | 'bi' | 'bj' | 'bn' | 'bo' | 'br' | 'bs' | 'bt' | 'bw' | 'by' | 'bz' | 'ca' | 'cd' | 'cf' | 'cg' | 'ch' | 'ci' | 'ck' | 'cl' | 'cm' | 'cn' | 'co' | 'cr' | 'cu' | 'cv' | 'cy' | 'cz' | 'de' | 'dj' | 'dk' | 'dm' | 'do' | 'dz' | 'ec' | 'ee' | 'eg' | 'es' | 'et' | 'fi' | 'fj' | 'fm' | 'fo' | 'fr' | 'ga' | 'gb' | 'gd' | 'ge' | 'gf' | 'gg' | 'gh' | 'gi' | 'gl' | 'gm' | 'gn' | 'gp' | 'gq' | 'gr' | 'gt' | 'gu' | 'gy' | 'hk' | 'hn' | 'hr' | 'ht' | 'hu' | 'id' | 'ie' | 'il' | 'im' | 'in' | 'iq' | 'is' | 'it' | 'je' | 'jm' | 'jo' | 'jp' | 'ke' | 'kg' | 'kh' | 'ki' | 'kn' | 'kr' | 'kw' | 'ky' | 'kz' | 'la' | 'lb' | 'lc' | 'li' | 'lk' | 'ls' | 'lt' | 'lu' | 'lv' | 'ly' | 'ma' | 'mc' | 'md' | 'me' | 'mg' | 'mk' | 'ml' | 'mm' | 'mn' | 'mq' | 'mr' | 'ms' | 'mt' | 'mu' | 'mv' | 'mw' | 'mx' | 'my' | 'mz' | 'na' | 'nc' | 'ne' | 'ng' | 'ni' | 'nl' | 'no' | 'np' | 'nr' | 'nu' | 'nz' | 'om' | 'pa' | 'pe' | 'pf' | 'pg' | 'ph' | 'pk' | 'pl' | 'pn' | 'pr' | 'ps' | 'pt' | 'py' | 'qa' | 're' | 'ro' | 'rs' | 'ru' | 'rw' | 'sa' | 'sb' | 'sc' | 'se' | 'sg' | 'sh' | 'si' | 'sk' | 'sl' | 'sm' | 'sn' | 'so' | 'sr' | 'st' | 'sv' | 'td' | 'tg' | 'th' | 'tj' | 'tk' | 'tl' | 'tm' | 'tn' | 'to' | 'tr' | 'tt' | 'tw' | 'tz' | 'ua' | 'ug' | 'us' | 'uy' | 'uz' | 'vc' | 've' | 'vg' | 'vi' | 'vn' | 'vu' | 'ws' | 'ye' | 'yt' | 'za' | 'zm' | 'zw' required

The country whose search results are analyzed.

datestring date required

A date to report metrics on in YYYY-MM-DD format.

volume_mode'monthly' | 'average'

The search volume calculation mode.

competitor_position_frominteger

The inclusive lower ranking bound used by competitors_count_in_range. Does not restrict other fields.

competitor_position_tointeger

The inclusive upper ranking bound used by competitors_count_in_range. Does not restrict other fields.

output'json' | 'php'

The output format.

Example request

{
  "select": [
    "field_a",
    "field_b"
  ],
  "order_by": [
    "field_a",
    "field_b:asc",
    "field_c:desc"
  ]
}

Response

OK

Changes