telegram_search
Search Telegram posts using a free-text query with optional filters like specific channels or date ranges. Retrieve targeted results efficiently.
Instructions
Query-based search over Telegram posts.
When to use:
Use when a free-text
query
is provided (e.g., "search Telegram for X").Optional filters:
telegram_channel_usernames
,start_date
,end_date
.For "recent posts in Telegram" without a query, use
get_recent_posts_from_telegram
.For "recent posts from @channel", use
get_recent_posts_from_telegram
withtelegram_channel_usernames=["@channel"]
.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
end_date | No | ||
limit | No | Approximate number of Telegram posts to return | |
query | Yes | Free-text query to match in Telegram posts | |
start_date | No | ||
telegram_channel_usernames | No |
Input Schema (JSON Schema)
{
"properties": {
"end_date": {
"anyOf": [
{
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"description": "ISO date (YYYY-MM-DD). Include posts up to and including this date"
},
{
"type": "null"
}
],
"default": null,
"title": "End Date"
},
"limit": {
"default": 50,
"description": "Approximate number of Telegram posts to return",
"maximum": 100,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"query": {
"description": "Free-text query to match in Telegram posts",
"title": "Query",
"type": "string"
},
"start_date": {
"anyOf": [
{
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"description": "ISO date (YYYY-MM-DD). Include posts on/after this date"
},
{
"type": "null"
}
],
"default": null,
"title": "Start Date"
},
"telegram_channel_usernames": {
"anyOf": [
{
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "List of Telegram channel usernames to filter by (with or without leading @)"
},
{
"type": "null"
}
],
"default": null,
"title": "Telegram Channel Usernames"
}
},
"required": [
"query"
],
"type": "object"
}