Get ranked keywords
get_ranked_keywordsRead-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
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (1-100). Defaults to 50. | |
| market | No | Legacy US selector. Prefer locationCode/languageCode for any Labs market. Explicit locationCode takes precedence; otherwise omitted = the project's default market. | |
| offset | No | Rows to skip for pagination. | |
| sortBy | No | Sort order for returned rows. Defaults to search_volume. | |
| target | Yes | Domain (no protocol/www) or absolute page URL to list ranked keywords for. | |
| maxRank | No | Only return keywords ranking at this position or better. | |
| projectId | Yes | Required. The HarborRank project ID to scope this call to. Get one from list_projects. | |
| resultTypes | No | SERP result types to include. Defaults to organic and paid. | |
| languageCode | No | Language for locationCode. Defaults to that location's primary language when locationCode overrides the project market. | |
| locationCode | No | Country-level DataForSEO Labs location code. Defaults to the project's market; takes precedence over the legacy market object. | |
| minSearchVolume | No | Only return keywords with at least this monthly search volume. | |
| excludeBrandTerms | No | Exclude keywords containing any of these brand terms. | |
| includeSubdomains | No | Include subdomains of the target. Defaults to true for domains, false for page URLs. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| keywords | Yes | ||
| totalCount | Yes |