TOOLS
get_ search_ intent_ trends
What kinds of search intent bring people to my site, and how are they trending?
- Read-only
- No external calls
When to use it
Returns already-prepared, experimental intent categories for your top queries with measured 7- or 28-day trends, plus whether preparation is still running in the background.
Ask your AI
- What search intents drive traffic to my site over the last 28 days?
- Are informational or transactional searches growing on my site this week?
Parameters
| Name | Type | Details | What it means |
|---|---|---|---|
propertyId(required) | string | 1–200 characterspattern ^[a-zA-Z0-9._:-]+$ | The ID of the site to read, as returned by list_sites. You must own the site or have been granted access to it. |
days | 7 or 28 | default 28 | Trend window of 7 or 28 days. Defaults to 28. |
What it returns
For each intent category (informational, navigational, transactional, ambiguous and unclassified), clicks and impressions in the earlier and later window, the number of queries and the change in clicks, with a percentage and direction only when both windows are complete. It also lists the top 200 queries with their category, confidence and figures, and the background preparation state (such as ready, queued, unavailable or demo) with how many queries are still waiting for a category.
Notes
- Categories are experimental and cover the top 200 queries; all other queries are counted as unclassified.
- This tool never triggers AI model calls; categories are prepared in the background, and the result includes that preparation status.
- Read-only: it reads data QueryHippo has already stored. It does not start a collection, fetch anything or call an AI model.
Description your AI sees
Read prepared experimental search-intent categories, measured 7/28-day trends and background preparation status. Never triggers model calls. Evidence is bounded to the top 200 queries; unclassified totals include the remaining queries.
Full schemas
Input schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"propertyId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[a-zA-Z0-9._:-]+$"
},
"days": {
"default": 28,
"anyOf": [
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 28
}
]
}
},
"required": [
"propertyId"
],
"additionalProperties": false
}