API

Simple API

Fetch public Telegram channel and group data - title, description, photo, subscribers, and more - with a simple HTTP API.

Status: 13,403 requests/day Get Your Api Key

Documentation

Send GET requests to the base URL. Include your API key on every call. Credits are charged when the request succeeds.

Base URL

https://telegramchannels.me/api

getMediumInfo

$0.0005 / req

searchMedia

$0.001 / req

GET

/getMediumInfo

Look up a single public channel or group by username. Returns title, description, photo, subscribers, last post, and related stats.

1 credit

username required apikey required live=1 optional · +1 credit

username is the public handle without @. live=1 fetches fresh Telegram data; otherwise results use our daily cache.

Request

GET /api/getMediumInfo?username=dailychannels&apikey=YOURKEY HTTP/1.1
Host: telegramchannels.me

Success

{
  "status": true,
  "data": {
    "username": "dailychannels",
    "type": "channel",
    "title": "Daily Channels",
    "description": "Best Telegram Channels...",
    "photo_url": "https://...",
    "subscribers": 29309,
    "photos": 1350,
    "videos": 2,
    "files": 0,
    "links": 2790,
    "last_message": {
      "id": 4157,
      "time": "2023-05-08T05:55:38+00:00",
      "views": 453
    },
    "average_views": 4177,
    "is_verified": false,
    "is_restricted": false,
    "is_nsfw": false,
    "language": "en"
  }
}

Error

{
  "status": false,
  "reason": "not-available",
  "message": "Username [@testchannel3] is not available."
}

Notes

reason: was-available, not-available, restricted, invalid-username, low-credit, auth-failed, unknown
When is_restricted is true, counters and last_message fields are null.
photo_url may be a URL or a base64 string.

GET

/searchMedia

Search public channels and groups by keyword. Filter by type, subscribers, verified badge, or NSFW.

2 credits

Required

phrase search keyword apikey your key

Optional

page_number on_each_page ≤50 type channel|group sort_by subscribers min_subscribers verified=yes safe_mode=off include NSFW

Request

GET /api/searchMedia?phrase=telegram&verified=yes&apikey=YOURKEY HTTP/1.1
Host: telegramchannels.me

Success

{
  "status": true,
  "total": 46,
  "safe_mode": true,
  "page_number": 1,
  "on_each_page": 10,
  "channels": [
    {
      "username": "telegram",
      "type": "channel",
      "title": "Telegram News",
      "description": "...",
      "photo_url": "...",
      "subscribers": 6301482,
      "is_verified": true,
      "is_nsfw": false,
      "language": "en"
    }
  ]
}

total is the full match count, not only this page.

Empty result

{
  "status": true,
  "total": 0,
  "safe_mode": true,
  "page_number": 1,
  "on_each_page": 10,
  "channels": []
}

Media

Links

About

telegramChannels.me is a Telegram directory of channels, groups, bots, and stickers submitted by users and updated daily. We are not responsible for their content.

This site is not affiliated with Telegram.

This website uses cookies to ensure you get the best experience on our website