---
title: "Run Citation Tracker"
method: POST
path: "/citations/trackers/{tracker_id}/run"
tags: ["AI Citations"]
---

# Run Citation Tracker

`POST /citations/trackers/{tracker_id}/run`

## 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/{tracker_id}/run`
- Auth: none declared. Required headers: `X-API-Key`

Run a tracker now. Every prompt × engine × sample counts as one check.

A run needs all of its checks up front: the month's remaining allowance plus any
top-up balance. If that is short the run is refused with 429 and nothing is spent.
Buy more with `POST /citations/topups/checkout`. A check whose engine returned an
error is not counted against either balance.

## Path parameters

- `tracker_id` integer, required

## Headers

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

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