Check free public Telegram search quota
telegram_get_public_search_quotaChecks the linked account’s live free public-search quota for a proposed query without running a search, returning remaining daily uses, wait time, and whether the query costs a slot.
Instructions
Check the linked account's live free quota without performing a public search.
First search accessible account history. To offer a broader public-channel search, call this with the exact proposed query. Tell the user the returned remaining/daily free count, wait time if any, and whether is_current_query_free means this query uses no new slot. Do not assume 10 attempts or any fixed quota. Explain the scope includes channels they have not joined, then ask and WAIT for explicit consent. Only after their reply pass confirmation_token and user_confirmed=true to telegram_search_public_posts. Tokens expire in five minutes; a new query or changed quota requires a fresh check and consent. Never offer a paid search, Stars purchase, or automatic retry.
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": {
"query": "<query>"
},
"name": "telegram_get_public_search_quota"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Telegram text-search query, 2–200 characters; surrounding whitespace is trimmed. Use ordinary search text, not a local regex or SQL expression. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quota | Yes | ||
| reason | No | ||
| status | Yes | ||
| searched_scope | No | public_channel_posts | |
| normalized_query | Yes | ||
| search_performed | No | ||
| stars_authorized | No | ||
| confirmation_token | No | ||
| retry_after_seconds | No | ||
| free_search_available | Yes | ||
| confirmation_expires_in_seconds | No |