Telegram API

Search Telegram public channels, groups and messages to retrieve post content, view counts and member samples.

Usernames accept standard or URL formats; private invite links and complete member lists are not supported.

Platform availability

24h health
Normal
Normal

Last 30 days

Available capabilities

Each Telegram action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.

CapabilityWhat it doesPer 1,00024-hour health
Channel postschannel_postsRead the messages posted in a public Telegram channel, with text, views, media, reactions and the forwarding source of each post.$0.56 per 1,000 requestsNormal
ProfilesprofileSee how big a public Telegram channel is: subscriber count, photo, video and link counts, bio, avatar and verification status.$0.56 per 1,000 requestsNormal
SearchsearchSearch messages across public Telegram channels by keyword, with channel name, type, subscriber count, views, reactions and media for each hit.$0.56 per 1,000 requestsNormal
GroupgroupLook up the info card of a Telegram group or channel: title, description, member and online counts, creation date and scam, fake or verified flags.$0.56 per 1,000 requestsNormal
MembersmembersList the visible members of a public Telegram group, with username, name, account type, Premium, scam and fake flags and last-seen time.$0.56 per 1,000 requestsNormal

Open a capability for its parameters, response fields, code samples and trial.

What does each Telegram action accept?

Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.

Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.

ActionRequiredOptionalDeliveryLimitPer 1,000Response fields
channel_posts

Channel posts

Read the messages posted in a public Telegram channel, with text, views, media, reactions and the forwarding source of each post. Private invite links are not supported, and the batch may not reach the full channel history.

username—Sync deliveryCatalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$0.56 per 1,000 requestsid · url · channel_username · channel_title · text · view_count · posted_at · media_type · media_url · author · is_forwarded · forwarded_from · reply_to_url · platform · link_preview_url · reactions
profile

Profiles

See how big a public Telegram channel is: subscriber count, photo, video and link counts, bio, avatar and verification status. Takes a name, @name, t.me/name or t.me/s/name; private chats, phone numbers and member names stay out of reach.

username—Sync delivery—$0.56 per 1,000 requestsusername · name · bio · subscriber_count · photo_count · video_count · link_count · is_verified · avatar_url · url · platform
search

Search

Search messages across public Telegram channels by keyword, with channel name, type, subscriber count, views, reactions and media for each hit. Narrow the window with since and until; private chats are never searched, and results do not represent all of Telegram.

keywordsince, untilSync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$0.56 per 1,000 requestsid · url · text · posted_at · view_count · media_url · reactions · channel_username · channel_title · channel_type · channel_subscriber_count · channel_description · platform
group

Group

Look up the info card of a Telegram group or channel: title, description, member and online counts, creation date and scam, fake or verified flags. Private invite links are not supported, and the call never joins the group or opens restricted content.

username—Sync delivery—$0.56 per 1,000 requestsid · type · username · url · title · name · description · member_count · online_count · created_at · is_verified · is_scam · is_fake · is_forum · is_restricted · admin_bots · platform
members

Members

List the visible members of a public Telegram group, with username, name, account type, Premium, scam and fake flags and last-seen time. The list may be partial, and a phone number appears only when the member has made it public.

username—Sync deliveryCatalog values: defaultLimit=100, maxLimit=5000. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$0.56 per 1,000 requestsid · username · url · name · type · is_verified · is_premium · is_scam · is_fake · last_seen_at · phone · platform

What do the Telegram channel_posts parameters mean?

Read the messages posted in a public Telegram channel, with text, views, media, reactions and the forwarding source of each post. Private invite links are not supported, and the batch may not reach the full channel history.

Full API reference: parameters, code samples, response example and health →
usernameRequired
Specifies the target public channel or group using formats such as name, @name, t.me/name, or t.me/s/name. Used by channel_posts and profile for public channels, group for public entity metadata, and members to retrieve visible group members; private invite links are not supported, and complete member lists are not guaranteed.
Telegram Official: Channels, Public Usernames, and View Counts — Official Telegram documentation distinguishes public channels from invite-only private channels, noting that channels function as broadcast tools and view counts include forwarded copies as approximate figures; this explains the channel object and view_count parameter, but does not prove this endpoint can read complete channel history or private content. · Checked
Telegram Official: Content Access Remains Subject to Licensing Terms — Limited official exceptions for third-party clients, bots, and Mini Apps cover only data strictly necessary for operational functionality and remain bound by terms, copyright, and privacy rules; the mere existence of an API endpoint does not constitute authorization for scraping, reselling, or arbitrary re-use of platform data. · Checked

What do the Telegram profile parameters mean?

See how big a public Telegram channel is: subscriber count, photo, video and link counts, bio, avatar and verification status. Takes a name, @name, t.me/name or t.me/s/name; private chats, phone numbers and member names stay out of reach.

