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

> Tracked keywords with daily position history, trend and SERP features.

Everything in [Tracked Keywords](https://snowseo.com/docs/api-reference/endpoints/tracked-keywords.md), plus each keyword's daily position history, a position trend, the next refresh time and the latest SERP features. Returns 25 keywords per page unless `pageSize` is set (`all` returns every keyword); `search` matches text anywhere in the keyword. Use `sort=position` for a best-ranking list.

### Position trends

The trend compares the average position over the last 30 days with the average over the 30 days before that.

| Trend | Meaning |
| - | - |
| `improved` | Average position went down (closer to #1) |
| `declined` | Average position went up (further from #1) |
| `same` | The two averages are equal |
| `new` | No previous data to compare, or no rank data in the last 30 days |


## OpenAPI

````yaml GET /v3/rank-tracking/keywords/summary
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/summary:
    get:
      tags:
        - Rank Tracking
      summary: Tracked keywords with position history and trend
      description: >-
        Tracked keywords with their daily position history, a 30-day position
        trend (improved, declined, same, new), next refresh time and the latest
        SERP features. Larger than /keywords because every keyword carries its
        history. Returns 25 keywords per page unless pageSize is set; use
        sort=position for a best-ranking list.
      operationId: listTrackedKeywordsSummary
      parameters:
        - schema:
            type: string
          in: query
          name: teamId
          required: false
          description: Team ID
        - 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:
              - position
          in: query
          name: sort
          required: false
          description: >-
            Set to 'position' for best rank first, unranked keywords last. Omit
            for tracked-first, most recently updated order.
        - schema:
            type: string
          in: query
          name: search
          required: false
          description: Case-insensitive text to match anywhere in the keyword.
        - 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
                  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
        '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.