---
title: "List Tracked Keywords Ep"
method: GET
path: "/sites/{site_id}/tracked-keywords"
tags: ["sites"]
---

# List Tracked Keywords Ep

`GET /sites/{site_id}/tracked-keywords`

## Request

- Base URL: `https://api.xeorank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xeorank.com/sites/{site_id}/tracked-keywords`
- Auth: API key in header `X-Agent-Key`

List all tracked keywords for a brand.

## Path parameters

- `site_id` string, required

## Query parameters

- `email` string, nullable

## Response `200`

Successful Response

- TrackedKeywordsListResponse
  - `keywords` TrackedKeywordOut[]
    - `id` string, uuid, required
    - `keyword` string, required
    - `search_volume` integer, nullable
    - `keyword_difficulty` integer, nullable
    - `current_position` integer, nullable
    - `ranking_url` string, nullable
    - `ranking_location_code` integer, nullable
    - `ranking_location_name` string
    - `ranking_location_type` string
    - `ranking_search_engine` string
    - `ranking_language_code` string
    - `ranking_device` string
    - `cpc` number, nullable
    - `competition` number, nullable
    - `last_checked_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `intent` string, nullable
    - `funnel_stage` string, nullable
    - `cluster_name` string, nullable
    - `source` string, nullable
    - `notes` string, nullable
    - `classified_at` string, date-time, nullable
    - `position_context` string, nullable
    - `checked_days_ago` integer, nullable
  - `count` integer
  - `location_code` integer, nullable
  - `ranking_config` RankingConfig, required
    - `location_code` integer, nullable
    - `location_name` string
    - `location_type` string
    - `search_engine` 'google'
    - `language_code` string
    - `device` 'desktop' | 'mobile'
  - `brand_profile` object, nullable
  - `placeholder_keywords` string[]
  - `last_check` RankCheckRunOut: The last rank-check run for a brand — the status a poller reads.
    - `run_id` string, required
    - `status` string, required
    - `mode` string
    - `started_at` string, date-time, nullable
    - `finished_at` string, date-time, nullable
    - `age_seconds` integer, nullable
    - `keyword_count` integer
    - `checked` integer
    - `not_ranking` integer
    - `failed` integer
    - `error` string, nullable
    - `errors` string[]
    - `location` string, nullable
    - `next_step` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xeorank/apis/seo-intelligence-engine.md) · [All operations](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/revisions/449a3fd73454?raw)