---
title: "Summarize the prompts a selection matches"
method: POST
path: "/v3/ai-tracker/prompts/selection-summary"
tags: ["AI Tracker"]
---

# Summarize the prompts a selection matches

`POST /v3/ai-tracker/prompts/selection-summary`

## Request

- Base URL: `https://api.snowseo.com`
- URL: `https://api.snowseo.com/v3/ai-tracker/prompts/selection-summary`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/snowseo/apis/snowseo-api/docs/v3/ai-tracker/prompts/selection-summary/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `teamId` string
  - `selection` union, required
    - object
      - `mode` 'ids', required
      - `ids` string[], required
    - object
      - `mode` 'all', required
      - `filters` object, required
        - `platform` string
        - `competitor` string
        - `country` string
        - `startDate` string
        - `endDate` string
        - `promptBrand` string
        - `tracking` string
        - `intent` string
        - `search` string
      - `excludedIds` string[], required
  - `action` 'add-to-topic' | 'track' | 'untrack' | 'refresh' | 'delete'
  - `targetTopicId` string, uuid
  - `regions` object[]
    - `type` 'country' | 'state' | 'city', required
    - `city` string
    - `state` string
    - `country` string, required
    - `iso2` string, required
    - `iso3` string

## Response `200`

Default Response

- object
  - `summary` object

## Changes

- **2026-11-01** `6d1dc4928d97`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/ai-tracker/prompts/selection-summary/post.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) - [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/snowseo/apis/snowseo-api/revisions/fa99dfa1a3d6?raw)
