> ## 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

> List all keywords you're tracking, with their current positions and trends.

Get a list of every keyword you're tracking for a team, along with its current search position, previous position, and whether it's improving or declining.

### Position trends

| Trend      | Meaning                                     |
| ---------- | ------------------------------------------- |
| `improved` | Position went down (closer to #1)           |
| `declined` | Position went up (further from #1)          |
| `same`     | No change                                   |
| `new`      | Just started tracking, no previous data yet |


## OpenAPI

````yaml GET /v3/rank-tracking/keywords
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: []
tags:
  - name: Keywords
    description: Keyword research and suggestion end-points
  - name: Onboarding
    description: Brand onboarding and strategy end-points
  - name: Brands
    description: Brand management end-points
  - name: Organizations
    description: Organization and member end-points
  - name: Integrations
    description: Google Search Console and other integrations
  - name: Utilities
    description: Common utility end-points like screenshots and uploads
externalDocs:
  url: https://snowseo.com/docs
  description: Find more info here
paths:
  /v3/rank-tracking/keywords:
    get:
      tags:
        - Rank Tracking
      summary: List tracked keywords
      description: Returns the list of tracked keywords for a team.
      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, UTC) for GSC position summary window.
        - schema:
            type: string
          in: query
          name: endDate
          required: false
          description: End date (YYYY-MM-DD, UTC) for GSC position summary window.
        - schema:
            type: integer
          in: query
          name: days
          required: false
          description: Days to look back for GSC position summary (legacy fallback).
        - 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
            enum:
              - minimal
          in: query
          name: fields
          required: false
          description: >-
            Set to 'minimal' for a trimmed payload (keyword text + targeting +
            tracked flags only, no positionHistory/resultHistory). Intended for
            callers that only check whether a keyword is tracked. Omit for the
            full response.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                properties:
                  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
                        positionHistory:
                          type: array
                          items:
                            type: object
                            properties:
                              date:
                                type: string
                              position:
                                type: number
                        active:
                          type: boolean
                        refreshedAt:
                          type: string
                          nullable: true
                        createdAt:
                          type: string
                        updatedAt:
                          type: string
                        gscPosition:
                          type: number
                          nullable: true
                        gscClicks:
                          type: number
                          nullable: true
                        gscImpressions:
                          type: number
                          nullable: true
                        isTracked:
                          type: boolean
                        trackingId:
                          type: string
                        positionTrend:
                          type: string
                          nullable: true
                          enum:
                            - improved
                            - declined
                            - same
                            - new
                        nextRunAt:
                          type: string
                          nullable: true
                        resultHistory:
                          type: array
                          items:
                            type: object
                            additionalProperties: true
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    type: string

````