Search Telegram contacts and the public directory
Returns matching peers from the public directory.
q must be at least 4 characters: Telegram's directory search ignores shorter queries and answers with an empty result rather than an error, so this API rejects them up front (400 INVALID_REQUEST, query too short) instead of returning an empty page you would have to interpret.
A shorter term still works if you pad it to four characters with spaces: ?q=gta%20 searches for gta and returns GTA-prefixed peers. Telegram measures the query as sent but trims it before matching, and q is forwarded to it byte-for-byte.
Request
- Base URL: https://telegram155.p.rapidapi.com
- URL: https://telegram155.p.rapidapi.com/v1/contacts/search
- Auth: none declared
Query parameters
Search query — username substring, full name, or phone fragment. Minimum 4 characters as sent; pad a shorter term with spaces (gta%20). Telegram returns nothing for shorter queries.
Maximum items to return. Defaults to 20 when omitted; values above 100 are clamped to 100.
Response
Matching peers.
Changes
No recorded changes to this operation across all 1 revision of this API.