Full API reference: parameters, code samples, response example and health →
usernameRequired
Specifies the target public channel or group using formats such as name, @name, t.me/name, or t.me/s/name. Used by channel_posts and profile for public channels, group for public entity metadata, and members to retrieve visible group members; private invite links are not supported, and complete member lists are not guaranteed.
Telegram Official: Channels, Public Usernames, and View Counts — Official Telegram documentation distinguishes public channels from invite-only private channels, noting that channels function as broadcast tools and view counts include forwarded copies as approximate figures; this explains the channel object and view_count parameter, but does not prove this endpoint can read complete channel history or private content. · Checked

What do the Telegram search parameters mean?

Search messages across public Telegram channels by keyword, with channel name, type, subscriber count, views, reactions and media for each hit. Narrow the window with since and until; private chats are never searched, and results do not represent all of Telegram.

Full API reference: parameters, code samples, response example and health →
keywordRequired
Specifies the message search query for the search action in public channels. It does not search contact lists or private chats.
Telegram Official: Content Licensing and AI Usage Restrictions — Official Telegram terms restrict content access beyond normal intended platform usage and prohibit scraping or aggregating platform data for AI model training, validation, enhancement, benchmarking, and deployment; exceptions require explicit, continuous consent from relevant users per piece of content and context, as public visibility does not grant a general usage license. · Checked
sinceOptional
Sets the lower message date bound for the search action. It does not filter by group creation date, and channel_posts has no date filter.
untilOptional
Sets the upper message date bound (beforeDate) for the search action. Used alongside since to narrow public message results; it does not guarantee complete message coverage within the specified range.

What do the Telegram group parameters mean?

Look up the info card of a Telegram group or channel: title, description, member and online counts, creation date and scam, fake or verified flags. Private invite links are not supported, and the call never joins the group or opens restricted content.

Full API reference: parameters, code samples, response example and health →
usernameRequired
Specifies the target public channel or group using formats such as name, @name, t.me/name, or t.me/s/name. Used by channel_posts and profile for public channels, group for public entity metadata, and members to retrieve visible group members; private invite links are not supported, and complete member lists are not guaranteed.
Telegram Official: Groups, Usernames, and Last Seen Privacy Settings — Official Telegram documentation details public usernames and t.me links, noting that last-seen status can be hidden or configured to display only approximate timeframes; member last_seen_at fields cannot be used to reconstruct exact activity histories, nor does a public username imply access to a public phone number. · Checked

What do the Telegram members parameters mean?

List the visible members of a public Telegram group, with username, name, account type, Premium, scam and fake flags and last-seen time. The list may be partial, and a phone number appears only when the member has made it public.

Full API reference: parameters, code samples, response example and health →
usernameRequired
Specifies the target public channel or group using formats such as name, @name, t.me/name, or t.me/s/name. Used by channel_posts and profile for public channels, group for public entity metadata, and members to retrieve visible group members; private invite links are not supported, and complete member lists are not guaranteed.
Telegram Official: Groups, Usernames, and Last Seen Privacy Settings — Official Telegram documentation details public usernames and t.me links, noting that last-seen status can be hidden or configured to display only approximate timeframes; member last_seen_at fields cannot be used to reconstruct exact activity histories, nor does a public username imply access to a public phone number. · Checked
Telegram Official: Content Access Remains Subject to Licensing Terms — Limited official exceptions for third-party clients, bots, and Mini Apps cover only data strictly necessary for operational functionality and remain bound by terms, copyright, and privacy rules; the mere existence of an API endpoint does not constitute authorization for scraping, reselling, or arbitrary re-use of platform data. · Checked

How to use the Telegram API

  1. 01Read the public catalog and choose a platform action.
  2. 02Send the platform, action, and required parameters to POST /api/v1/social.
  3. 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
  4. 04Store the structured response fields needed by your application.
telegram_channel_posts.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"telegram","action":"channel_posts","params":{"username":"<username>"}}'

Telegram API questions

What can I retrieve with the Telegram API?

Set platform to telegram. The current catalog lists channel posts, profiles, search, group, and members. These action names identify different Telegram objects or views; they are not interchangeable search modes.

Which input starts a Telegram `channel_posts` request?

Specifies the target public channel or group using formats such as name, @name, t.me/name, or t.me/s/name. Used by channel_posts and profile for public channels, group for public entity metadata, and members to retrieve visible group members; private invite links are not supported, and complete member lists are not guaranteed. Send it as username inside params.

Which fields can Telegram `channel_posts` return?

Its declared schema includes channel_username, channel_title, text, and view_count. A declared field can still be absent from an individual record, and every other action has its own field list.

Does every Telegram action return immediately?

Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.