Skip to main content
DocumentationLibraryReference
On this page

Kater CLI Projects and timelines figure

kater figure trend

Keeps one figure's value at each week that Kater stored, and its change from as many weeks before as the two weeks are apart, as an answer.

It prints the answer’s id. Kater must check the two weeks first, with kater compare --app. It reads no warehouse, and the same stored weeks give the same answer.

Examples

Terminal window
# Keep TikTok Ads spend at each stored week, with its change from the week before
kater figure trend app_129abe379bbf43b5a7012c252157e634 'EVAL(sum__spend)|platform=TikTok Ads' --periods 2026-09-28,2026-10-05
# Keep the same figure with its change from 4 weeks before
kater figure trend app_129abe379bbf43b5a7012c252157e634 'EVAL(sum__spend)|platform=TikTok Ads' --periods 2026-09-07,2026-10-05

Arguments

ArgumentDescription
<id>The app’s id, from the id in its kater.app.yaml.
<figure>The figure by its series key, as kater compare --app prints it after Series:. Put it in quotes, because it holds | and spaces.

Options

OptionDescription
--periods <week>,<week>Required. The two weeks that kater compare --app compared, each by its Monday. The change is read across as many weeks as they are apart.
--grain <grain>The grain of the periods: hour, day, week, month, quarter or year. A week by default. It is hour, day, week, month, quarter or year.

It also takes the global options --json and --help.

See also