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

# Top Keywords

> See your best-performing tracked keywords ranked by position.

Get your top-performing keywords sorted by their current search position. Useful for spotting which keywords are driving the most visibility.


## OpenAPI

````yaml GET /v3/rank-tracking/top-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/top-keywords:
    get:
      tags:
        - Rank Tracking
      summary: Top keywords from GSC
      description: >-
        Returns the top performing keywords from Google Search Console 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). Preferred over days.
        - schema:
            type: string
          in: query
          name: endDate
          required: false
          description: End date (YYYY-MM-DD, UTC). Preferred over days.
        - schema:
            type: integer
          in: query
          name: days
          required: false
          description: Number of days to look back (legacy fallback)
        - schema:
            type: string
          in: query
          name: device
          required: false
          description: Device filter
        - schema:
            type: string
          in: query
          name: type
          required: false
          description: Search type filter
        - schema:
            type: string
          in: query
          name: country
          required: false
          description: Country filter
        - schema:
            type: string
            enum:
              - all
              - ranked
              - tracked
          in: query
          name: scope
          required: false
          description: >-
            Keyword universe: all (GSC + tracked merged), ranked (GSC only),
            tracked (tracked only). Defaults to all.
        - schema:
            type: integer
          in: query
          name: limit
          required: false
          description: Max results
        - schema:
            type: string
          in: query
          name: includeComparison
          required: false
          description: Include period-over-period comparison
        - schema:
            type: integer
          in: query
          name: currentPeriodDays
          required: false
          description: Days in current period (legacy fallback)
        - schema:
            type: integer
          in: query
          name: previousPeriodDays
          required: false
          description: Days in previous period (legacy fallback)
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                      properties:
                        keyword:
                          type: string
                        clicks:
                          type: number
                          nullable: true
                        impressions:
                          type: number
                          nullable: true
                        ctr:
                          type: number
                          nullable: true
                        position:
                          type: number
                        isStarred:
                          type: boolean
                        languageId:
                          type: string
                        clicksChange:
                          type: number
                        impressionsChange:
                          type: number
                        ctrChange:
                          type: number
                        positionChange:
                          type: number
                        pages:
                          type: number
                        rankedPages:
                          type: array
                          items:
                            type: object
                            additionalProperties: true
                            properties:
                              page:
                                type: string
                              clicks:
                                type: number
                              impressions:
                                type: number
                              ctr:
                                type: number
                              position:
                                type: number
                              clicksChange:
                                type: number
                              impressionsChange:
                                type: number
                              ctrChange:
                                type: number
                              positionChange:
                                type: number
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
        '404':
          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

````