Skip to main content
GET
/
telegram
/
channel
/
{channelId}
/
search
curl -X GET "https://scrape.st/telegram/channel/@durov/search?q=update&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

{
  "total": 5,
  "messages": [
    {
      "id": 123456,
      "text": "Telegram just got a new update!",
      "date": 1714567890,
      "channelId": "1001234567",
      "channelTitle": "Durov's Channel",
      "fromId": "987654321",
      "views": 500000,
      "forwards": 12000,
      "hasMedia": false,
      "mediaType": null
    }
  ]
}
Search for messages matching a specific query within a given Telegram channel or group.

​
Path Parameters

​
channelId
string
required
The Telegram channel username (e.g. @durov) or numeric ID

​
Query Parameters

​
q
string
Search query string (1-1000 characters). Optional. You can also use query instead of q. If omitted, fetches recent messages.
​
limit
number
default:"20"
Number of results to return (1-100)

​
Response

​
total
number
Total number of matching messages found
​
messages
array
curl -X GET "https://scrape.st/telegram/channel/@durov/search?q=update&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

{
  "total": 5,
  "messages": [
    {
      "id": 123456,
      "text": "Telegram just got a new update!",
      "date": 1714567890,
      "channelId": "1001234567",
      "channelTitle": "Durov's Channel",
      "fromId": "987654321",
      "views": 500000,
      "forwards": 12000,
      "hasMedia": false,
      "mediaType": null
    }
  ]
}