Documentation

compare_live_ads

Compare observed Meta or Google live-ad history for up to five tracked shops.

Use compare_live_ads for questions about changes in active creative volume, platform mix or observed advertising intensity over time.

Inputs

FieldTypeRequiredNotes
storeIdsstring[]YesOne to five tracked shops
platformenumYesall, meta or google
rangeMonthsnumberYesInteger from 1 to 36

Example call

{
  "storeIds": ["store_one", "store_two"],
  "platform": "meta",
  "rangeMonths": 6
}

Good prompt

Compare Meta live-ad counts for these two tracked shops over 6 months.
Identify sustained increases rather than one-week spikes.

Interpreting results

Counts describe ads observed live by WhatWins. They are not verified media spend, campaign budget or profitability. A higher count can reflect more markets, more variants or a different testing strategy.

Use search_ads when the user wants the actual creatives behind the count.

Credits

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