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

# Get rank tracking settings

`GET /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`

Returns how a brand's keyword rank checks are billed and scheduled: either a plan slot limit with free checks, or credits per check by result depth (10, 20, 30, 50 or 100 results, 1 credit per 10). Also returns the refresh cadence in days, the cadences the plan allows, and the brand's own choices. Use before changing them with update_rank_tracking_settings.

## Query parameters

- `teamId` string, required

## 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/get.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)
