contacts.search

contacts.search

No description provided by the pinned schema.

Signature

contacts.search#05f58d0f flags:# broadcasts:flags.0?true bots:flags.1?true q:string limit:int = contacts.Found;

Result type

contacts.Found

Parameters

Name	Type	Flag	Default	Description
flags	#	flag word	—	No description provided by the pinned schema.
broadcasts	flags.0?true	flags.0	—	No description provided by the pinned schema.
bots	flags.1?true	flags.1	—	No description provided by the pinned schema.
q	string	—	—	No description provided by the pinned schema.
limit	int	—	—	No description provided by the pinned schema.

Flags

Parameter	Bit	Meaning
broadcasts	0	Controlled by flags; present when this bit is set.
bots	1	Controlled by flags; present when this bit is set.

Python binding

from miniproto.raw.functions import ContactsSearch

Public access: miniproto.raw.functions.ContactsSearch.

Safe usage shape

from miniproto.raw.functions import ContactsSearch

# Naming the raw request class is local only; it performs no I/O or network request.
request_type = ContactsSearch

Result family

contacts.Found

RPC errors

Code	Error	Description
400	BUSINESS_CONNECTION_NOT_ALLOWED	This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we’re a user, and users cannot invoke methods over a business connection; (2) we’re a bot, but business mode was disabled in @botfather or (3); we’re a bot, but this method cannot be invoked over a business connection.
400	QUERY_TOO_SHORT	The query string is too short.
400	SEARCH_QUERY_EMPTY	The search query is empty.
401	AUTH_KEY_UNREGISTERED	The specified authorization key is not registered in the system (for example, a PFS temporary key has expired).

Accepted types

No non-primitive type relationships were found.

Returned types

contacts.Found Known selected constructors: contacts.found

Availability evidence

• user only

Provenance

• layer: 228
• structural source: tdlib
• canonical schema: https://raw.githubusercontent.com/tdlib/td/refs/heads/master/td/generate/scheme/telegram_api.tl
• prose merge precedence: TDLib → Telegram Desktop → Core JSON
• source note: Canonical structure is the pinned TDLib telegram_api.tl; Layer 228 comes only from the matching Telegram Desktop end-of-file marker; core.telegram.org inputs enrich documentation and RPC error metadata without overriding structure.

Source-diff notes

• tdlib_vs_core: changed_count=68; core_only_count=1; overlap_count=2302; tdlib_only_count=158
• tdlib_vs_tdesktop: changed_count=0; overlap_count=2448; tdesktop_only=null; tdlib_only=accessPointRule, ephemeral.editMessage, help.configSimple, inputPeerPhotoFileLocationLegacy, inputStickerSetThumbLegacy, invokeWithApnsSecretPrefix, invokeWithBusinessConnectionPrefix, invokeWithGooglePlayIntegrityPrefix, invokeWithReCaptchaPrefix, ipPort, ipPortSecret, updateEphemeralBotCallbackQuery