Telegram Channel Info
Telegram Channel Info는 방송형 채널이 공개한 프로필로, 사용자 이름, 제목, 설명, 프로필 이미지, 인증 배지, 구독자 수로 이루어집니다. 이 몇 가지 신호로 채널 규모, 텔레그램 인증 여부, 어떤 내용을 올리는지 알 수 있어 스폰서 전 채널 검토, 관심 채널 목록 관리, 채널 목록 보강에 활용됩니다.
Telegram Channel Info API 주요 기능
- 작업 하나에 최대 50개 채널urls에는 t.me/name, t.me/s/name, telegram.me, telegram.dog 링크를 섞어 넣을 수 있고, 중복된 채널은 한 번만 조회되며 찾은 채널마다 행 하나가 반환됩니다.
- 정수로 받는 구독자 수metrics.followers_count는 텔레그램의 9.95M 같은 축약 표기를 9950000 같은 정수로 바꿔 주므로 정렬, 필터, 기준값 설정에 바로 쓸 수 있습니다.
- 식별 정보와 인증 여부를 한 행에username, name, text, avatar_url이 채널 자체를 설명하고, is_verified는 텔레그램 인증 배지가 있는지 알려 줍니다.
- 읽을 수 없는 링크는 건너뛰고 과금 없음비공개이거나 삭제된 채널 링크는 결과에서 빠지고 과금되지 않으며, 같은 배치의 다른 채널은 평소처럼 반환됩니다.
Telegram Channel Info API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 텔레그램 채널 링크 최대 50개입니다. 예: https://t.me/durov, https://t.me/s/durov. telegram.me와 telegram.dog 링크도 쓸 수 있으며 중복된 채널은 한 번만 조회됩니다. |
Telegram Channel Info API 사용 방법
채널 링크 목록을 보내고 찾은 채널마다 행 하나씩 읽습니다.
- {"urls": ["https://t.me/durov", "https://t.me/tginfo"]}을 /v1/telegram/channel-info로 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- results.items에서 채널을 읽고, has_more 값이 true인 동안 results.next_cursor를 넘겨 다음 페이지를 불러옵니다.
curl -X POST "https://api.socq.ai/v1/telegram/channel-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://t.me/durov","https://t.me/tginfo"]}'Telegram Channel Info API 추천 활용 사례
- 스폰서 전 채널 검토: 유료 게재에 합의하기 전에 구독자 수, 인증 상태, 채널 설명을 나란히 확인합니다.
- 관심 채널 목록 최신화: 같은 목록을 정기적으로 다시 실행하고 followers_count를 collected_at과 함께 저장해 암호화폐, 뉴스, 특정 분야 채널의 성장을 추적합니다.
- 다른 곳에서 모은 링크 보강: 스프레드시트, 검색 결과, 파트너 목록에 있는 t.me 링크 열을 제목, 설명, 구독자 규모로 바꿉니다.
Telegram Channel Info API 활용 팁
- 반환된 username을 키로 쓰세요. t.me/name과 t.me/s/name은 같은 채널을 가리키고 id도 같아서 여러 번 조회한 기록을 그대로 합칠 수 있습니다.
- https://t.me/durov/510 같은 게시물 링크는 해당 채널로 조회됩니다. 게시물 자체가 필요하면 Telegram Post Detail API로 보내세요.
관련 API
Telegram Channel Info API 외에 Telegram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Telegram Channel Scraper API — 공개 텔레그램 채널의 게시물을 최신순으로 최대 1000개 수집하며 본문, 게시 시각, 조회수, 반응 합계, 사진과 동영상을 포함합니다.
- Telegram Post Detail API — 링크로 특정 텔레그램 게시물을 최대 50개 가져오며, 여러 공개 채널을 섞을 수 있고 전체 본문, 게시 시각, 조회수, 반응, 미디어를 포함합니다.
- Telegram Comments API — 텔레그램 채널 게시물의 댓글을 토론 그룹에서 최대 100개 수집하며 작성자 이름, 본문, 시각, 반응, 답글 대상을 포함합니다.
- Telegram Similar Channels API — 공개 채널 옆에 텔레그램이 추천하는 채널을 보통 10개 안팎으로 찾아 제목, 인증 배지, 정확한 구독자 수를 가져옵니다.
- Telegram Channel Search API — 공개 텔레그램 채널의 전체 게시물 기록에서 단어나 문구를 검색해 일치하는 게시물을 최대 100개, 본문, 날짜, 조회수, 반응과 함께 가져옵니다.