get_hover_analysis
Hover-dwell statistics per element, including the elements visitors stared at but never clicked.
When to use it
For hesitation and confusion. Set hesitationOnly: true to surface elements hovered for a long time and never clicked in the same page view — unclear pricing, ambiguous CTAs, and things that look clickable but are not.
Ask for it like this
You do not name the tool. These are questions that make an assistant reach for it:
What is my biggest hidden hesitation point?
What do people look at but never click?
How to read the result
- Pair it with get_element_click_analysis to compare attention against action. A high-attention, low-action element is a conversion problem hiding in plain sight.
What will make you wrong
Caveats
- Hover is a pointer signal. It carries no information on touch devices.
Parameters
pageUrl
Restrict to pages containing this string.
hesitationOnly
Return only elements hovered at least minDwellMs and never clicked in the same page view.
minDwellMs
Dwell threshold used when hesitationOnly is set.
limit
Maximum elements to return.
Shared parameters it accepts
Documented in full on the tool reference index.
Date window — defaults to the last 30 days.
dateFrom
Start of the window, YYYY-MM-DD. Inclusive.
dateTo
End of the window, YYYY-MM-DD. Inclusive.
Every tool also accepts merchantId, which resolves from your connection. You never pass it.
What comes back
JSON. These are the top-level keys; date-scoped tools additionally carry a _meta block with the server date and the data coverage envelope.
elements
Per selector: total_dwell_ms, total_hovers, avg_dwell_ms, max_dwell_ms and unique_sessions.
mode
hesitation_only or all_hovers, so the rows cannot be misread.