---
title: "Keywords a domain ranks for"
method: POST
path: "/v1/data/seo/ranked-keywords"
tags: ["SEO: Competitors", "SEO: Keywords"]
---

# Keywords a domain ranks for

`POST /v1/data/seo/ranked-keywords`

## Request

- Base URL: `https://api.superagnt.com`
- URL: `https://api.superagnt.com/v1/data/seo/ranked-keywords`
- Auth: API key in header `Authorization`

Returns the keywords a domain (or a specific page) currently ranks for in Google, with position, search volume, and the ranked URL. The core competitor research call: point it at any domain to see its organic footprint. Cost scales with rows, so keep `limit` at the default 100 and use `filters` (e.g. position <= 20) instead of pulling thousands of rows. Row shape: items[].keyword_data.keyword_info.search_volume, items[].keyword_data.keyword_properties.keyword_difficulty, items[].ranked_serp_element.serp_item.rank_absolute.

## Request body

- object
  - `target` string, required: Domain (e.g. 'example.com', no protocol) or full page URL to analyze.
  - `location_code` integer: Geo target as a location code. Default 2840 (United States).
  - `language_code` string: Two-letter language code. Default 'en'.
  - `limit` integer: Max keywords to return. Default 100. Cost scales with rows.
  - `offset` integer: Pagination offset.
  - `filters` unknown[]: Optional filter expression, e.g. [["ranked_serp_element.serp_item.rank_absolute", "<=", 20]].
    - unknown
  - `order_by` string[]: Sort rules, e.g. ["keyword_data.keyword_info.search_volume,desc"].

## Response `200`

Ranked keywords with positions and volumes in `result[0].items`.

- object

## Other responses

- `400`: Bad request or upstream task error.
- `401`: Unauthorized.
- `429`: Too many requests.
- `5XX`: Upstream error.

---

[API](https://skmtc.dev/superagnt/apis/superagnt-api.md) · [All operations](https://skmtc.dev/superagnt/apis/superagnt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superagnt/apis/superagnt-api/revisions/b2d8de30ccf0?raw)