---
title: "Update rank tracking settings"
method: PATCH
path: "/v3/rank-tracking/settings"
tags: ["Rank Tracking"]
---

# Update rank tracking settings

`PATCH /v3/rank-tracking/settings`

## Request

- Base URL: `https://api.snowseo.com`
- URL: `https://api.snowseo.com/v3/rank-tracking/settings`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Sets how often a brand's tracked keywords are checked on Google (`interval` in days) and how many results each check reads (`resultDepth`: 10, 20, 30, 50 or 100). Each check costs 1 credit per 10 results, so deeper and more frequent checks use more credits. Pass null to return either to its default. Only plans billed in credits accept these; read rank_tracking_settings first.

## Request body

- object
  - `teamId` string, required
  - `interval` integer, nullable
  - `resultDepth` integer, nullable

## Response `200`

Default Response

- object
  - `billing` 'allowance' | 'credits'
  - `keywordLimit` integer, nullable
  - `intervalPickable` boolean
  - `planFloor` integer
  - `defaultInterval` integer
  - `allowedIntervals` integer[]
  - `customInterval` integer, nullable
  - `effectiveInterval` integer
  - `resultDepth` integer, nullable
  - `customResultDepth` integer, nullable
  - `resultDepthOptions` object[]
    - `depth` integer
    - `creditsPerCheck` integer
  - `creditsPerCheck` integer
  - `trackedKeywords` integer

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `500`: Default Response
- `503`: Default Response

## Changes

- **2026-11-17** `862756363a22`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/rank-tracking/settings/patch.md)

---

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