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

# Filter Options

> Valid values for the AI visibility scope filters.

The valid values for the scope filters: platforms, countries, and competitors. The competitor list is every brand ever seen in your AI answers, so narrow it with `search` or raise `limit`.

Scope filters are described on [AI Visibility](https://snowseo.com/docs/api-reference/endpoints/ai-visibility.md).


## OpenAPI

````yaml GET /v3/ai-tracker/filter-options
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/ai-tracker/filter-options:
    get:
      tags:
        - AI Tracker
      summary: AI Visibility filter dropdown options
      description: >-
        The valid values for the scope filters every ai_visibility_* tool
        accepts: AI platforms, country codes and competitor names. The
        competitor list is every brand ever seen in the team's AI answers, so it
        can run to thousands - narrow it with search, or raise limit only when
        you truly need the whole list.
      operationId: getAiVisibilityFilterOptions
      parameters:
        - schema:
            type: string
          in: query
          name: teamId
          required: false
        - schema:
            type: string
          in: query
          name: search
          required: false
          description: Case-insensitive substring match on competitor name.
        - schema:
            type: string
          in: query
          name: limit
          required: false
          description: >-
            Max competitors to return, or 'all'. Defaults to 25. The response
            reports competitorsTotal and competitorsTruncated. Platforms and
            countries are never capped (both are small, bounded lists).
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  platforms:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  countries:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  competitors:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  competitorsTotal:
                    type: number
                  competitorsTruncated:
                    type: boolean
        '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.