Telegram API
Search Telegram public channels, groups and messages to retrieve post content, view counts and member samples.
Usernames can be plain or in URL form. Private invite links and complete member lists are not supported.
Send POST https://api.everyinfra.com/api/v1/social with platform set to telegram and action set to a capability name from the list below, for example channel_posts.
- 6 capabilities
- From $0.56 per 1,000 requests
- No charge for failed calls or empty results
Platform availability
- 24h health
- 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.
| Capability | What it does | Per 1,000Blank rows: $0.56 | 24-hour health · All normal |
|---|---|---|---|
Channel postschannel_posts | Read the messages posted in a public Telegram channel. | Normal | |
Profilesprofile | See how big a public Telegram channel is. | Normal | |
Searchsearch | Search messages across public Telegram channels by keyword. | Normal | |
Groupgroup | 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. | Normal | |
Membersmembers | List the visible members of a public Telegram group, with username, name, account type, Premium, scam and fake flags and last-seen time. | Normal | |
Post detailspost_detail | Read one message from a public Telegram channel by its link, such as https://t.me/durov/520. | $0.81 per 1,000 requests | Normal |
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 features of the official site are not part of the EveryInfra API unless this page lists them.
Sync delivery for every action.
| Action | Required | Optional | Limit | Per 1,000Blank rows: $0.56 | Response fields |
|---|---|---|---|---|---|
channel_postsChannel posts Read the messages posted in a public Telegram channel. Each post has text, views, media, reactions and its forwarding source. Private invite links are not supported. The batch may not reach the full channel history. | username | — | Catalog 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. | id · 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 | |
profileProfiles See how big a public Telegram channel is. Get subscriber count, photo, video and link counts, bio, avatar and verification status. It takes a name, @name, t.me/name or t.me/s/name. Private chats, phone numbers and member names stay out of reach. | username | — | — | username · name · bio · subscriber_count · photo_count · video_count · link_count · is_verified · avatar_url · url · platform | |
searchSearch Search messages across public Telegram channels by keyword. Each hit has channel name, type, subscriber count, views, reactions and media. Narrow the window with | keyword | since, until | Catalog 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. | id · url · text · posted_at · view_count · media_url · reactions · channel_username · channel_title · channel_type · channel_subscriber_count · channel_description · platform | |
groupGroup 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 | — | — | id · 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 | |
membersMembers 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 | — | Catalog 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. | id · username · url · name · type · is_verified · is_premium · is_scam · is_fake · last_seen_at · phone · platform | |
post_detailPost details Read one message from a public Telegram channel by its link, such as https://t.me/durov/520. Get text, views, post time, media type and link, author signature, forward source, reply link, link preview and reactions with counts. | url | — | — | $0.81 per 1,000 requests | id · url · channel_username · text · view_count · posted_at · media_type · media_url · author · is_forwarded · forwarded_from · reply_to_url · platform · link_preview_url · reactions |
What do the Telegram channel_posts parameters mean?
Read the messages posted in a public Telegram channel. Each post has text, views, media, reactions and its forwarding source. Private invite links are not supported. The batch may not reach the full channel history.
Full API reference: parameters, code samples, response example and healthusernameRequired- 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. · CheckedTelegram 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. Get subscriber count, photo, video and link counts, bio, avatar and verification status. It 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 healthusernameRequired- 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. Each hit has channel name, type, subscriber count, views, reactions and media. Narrow the window with since and until. Private chats are never searched, and results do not represent all of Telegram.
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 healthusernameRequired- 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 healthusernameRequired- 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. · CheckedTelegram 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 post_detail parameters mean?
Read one message from a public Telegram channel by its link, such as https://t.me/durov/520. Get text, views, post time, media type and link, author signature, forward source, reply link, link preview and reactions with counts.
Full API reference: parameters, code samples, response example and healthurlRequired- Link to one public channel message for
post_detail, https://t.me/<channel>/<message ID>; t.me/s/ links work too.
How to use the Telegram API
- 01Choose a platform action from the public catalog.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Read the result from the response. For an asynchronous action, poll the returned job ID.
- 04Store the response fields that your application needs.
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, members, and more. These action names identify different Telegram objects or views; they are not interchangeable search modes.
Which input starts the 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.
