---
title: "Add one or more tracked keywords"
method: POST
path: "/v3/rank-tracking/keywords"
tags: ["Rank Tracking"]
---

# Add one or more tracked keywords

`POST /v3/rank-tracking/keywords`

Track one keyword or a batch of keywords for rank monitoring.

## Request body

- object
  - `teamId` string — Team ID
  - `keyword` string — Keyword to track
  - `countryId` string, nullable — Country ID (ISO2) or null for worldwide
  - `languageId` string, nullable — Language ID or null for default
  - `locationCriteriaId` number, nullable — Google Ads location criteria ID for city/region-level tracking (from canonicalcities). Omit/null for country-only.
  - `locationCanonicalName` string, nullable — Canonical location name (e.g. "Austin,Texas,United States"). Should be sent whenever locationCriteriaId is set; if omitted the stored canonical name is null.
  - `items` object[] — Batch of keywords to track
    - `keyword` string, required
    - `countryId` string, nullable
    - `languageId` string, nullable
    - `locationCriteriaId` number, nullable
    - `locationCanonicalName` string, nullable

## Response `200`

Default Response

- object
  - `success` boolean
  - `requested` number
  - `alreadyTracked` number
  - `reactivated` number
  - `created` number

## Other responses

- `400` — Default Response
- `402` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.net/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/versions/b3bb15a00861/schema)