Search Telegram Channels and Groups

GET 
/v1/channels/search

Allows searching for channels by name, description, country, language, and category.

Request

Responses

200

Channels list

Response Headers

x-credits-cost

Milli-credits charged for this successful request. Present for Credits API keys.

x-credits-remaining

Remaining milli-credit balance after this request. Present for Credits API keys.

400

Bad Request: The request sent to the server is invalid.

Request parameters are missing, incorrect, or in the wrong format.

401

Unauthorized: The provided API key is invalid or absent.

Provided in the request API key is not valid or is missing.

402

Payment Required: Not enough credits to perform this request.

The plan allows this call but the credit balance does not cover it. Top up credits and retry. Amounts are in milli-credits (1 credit = 1000).

403

Forbidden: Access to this resource is not allowed.

User does not have permission to access this feature.

404

Not Found: Requested resource could not be found on the server.

Specific resource with the provided ID cannot be found.

412

Inactive Subscription: The user's subscription is not currently active.

User subscription has expired or is otherwise inactive.

426

Quota Reached: The user's subscription limit has been reached.

User has exceeded their monthly limit for unique channels or total requests.

For higher limits please contact us via Telegram @telemetrio_contact or write to contact@telemetr.io.

429

Too Many Requests: The request rate limit has been reached.

Retry after the interval indicated by the response headers.

503

Service Unavailable: Credit accounting is temporarily unreachable.

The request was refused rather than served without being billed. This is transient — retry with backoff.

Carries the standard message envelope, with a constant message: the underlying failure is ours and its text names internal machinery, so it is never forwarded.