Skip to main content
Glama

Get ranked keywords

get_ranked_keywords
Read-only

Returns market-specific keyword, URL, rank, search volume, CPC, intent, and traffic rows for a domain or page. Accepts country-level DataForSEO Labs location/language codes. Use this for strategy evidence; use get_domain_overview for aggregate domain footprint.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum rows to return (1-100). Defaults to 50.
marketNoLegacy US selector. Prefer locationCode/languageCode for any Labs market. Explicit locationCode takes precedence; otherwise omitted = the project's default market.
offsetNoRows to skip for pagination.
sortByNoSort order for returned rows. Defaults to search_volume.
targetYesDomain (no protocol/www) or absolute page URL to list ranked keywords for.
maxRankNoOnly return keywords ranking at this position or better.
projectIdYesRequired. The HarborRank project ID to scope this call to. Get one from list_projects.
resultTypesNoSERP result types to include. Defaults to organic and paid.
languageCodeNoLanguage for locationCode. Defaults to that location's primary language when locationCode overrides the project market.
locationCodeNoCountry-level DataForSEO Labs location code. Defaults to the project's market; takes precedence over the legacy market object.
minSearchVolumeNoOnly return keywords with at least this monthly search volume.
excludeBrandTermsNoExclude keywords containing any of these brand terms.
includeSubdomainsNoInclude subdomains of the target. Defaults to true for domains, false for page URLs.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
metaNo
keywordsYes
totalCountYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.