플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Telegram 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
채널 게시물channel_posts | 공개 Telegram 채널에 게시된 메시지를 읽어 옵니다. | 요청 1,000개당 $0.56 | 정상 |
프로필profile | 공개 Telegram 채널의 규모를 확인합니다. | 요청 1,000개당 $0.56 | 정상 |
검색search | 키워드로 공개 Telegram 채널 전반의 메시지를 검색합니다. | 요청 1,000개당 $0.56 | 정상 |
그룹group | Telegram 그룹이나 채널의 정보 카드를 조회합니다. | 요청 1,000개당 $0.56 | 정상 |
멤버members | 공개 Telegram 그룹에서 볼 수 있는 멤버를 나열하며, 사용자 이름, 이름, 계정 유형, Premium·사기·가짜 플래그, 마지막 접속 시각을 제공합니다. | 요청 1,000개당 $0.56 | 정상 |
게시물 상세 정보post_detail | https://t.me/durov/520 같은 링크로 공개 Telegram 채널의 메시지 하나를 읽어 옵니다. | 요청 1,000개당 $0.81 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Telegram 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
channel_posts채널 게시물 공개 Telegram 채널에 게시된 메시지를 읽어 옵니다. 각 게시물에는 본문, 조회수, 미디어, 반응, 전달 출처가 포함됩니다. 비공개 초대 링크는 지원하지 않습니다. 한 번에 채널 전체 기록을 가져오지 못할 수 있습니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | 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 |
profile프로필 공개 Telegram 채널의 규모를 확인합니다. 구독자 수, 사진·동영상·링크 수, 소개, 아바타, 인증 상태를 받을 수 있습니다. name, @name, t.me/name 또는 t.me/s/name 형식을 지원합니다. 비공개 채팅, 전화번호, 멤버 이름은 가져올 수 없습니다. | username | — | Sync 응답 | — | 요청 1,000개당 $0.56 | username · name · bio · subscriber_count · photo_count · video_count · link_count · is_verified · avatar_url · url · platform |
search검색 키워드로 공개 Telegram 채널 전반의 메시지를 검색합니다. 각 결과에는 채널 이름, 유형, 구독자 수, 조회수, 반응, 미디어가 포함됩니다. | keyword | since, until | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · text · posted_at · view_count · media_url · reactions · channel_username · channel_title · channel_type · channel_subscriber_count · channel_description · platform |
group그룹 Telegram 그룹이나 채널의 정보 카드를 조회합니다. 제목, 설명, 멤버 수와 접속 중인 멤버 수, 생성일, 사기·가짜·인증 플래그를 받을 수 있습니다. 비공개 초대 링크는 지원하지 않으며, 호출 시 그룹에 참여하거나 제한된 콘텐츠를 열지 않습니다. | username | — | Sync 응답 | — | 요청 1,000개당 $0.56 | 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멤버 공개 Telegram 그룹에서 볼 수 있는 멤버를 나열하며, 사용자 이름, 이름, 계정 유형, Premium·사기·가짜 플래그, 마지막 접속 시각을 제공합니다. 목록은 일부일 수 있으며, 전화번호는 멤버가 공개한 경우에만 표시됩니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=100, maxLimit=5000. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · username · url · name · type · is_verified · is_premium · is_scam · is_fake · last_seen_at · phone · platform |
post_detail게시물 상세 정보 https://t.me/durov/520 같은 링크로 공개 Telegram 채널의 메시지 하나를 읽어 옵니다. 본문, 조회수, 게시 시각, 미디어 유형과 링크, 작성자 서명, 전달 출처, 답장 링크, 링크 미리보기, 반응과 반응 수를 받을 수 있습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $0.81 | 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 |
Telegram channel_posts 파라미터는 각각 무엇을 의미하나요?
공개 Telegram 채널에 게시된 메시지를 읽어 옵니다. 각 게시물에는 본문, 조회수, 미디어, 반응, 전달 출처가 포함됩니다. 비공개 초대 링크는 지원하지 않습니다. 한 번에 채널 전체 기록을 가져오지 못할 수 있습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- name, @name, t.me/name, t.me/s/name 등의 형식으로 대상 공개 채널 또는 그룹을 지정합니다. channel_posts와 profile에서는 공개 채널에, group에서는 공개 엔티티 메타데이터에, members에서는 표시되는 그룹 멤버를 가져오는 데 사용합니다. 비공개 초대 링크는 지원하지 않으며 전체 멤버 목록을 보장하지 않습니다.Telegram 공식 문서: 채널, 공개 사용자 이름, 조회수 — Telegram 공식 문서는 공개 채널과 초대 전용 비공개 채널을 구분하며, 채널은 브로드캐스트 도구로 작동하고 조회수는 전달된 사본을 포함한 근사치라고 설명합니다. 이는 채널 객체와 view_count 파라미터를 설명하지만, 이 엔드포인트가 채널의 전체 기록이나 비공개 콘텐츠를 읽을 수 있음을 증명하지는 않습니다. · 확인일Telegram 공식 약관: 콘텐츠 접근에도 라이선스 조건은 그대로 적용된다 — 서드파티 클라이언트, 봇, Mini Apps에 대한 공식 예외는 제한적이며, 기능 운영에 꼭 필요한 데이터만 대상으로 하고 약관, 저작권, 개인정보 보호 규칙의 적용을 받습니다. API 엔드포인트가 존재한다는 사실만으로 플랫폼 데이터의 스크래핑, 재판매, 임의 재사용이 허가되는 것은 아닙니다. · 확인일
Telegram profile 파라미터는 각각 무엇을 의미하나요?
공개 Telegram 채널의 규모를 확인합니다. 구독자 수, 사진·동영상·링크 수, 소개, 아바타, 인증 상태를 받을 수 있습니다. name, @name, t.me/name 또는 t.me/s/name 형식을 지원합니다. 비공개 채팅, 전화번호, 멤버 이름은 가져올 수 없습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- name, @name, t.me/name, t.me/s/name 등의 형식으로 대상 공개 채널 또는 그룹을 지정합니다. channel_posts와 profile에서는 공개 채널에, group에서는 공개 엔티티 메타데이터에, members에서는 표시되는 그룹 멤버를 가져오는 데 사용합니다. 비공개 초대 링크는 지원하지 않으며 전체 멤버 목록을 보장하지 않습니다.Telegram 공식 문서: 채널, 공개 사용자 이름, 조회수 — Telegram 공식 문서는 공개 채널과 초대 전용 비공개 채널을 구분하며, 채널은 브로드캐스트 도구로 작동하고 조회수는 전달된 사본을 포함한 근사치라고 설명합니다. 이는 채널 객체와 view_count 파라미터를 설명하지만, 이 엔드포인트가 채널의 전체 기록이나 비공개 콘텐츠를 읽을 수 있음을 증명하지는 않습니다. · 확인일
Telegram search 파라미터는 각각 무엇을 의미하나요?
키워드로 공개 Telegram 채널 전반의 메시지를 검색합니다. 각 결과에는 채널 이름, 유형, 구독자 수, 조회수, 반응, 미디어가 포함됩니다. since와 until로 기간을 좁힐 수 있습니다. 비공개 채팅은 검색하지 않으며, 결과가 Telegram 전체를 대표하지는 않습니다.
keyword필수- 공개 채널에서 search 액션으로 검색할 메시지 검색어를 지정합니다. 연락처 목록이나 비공개 채팅은 검색하지 않습니다.Telegram 공식 약관: 콘텐츠 라이선스와 AI 활용 제한 — Telegram 공식 약관은 플랫폼의 정상적인 사용 목적을 넘어서는 콘텐츠 접근을 제한하고, AI 모델의 학습, 검증, 개선, 벤치마킹, 배포를 위해 플랫폼 데이터를 스크래핑하거나 집계하는 행위를 금지합니다. 예외를 적용하려면 콘텐츠와 맥락별로 관련 사용자의 명시적이고 지속적인 동의가 필요하며, 공개되어 있다고 해서 일반적인 이용 라이선스가 부여되지는 않습니다. · 확인일
since선택- search 액션의 메시지 날짜 하한을 설정합니다. 그룹 생성일로 필터링하지 않으며, channel_posts에는 날짜 필터가 없습니다.
until선택- search 액션의 메시지 날짜 상한(beforeDate)을 설정합니다. since와 함께 사용해 공개 메시지 결과를 좁히며, 지정한 기간의 메시지를 모두 가져온다고 보장하지 않습니다.
Telegram group 파라미터는 각각 무엇을 의미하나요?
Telegram 그룹이나 채널의 정보 카드를 조회합니다. 제목, 설명, 멤버 수와 접속 중인 멤버 수, 생성일, 사기·가짜·인증 플래그를 받을 수 있습니다. 비공개 초대 링크는 지원하지 않으며, 호출 시 그룹에 참여하거나 제한된 콘텐츠를 열지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- name, @name, t.me/name, t.me/s/name 등의 형식으로 대상 공개 채널 또는 그룹을 지정합니다. channel_posts와 profile에서는 공개 채널에, group에서는 공개 엔티티 메타데이터에, members에서는 표시되는 그룹 멤버를 가져오는 데 사용합니다. 비공개 초대 링크는 지원하지 않으며 전체 멤버 목록을 보장하지 않습니다.Telegram 공식 문서: 그룹, 사용자 이름, 마지막 접속 시간 공개 설정 — Telegram 공식 문서는 공개 사용자 이름과 t.me 링크를 자세히 설명하며, 마지막 접속 상태는 숨기거나 대략적인 시간 범위만 표시하도록 설정할 수 있다고 안내합니다. 멤버의 last_seen_at 필드로 정확한 활동 기록을 재구성할 수 없으며, 공개 사용자 이름이 있다고 해서 공개 전화번호에 접근할 수 있는 것도 아닙니다. · 확인일
Telegram members 파라미터는 각각 무엇을 의미하나요?
공개 Telegram 그룹에서 볼 수 있는 멤버를 나열하며, 사용자 이름, 이름, 계정 유형, Premium·사기·가짜 플래그, 마지막 접속 시각을 제공합니다. 목록은 일부일 수 있으며, 전화번호는 멤버가 공개한 경우에만 표시됩니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- name, @name, t.me/name, t.me/s/name 등의 형식으로 대상 공개 채널 또는 그룹을 지정합니다. channel_posts와 profile에서는 공개 채널에, group에서는 공개 엔티티 메타데이터에, members에서는 표시되는 그룹 멤버를 가져오는 데 사용합니다. 비공개 초대 링크는 지원하지 않으며 전체 멤버 목록을 보장하지 않습니다.Telegram 공식 문서: 그룹, 사용자 이름, 마지막 접속 시간 공개 설정 — Telegram 공식 문서는 공개 사용자 이름과 t.me 링크를 자세히 설명하며, 마지막 접속 상태는 숨기거나 대략적인 시간 범위만 표시하도록 설정할 수 있다고 안내합니다. 멤버의 last_seen_at 필드로 정확한 활동 기록을 재구성할 수 없으며, 공개 사용자 이름이 있다고 해서 공개 전화번호에 접근할 수 있는 것도 아닙니다. · 확인일Telegram 공식 약관: 콘텐츠 접근에도 라이선스 조건은 그대로 적용된다 — 서드파티 클라이언트, 봇, Mini Apps에 대한 공식 예외는 제한적이며, 기능 운영에 꼭 필요한 데이터만 대상으로 하고 약관, 저작권, 개인정보 보호 규칙의 적용을 받습니다. API 엔드포인트가 존재한다는 사실만으로 플랫폼 데이터의 스크래핑, 재판매, 임의 재사용이 허가되는 것은 아닙니다. · 확인일
Telegram post_detail 파라미터는 각각 무엇을 의미하나요?
https://t.me/durov/520 같은 링크로 공개 Telegram 채널의 메시지 하나를 읽어 옵니다. 본문, 조회수, 게시 시각, 미디어 유형과 링크, 작성자 서명, 전달 출처, 답장 링크, 링크 미리보기, 반응과 반응 수를 받을 수 있습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수post_detail에 사용할 공개 채널 메시지 하나의 링크로, https://t.me/<channel>/<message ID> 형식입니다. t.me/s/ 링크도 사용할 수 있습니다.
Telegram API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
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 자주 묻는 질문
Telegram API로 무엇을 가져올 수 있나요?
platform을 telegram 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 채널 게시물, 프로필, 검색, 그룹, 멤버 및 more입니다. 각 액션 이름은 서로 다른 Telegram 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Telegram channel_posts 요청에는 어떤 입력이 필요한가요?
name, @name, t.me/name, t.me/s/name 등의 형식으로 대상 공개 채널 또는 그룹을 지정합니다. channel_posts와 profile에서는 공개 채널에, group에서는 공개 엔티티 메타데이터에, members에서는 표시되는 그룹 멤버를 가져오는 데 사용합니다. 비공개 초대 링크는 지원하지 않으며 전체 멤버 목록을 보장하지 않습니다. params 안의 username 필드로 전달하세요.
Telegram channel_posts 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 channel_username, channel_title, text 및 view_count입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Telegram 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.