Documentation

compare_shop_traffic

Compare current and historical monthly traffic for up to five tracked shops.

Use compare_shop_traffic when the user asks about traffic direction, relative audience size, growth, decline or a historical shop comparison.

Inputs

FieldTypeRequiredNotes
storeIdsstring[]YesOne to five tracked shops
rangeMonthsnumberYesInteger from 1 to 36

Example call

{
  "storeIds": ["store_gymshark", "store_alo-yoga"],
  "rangeMonths": 12
}

Good prompt

Compare the last 12 months of traffic for Gymshark and Alo Yoga.
Highlight direction changes and the strongest month-over-month divergence.

Interpreting results

Monthly traffic is a competitive signal. It is useful for relative scale and direction, but it is not audited analytics and should not be converted directly into revenue without an explicit model and caveat.

Preserve missing months rather than interpolating them silently. Read the response coverage field before describing the period as complete.

Credits

The call reserves and charges at most one result credit per requested shop.