---
title: "Create Citation Tracker"
method: POST
path: "/citations/trackers"
tags: ["AI Citations"]
---

# Create Citation Tracker

`POST /citations/trackers`

## Request

- Base URL: `https://seoscoreapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://seoscoreapi.com/citations/trackers`
- Auth: none declared. Required headers: `X-API-Key`

Track a brand's visibility in AI answers. Requires Starter ($5/mo) or higher.

Send JSON: {"brand": "Acme", "domains": ["acme.com"], "prompts": ["best CRM for agencies"],
"competitors": ["Rival"], "engines": ["chatgpt","gemini","perplexity","claude"],
"samples": 3, "cadence": "weekly", "webhook_url": "https://..."}

**No prompts yet?** Leave `prompts` out and send `"starter": {"topic": "CRM",
"audience": "agencies"}` instead. The tracker is created with a starter set built
from `topic`, your `brand` and `competitors` (the same list
`GET /citations/prompts/starter` returns), cut to the tracked prompts your plan has
left and to what one run can spend of your monthly checks at the tracker's engines
and samples. With no `cadence`, a starter tracker runs weekly when the allowance
covers a month of weekly runs, otherwise monthly. The response's `starter` block
says how many were generated and kept, the checks per run and the cadence chosen.
Edit them later with `PATCH`.

Monthly allowance (checks / tracked prompts): Starter 150 / 15, Basic 500 / 30,
Pro 1,500 / 75, Ultra 4,000 / 200. A check is one prompt on one engine, sampled once.

## Headers

- `X-API-Key` string, required: Your API key

## Request body

- object
  - `brand` string, required
  - `prompts` string[]: The questions to ask the AI engines.
  - `engines` string[]
  - `competitors` string[]
  - `domains` string[]
  - `samples` integer
  - `cadence` 'daily' | 'weekly' | 'monthly' | 'manual'
  - `webhook_url` string, uri: https only.
  - `starter` object: Send instead of prompts to start from a generated set.
    - `topic` string
    - `audience` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/seoscoreapi/apis/seo-score-api.md) · [All operations](https://skmtc.dev/seoscoreapi/apis/seo-score-api/llms.txt) · [OpenAPI document](https://skmtc.dev/seoscoreapi/apis/seo-score-api/revisions/877a3044b5be?raw)