get_competitor_pressure

Attribute a Search impression-share drop to competitors for an ad account. Aligns the account’s rank-lost impression-share movement against watched competitors’ ad-library activity over the same window, and reports which competitors ramped up or launched new ads.

Use when investigating an impression-share drop / “losing to rank” / auction pressure. Side effect: if the organization tracks no competitors yet, up to 3 are discovered automatically, subscribed to the watch list, and their ads pulled. To browse the watch list or a competitor’s creatives without any auto-discovery, use list_watched_competitors / list_competitor_ads instead.

The literal Google Auction-Insights overlap rate has no API and is never fabricated; rising rank-lost impression share is the honest proxy for competitors outranking you.

Parameters#

Returns#

{
  "our_impression_share": { "now": 0.42, "prior": 0.55, "rank_lost_now": 0.31, "rank_lost_prior": 0.18 },
  "our_is_dropping_to_rank": true,
  "competitor_source": "watched",
  "competitors": [
    {
      "name": "Acme Corp",
      "domain": "acme.com",
      "new_ads_in_window": 14,
      "ramp": true,
      "ramp_started_on": "2026-06-20",
      "co_movement": true,
      "sample_creatives": [ ]
    }
  ],
  "co_movement": true,
  "summary": "…",
  "source": "adlyse.competitor_pressure@v1"
}

Returned facts are evidence, not a verdict — if no competitor shows in-window activity, the response says so.

Errors#