list_citation_lifetimes
Which cited pages (or domains) are losing or gaining AI citations: each one's citation-lifetime status over the last 26 completed ISO weeks (lost, fading, ended, regained, new, rising, first_measured, no_recent_data, steady, occasional) with its rate before and now, n for each, first and last citation, weeks cited and streaks, sorted by the size of the rate change. Filters: scope (own, competitors, all), status, granularity (page or domain), source, limit (default 25, max 200). statusCountsAllPages counts every page, including those not listed. One page's lifetime, with its weekly series and causes, is in get_cited_url. The eligibility, status and refresh rules arrive in howToRead.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_citation_lifetimes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to return (default 25, max 200). | |
| scope | No | "own" (default) = the client's own domains, "competitors" = the tracked competitors' domains, "all" = every cited page. | |
| source | No | Data source: "blended" (default — CrunchJunkie scans plus imported Peec data, an engine both track counted once with the CrunchJunkie scan winning), "native" (CrunchJunkie scans only) or "peec" (imported Peec data only). | |
| status | No | Only these statuses, e.g. ["lost", "fading"] ("occasional" pages are counted, never listed). | |
| clientId | No | Client id — uses the AI-Visibility project its Overview opens in the app (the newest). | |
| projectId | No | AI-Visibility project id. | |
| granularity | No | "page" (default) or "domain". |