> ## Documentation Index
> Fetch the complete documentation index at: https://snowseo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tracked Keywords Table

> A paginated, filterable table of tracked keywords grouped by keyword.

The tracked-keywords table from the dashboard. Keyword locations are grouped by keyword; each page returns whole groups plus a `summary` with tracked, untracked, clustered and running counts.

* Returns 25 keyword groups per page unless `pageSize` is set (`all` returns every group).
* Filter with `search` (keyword text) and `country` (ISO2).
* Sort with `sortBy` (`kw`, `country`, `pos`, `rankedPages`, `delta`) and `sortDir`.
* The window defaults to the last 30 days (set `startDate`/`endDate` or `days`); position change compares it with the period before it.


## OpenAPI

````yaml GET /v3/rank-tracking/keywords/table
openapi: 3.0.0
info:
  title: SnowSEO API
  description: API documentation for SnowSEO
  version: 1.0.0
servers:
  - url: https://api.snowseo.com
    description: Production server
security:
  - bearerAuth: []
  - apiKey: []
externalDocs:
  url: https://snowseo.com/docs
  description: Find more info here
paths:
  /v3/rank-tracking/keywords/table:
    get:
      tags:
        - Rank Tracking
      summary: Tracked keywords table
      description: >-
        The dashboard's tracked-keywords table: one page of keyword locations
        grouped by keyword, with position history, the average position and
        change over the window, and stored SERP result history. Filter with
        search or country, sort with sortBy, and read `summary` for
        tracked/untracked/clustered/running counts. Returns 25 keyword groups
        per page unless pageSize is set. The window defaults to the last 30 days
        and is compared with the period before it.
      operationId: listTrackedKeywordsTable
      parameters:
        - schema:
            type: string
          in: query
          name: teamId
          required: false
          description: Team ID
        - schema:
            type: string
          in: query
          name: startDate
          required: false
          description: >-
            Start date (YYYY-MM-DD on the team's calendar). days is ignored when
            a date is sent.
        - schema:
            type: string
          in: query
          name: endDate
          required: false
          description: >-
            End date (YYYY-MM-DD on the team's calendar). days is ignored when a
            date is sent.
        - schema:
            type: integer
            minimum: 1
            default: 30
          in: query
          name: days
          required: false
          description: >-
            Days back from today on the team's calendar, converted to
            startDate/endDate. Ignored when startDate or endDate is set.
            Defaults to 30.
        - schema:
            type: boolean
          in: query
          name: includeInactive
          required: false
          description: >-
            When true, also returns soft-untracked (active=false) keywords so
            the UI can offer re-tracking. Defaults to false (active only).
        - schema:
            type: string
          in: query
          name: search
          required: false
          description: Keyword text to match.
        - schema:
            type: string
          in: query
          name: country
          required: false
          description: Country (ISO2) to match.
        - schema:
            type: string
            enum:
              - kw
              - country
              - pos
              - rankedPages
              - delta
          in: query
          name: sortBy
          required: false
        - schema:
            type: string
            enum:
              - asc
              - desc
          in: query
          name: sortDir
          required: false
        - schema:
            type: integer
          in: query
          name: page
          required: false
          description: 1-based page. Default 1.
        - schema:
            type: string
          in: query
          name: pageSize
          required: false
          description: >-
            Rows per page (max 1000), or 'all'. Every response reports total and
            totalPages.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                properties:
                  page:
                    type: integer
                  pageSize:
                    type: integer
                  total:
                    type: integer
                  totalPages:
                    type: integer
                  summary:
                    type: object
                    additionalProperties: true
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        keywordId:
                          type: string
                        keyword:
                          type: string
                        countryId:
                          type: string
                          nullable: true
                        languageId:
                          type: string
                          nullable: true
                        locationCriteriaId:
                          type: number
                          nullable: true
                        locationCanonicalName:
                          type: string
                          nullable: true
                        position:
                          type: number
                        active:
                          type: boolean
                        status:
                          type: string
                          enum:
                            - completed
                            - processing
                            - failed
                            - pending
                        refreshedAt:
                          type: string
                          nullable: true
                        createdAt:
                          type: string
                        updatedAt:
                          type: string
                        isTracked:
                          type: boolean
                        trackingId:
                          type: string
                        monthlyVolume:
                          type: number
                          nullable: true
                        difficulty:
                          type: string
                          nullable: true
                        competitionScore:
                          type: number
                          nullable: true
                        cpc:
                          type: number
                          nullable: true
                        intent:
                          type: string
                          nullable: true
                        positionHistory:
                          type: array
                          items:
                            type: object
                            properties:
                              date:
                                type: string
                              position:
                                type: number
                        positionTrend:
                          type: string
                          nullable: true
                          enum:
                            - improved
                            - declined
                            - same
                            - new
                        nextRunAt:
                          type: string
                          nullable: true
                        serpFeatures:
                          type: object
                          additionalProperties: true
                        resultHistory:
                          type: array
                          items:
                            type: object
                            additionalProperties: true
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
                  code:
                    type: string
                  message:
                    type: string
                  reference:
                    type: string
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
                  code:
                    type: string
                  message:
                    type: string
                  reference:
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your SnowSEO API key (sk_...).
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.