Channels

Search

Changed on Oct 9, 2026

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

get/v1/channels/search

Request

Base URL
https://api.tlmtr.io
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/tlmtr/apis/telemetr-io-public-api/docs/v1/channels/search/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

termstring

Search phrase or link to the channel.

https://t.me/v_zelenskiy_official or @v_zelenskiy_official or private link https://t.me/+AAAAAEXn99bdXjIqSGYCsA

search_in_aboutboolean

Search in channel description.

term will be searched not only in the channel name but also in the description

peer_type'Group' | 'Channel'

Chat type

Example:Channel

Chat type.

Can be Channel or Group By default Channel is used

countrystring

Channel country.

List of countries can be obtained here /v1/dictionaries/countries

languagestring

Channel language.

List of languages can be obtained here /v1/dictionaries/languages

categorystring

Channel category id.

List of categories can be obtained here /v1/dictionaries/categories Example: mf2MkrwoE

limitinteger

Number of results.

Max limit can be changes. Contact @telemetrio_contact or contact@telemetr.io.

Default is 20.

skipinteger

Response

Channels list

internal_idstring required

Chat internal id

peer'Group' | 'Channel' required

Chat type

titlestring required

Chat name

photo_urlstring nullable

Chat image

countrystring nullable

Channel country

languagestring nullable

Channel language

categorystring nullable

Channel category

members_countinteger required

Number of members

verifiedboolean required

Telegram verification

Example response

[
  {
    "internal_id": "1B3CMw",
    "peer": "Channel",
    "title": "Zelenskiy / Official",
    "photo_url": "https://img.telemetr.io/c/1l1EcE/5406980229706134223?w=64&h=64",
    "country": "ukraine",
    "language": "ua",
    "category": "mf2MkrwoE",
    "members_count": 840943
  }
]

Changes

Oct 9, 20266c2bfd66c5f2 Revision changes
- breaking
  the response's body type changed from object to no type for status
- breaking
  the response's body type changed from object to no type for status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- info
  added subschema #2 to the response body allOf list for the response status
- info
  added subschema #2 to the response body allOf list for the response status
Sep 10, 202680951ad7b3fb Revision changes
- info
  added the media type application/json for the response with the status
- info
  added the non-success response with the status

Operation history