Find SERP competitors
find_serp_competitorsRead-only
Compares domains competing in Google results for a supplied keyword set in a country-level DataForSEO Labs market. Accepts location/language codes; not radius-based local SEO.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum competitors 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 competitors. Defaults to visibility. | |
| keywords | Yes | Keywords whose SERPs are compared (1-100). | |
| 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 local_pack. | |
| 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. | |
| excludeDomains | No | Domains to exclude from results (e.g. the user's own site). | |
| includeSubdomains | No | Count subdomains as part of the same competitor domain. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| competitors | Yes |