Get Keyword Rankings - Markifact

Get Google’s top organic results (SERP) for keywords — which domains and URLs rank at which position. Use to check rankings/positions for any keyword, including a specific domain’s position. Semrush requires a Markifact connection using an API key from a Semrush Business or Enterprise subscription.


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

Inputs

Field	Type	Required	Default	Description
`keywords`	array of string or string	Yes	-	Keywords to fetch Google top-100 organic results for. Accepts a list or a newline/comma-separated string. One SERP is fetched per keyword.
`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: Po (position), Pt (position type), Dn (domain), Ur (URL), Fk (keyword SERP features), Fp (SERP features the result appears in).
`positions_type`	string or SelectItem	No	`organic`	’organic’ returns traditional organic positions only; ‘all’ also includes SERP features as positions.
`display_date`	string	No	-	Historical SERP date in YYYYMM15 format (e.g. 20240115). Leave empty for current data. Historical requests cost 5x more API units.
`limit`	integer	No	-	Maximum number of results per keyword (top N positions).

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

SelectableOption

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

Output

Type: List[Dict] Returns one row per ranking result per keyword with: date, keyword, position, domain, url. Fields: date, keyword, position, domain, url Example:

[
  {
    "date": "2026-06-09",
    "keyword": "seo tools",
    "position": 1,
    "domain": "semrush.com",
    "url": "https://www.semrush.com/"
  }
]