EveryData platform API

Telegram API

Q: 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.

Q: 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 source record, and every other action has its own field list.

Telegram separates Telegram channels, channel posts, public groups, profiles, searches, and member records across 5 documented actions (`channel_posts`, `profile`, `search`), keeping discovery and object-detail contracts distinct.

Start with `channel_posts` for channel posts and move to `profile` for the selected Telegram record using `username`, keeping the two result shapes distinct.

Start for free View the public catalog

Endpoint: POST /api/v1/social
Capabilities: 5
Per 1,000: $0.556

Available capabilities

Compare the Telegram actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.

Action	Required	Optional	Delivery	Limit	Per 1,000	Response fields
`channel_posts` Channel posts Retrieve channel posts from Telegram. Accepts these parameters: `username`. Returns these fields: `is_paid`, `forwarded_from`, `emoji`, and `view_count`.	username	—	Sync delivery	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.	$0.56 per 1,000 requests	id · url · channel_username · channel_title · text · view_count · posted_at · media_type · media_url · author · is_forwarded · forwarded_from · reply_to_url · platform · emoji · count · is_paid
`profile` Profiles Retrieve public channel details from Telegram. Accepts these parameters: `username`. Returns these fields: `username`, `name`, `video_count`, and `subscriber_count`.	username	—	Sync delivery	—	$0.56 per 1,000 requests	username · name · bio · subscriber_count · photo_count · video_count · link_count · is_verified · avatar_url · url · platform
`search` Search Search public results on Telegram. Accepts these parameters: `keyword`, `since`, and `until`. Returns these fields: `text`, `channel_subscriber_count`, `emoji`, and `count`.	keyword	since, until	Sync delivery	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.	$0.56 per 1,000 requests	id · url · text · posted_at · view_count · media_url · reactions · channel_username · channel_title · channel_type · channel_subscriber_count · channel_description · platform · emoji · count
`group` Group Retrieve public group details from Telegram. Accepts these parameters: `username`. Returns these fields: `is_verified`, `description`, `type`, and `is_forum`.	username	—	Sync delivery	—	$0.56 per 1,000 requests	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
`members` Members Retrieve public member details from Telegram. Accepts these parameters: `username`. Returns these fields: `is_verified`, `username`, `is_scam`, and `is_fake`.	username	—	Sync delivery	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.	$0.56 per 1,000 requests	id · username · url · name · type · is_verified · is_premium · is_scam · is_fake · last_seen_at · platform

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.

What do the Telegram `channel_posts` parameters mean?

Retrieve channel posts from Telegram. Accepts these parameters: username. Returns these fields: is_paid, forwarded_from, emoji, and view_count.

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 CountsOfficial 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 2026-09-04
Telegram Official: Content Access Remains Subject to Licensing TermsLimited 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 2026-09-04

What do the Telegram `profile` parameters mean?

Retrieve public channel details from Telegram. Accepts these parameters: username. Returns these fields: username, name, video_count, and subscriber_count.

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 CountsOfficial 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 2026-09-04

What do the Telegram `search` parameters mean?

Search public results on Telegram. Accepts these parameters: keyword, since, and until. Returns these fields: text, channel_subscriber_count, emoji, and count.

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 RestrictionsOfficial 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 2026-09-04
sinceOptional: Sets the lower message date bound (afterDate) for the search action. It does not filter by group creation date and is not available on the primary channel_posts action path.
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?

Retrieve public group details from Telegram. Accepts these parameters: username. Returns these fields: is_verified, description, type, and is_forum.

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 SettingsOfficial 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 2026-09-04

What do the Telegram `members` parameters mean?

Retrieve public member details from Telegram. Accepts these parameters: username. Returns these fields: is_verified, username, is_scam, and is_fake.

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 SettingsOfficial 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 2026-09-04
Telegram Official: Content Access Remains Subject to Licensing TermsLimited 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 2026-09-04

How to use the Telegram API

01Read the public catalog and choose a platform action.
02Send the platform, action, and required parameters to POST /api/v1/social.
03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
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 source record, and every other action has its own field list.

Does every Telegram action return immediately?

No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douban API Douyin API View the public catalog →