Skip to main content

Documentation Index

Fetch the complete documentation index at: https://rocks.docs.rive.wtf/llms.txt

Use this file to discover all available pages before exploring further.

Every API key is tied to one IP. To apply for a key, DM southctrl on Discord.
Use the endpoint path below, replace the required params, and send Authorization: Bearer YOUR_API_KEY.

​
Quick Start

1

Choose a channel or user

Use the Telegram username you want.
2

Call the info route

Send the request with your Bearer token.
3

Use the result

Read channel or user metadata from the response.
Best for profile lookup tools and channel previews.

​
Channel / User Info

Get public information about a Telegram channel or user by username.

​
Endpoint

GET /api/telegram/{username}

​
Path Parameters

​
username
string
required
Telegram username (e.g. durov, telegram).

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/telegram/durov" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch('https://rocks.rive.wtf/api/telegram/durov', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});
const data = await response.json();
console.log(data);
Python
import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
response = requests.get(
    'https://rocks.rive.wtf/api/telegram/durov',
    headers=headers
)
print(response.json())

​
Example Response

{
  "id": 1006503122,
  "title": "Pavel Durov",
  "username": "durov",
  "type": "channel",
  "description": "Founder of Telegram.",
  "members": 10445535,
  "photo": "<base64-encoded profile photo>"
}

​
Response Fields

FieldTypeDescription
idintegerUnique Telegram ID of the channel or user
titlestringDisplay name of the channel or user
usernamestringTelegram username (without the @)
typestringAccount type — channel, user, group, etc.
descriptionstringBio or channel description
membersintegerNumber of members or subscribers
photostringBase64-encoded JPEG profile photo
photo field returns a base64-encoded JPEG string. To display it in a browser, prefix it with data:image/jpeg;base64,.
Only public Telegram channels and users can be looked up. Private accounts or groups will return an error.