frequencies
Get base and exact 30-day search volumes for multiple phrases in one call to validate real demand and decide if each phrase merits its own page.
Instructions
Base and exact search volume over the last 30 days for a list of phrases in one call.
Use it to check real demand for specific wordings instead of calling top_requests per phrase.
base counts every query containing the words, so it is inflated by longer queries.
exact counts only queries made of exactly these words in these forms ("!word1 !word2") —
trust it when deciding whether a phrase deserves its own page. exact_share_percent is
exact / base. Each phrase costs up to 2 API requests (1 with mode "exact" or "base").
A phrase that fails gets an error field; the others are still returned.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"phrases": "<phrases>"
},
"name": "frequencies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | both = base and exact, or only one of them (half the API requests). | both |
| devices | No | Device filter. Omit for all devices. | |
| phrases | Yes | Phrases to check, up to 7 words each. | |
| regions | No | Region IDs or exact names, e.g. ["213"] or ["Москва"]. Omit for all regions. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |