Get URL Organic Keywords

Get the organic keywords a specific page (URL) ranks for — with position, search volume, CPC, traffic share, and keyword difficulty. Semrush requires a Markifact connection using an API key from a Semrush Business or Enterprise subscription.


App	SEMrush
Operation ID	`semrush_get_url_organic_keywords`
Type	Action
Connection	`semrush` (required)
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`url`	string	Yes	-	The landing page URL to pull organic keywords for (e.g. `https://example.com/page`).
`database`	string	No	`us`	Regional database (country code). E.g. us, uk, ca, au, de, fr, es, it, br. Defaults to ‘us’.
`export_columns`	array of string or SelectableOption	No	-	List of columns to return. Available: Ph (keyword), Po (position), Pp (previous position), Nq (search volume), Cp (CPC), Co (competition), Kd (keyword difficulty), Tr (traffic %), Tg (traffic generation), Tc (traffic cost %), Nr (SERP results), Td (trends), Fk (keyword SERP features), Fp (result SERP features), In (search intent).
`filters`	array of FilterItem	No	-	Filters to refine results, applied on the returned columns.
`orders`	array of OrderItem	No	-	Sort results by a single column. Only Po, Tg, Tr, Tc, and Nq are sortable.
`limit`	integer	No	-	Maximum number of rows to return.

Field	Type	Required	Default	Description
`field`	string or SelectableOption	Yes	-	The field to filter on, must be one of the current selected metrics or dimensions.
`operator`	string	Yes	-	The operator to use for filtering. Must be one of the supported values. Use REGEXP_MATCH to search/filter by multiple OR values like ’.(summer\|holiday).’
`value`	string	Yes	-	The value to filter by. Can be a string, number, regex, or a list of strings.

OrderItem

Field	Type	Required	Default	Description
`field`	string or SelectableOption	Yes	-	The field to sort by. must be one of the current selected metrics or dimensions.
`direction`	string	Yes	-	The order to sort by, must be one of ‘ASC’, ‘DESC’

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: List[Dict] Returns one row per keyword the URL ranks for with: keyword, position, searchVolume, cpc, competition, trafficPercent, trafficCostPercent, serpResults, keywordDifficulty. Fields: keyword, position, searchVolume, cpc, competition, trafficPercent, trafficCostPercent, serpResults, keywordDifficulty Example:

[
  {
    "keyword": "what is seo",
    "position": 3,
    "searchVolume": 49500,
    "cpc": 4.2,
    "trafficPercent": 18.6,
    "keywordDifficulty": 81
  }
]

Get Started

Guides

Operations

Get URL Organic Keywords

Inputs

FilterItem

OrderItem

SelectableOption

Output

​Inputs

​FilterItem

​OrderItem

​SelectableOption

​Output

Inputs

FilterItem

OrderItem

SelectableOption

Output