TGStat APIin.tgstat.com ↗
Search Telegram channels and groups, get ranked ratings lists, and fetch detailed channel profiles including subscriber metrics and category data via the TGStat API.
curl -X POST 'https://api.parse.bot/scraper/ebf74fe8-f81a-4263-8013-8aa752ee2694/search_channels' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"page": "0",
"sort": "participants",
"query": "education"
}'Search for Telegram channels using advanced filters like keyword, category, and country. Returns a paginated list of channels with handles, subscriber counts, and internal IDs. Pagination uses the page parameter returned in nextPage.
| Param | Type | Description |
|---|---|---|
| page | integer | Pagination page number, use nextPage from previous response to get next page of results |
| sort | string | Sort order. Accepted values: participants, avg_reach, ci_index, members_t, members_y, members_7d, members_30d |
| query | string | Keyword to search for in channel name or description |
| country | integer | Country ID to filter results by (e.g. 8 for India, 1 for Russia). Omit to search globally. |
| category | string | Category name to filter by (e.g. education, cryptocurrencies) |
{
"type": "object",
"fields": {
"hasMore": "boolean indicating if more results are available",
"channels": "array of channel objects with name, handle, tgstat_id, and subscribers fields",
"nextPage": "integer page number for fetching next page of results",
"nextOffset": "integer offset for next page"
},
"sample": {
"data": {
"hasMore": true,
"channels": [
{
"name": "Rajasthan Vacancy Education News Sarkari Result Jobs",
"handle": "@rajasthanvacancy_in",
"tgstat_id": null,
"subscribers": "575 403"
},
{
"name": "EDUCATION NEWS RAJASTHAN",
"handle": "@education_news_rajasthan",
"tgstat_id": null,
"subscribers": "510 883"
}
],
"nextPage": 1,
"nextOffset": 30
},
"status": "success"
}
}About the TGStat API
The TGStat API provides 4 endpoints for discovering and analyzing Telegram channels and groups indexed by TGStat. The search_channels endpoint accepts keyword, category, and country filters and returns paginated results with channel handles, subscriber counts, and internal TGStat IDs. The get_channel_profile endpoint delivers detailed metadata including description, category, geo/language tags, and subscriber metrics for any public channel by username.
Search and Filter Telegram Channels
The search_channels endpoint accepts a query string for keyword matching against channel names and descriptions, a category name (e.g. education, cryptocurrencies), a country integer ID (e.g. 8 for India, 1 for Russia), and a sort parameter with options including participants, avg_reach, ci_index, members_7d, and members_30d. Results are paginated: each response includes a hasMore boolean, a nextPage integer, and a nextOffset value to iterate through additional pages. Each item in the channels array carries name, handle, tgstat_id, and subscribers.
Channel and Group Ratings
The get_ratings_channels endpoint returns a ranked list of Telegram channels filterable by category and sortable by members or reach. The get_ratings_groups endpoint provides the same structure for Telegram groups and chats, with members as the verified sort value. Both return arrays of objects with name, handle, tgstat_id, and subscribers (or member counts), making them suitable for building leaderboards or benchmarking a channel against peers in a given category.
Channel Profile Detail
The get_channel_profile endpoint accepts a Telegram username with or without the @ prefix and returns a single structured object. Fields include title, handle, description, tgstat_id, a url pointing to the TGStat profile page, an info object with category and geo/language metadata, and a metrics object containing subscriber count and related figures. This endpoint is the right starting point when you have a specific channel handle and need its full public profile in one call.
- Build a Telegram channel discovery tool filtered by country and category using search_channels
- Track subscriber count changes over time by periodically calling get_channel_profile for a list of handles
- Generate category leaderboards for Telegram channels using get_ratings_channels sorted by reach
- Compare group membership across categories using get_ratings_groups with a category filter
- Identify top Telegram channels in a niche (e.g. cryptocurrencies) for influencer or partnership research
- Enrich a Telegram handle database with category, geo, and description data via get_channel_profile
- Monitor new entrants in a category by paginating search_channels sorted by members_30d
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does TGStat offer an official developer API?+
What does get_channel_profile return that the search and ratings endpoints do not?+
get_channel_profile endpoint returns the full description text, a structured info object with category and geo/language metadata, a direct url to the TGStat profile page, and a metrics object with subscriber detail. The search and ratings endpoints return a lighter set: name, handle, tgstat_id, and subscribers only.How does pagination work in search_channels?+
search_channels response includes a hasMore boolean, a nextPage integer, and a nextOffset integer. Pass the nextPage value as the page parameter in your next request to retrieve the following page. Continue until hasMore is false.