telegram/
channel-info

t.me 링크 최대 50개로 공개 텔레그램 채널을 조회해 채널마다 제목, 설명, 프로필 이미지, 인증 배지, 구독자 수를 한 번에 반환합니다.

Telegram Channel Info API

요청당 최대 50개 채널
숫자로 받는 구독자 수
인증 배지
t.me·t.me/s 링크
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용 방법

채널 링크 목록을 보내고 찾은 채널마다 행 하나씩 읽습니다.

  1. {"urls": ["https://t.me/durov", "https://t.me/tginfo"]}을 /v1/telegram/channel-info로 POST합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
  3. 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로 보내세요.

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개, 본문, 날짜, 조회수, 반응과 함께 가져옵니다.

다른 플랫폼 둘러보기

Telegram 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Telegram Channel Info API — 자주 묻는 질문

Telegram Channel Info API는 채널 링크로 공개 텔레그램 채널을 요청당 최대 50개까지 조회하는 프로그래밍 인터페이스입니다. 채널마다 사용자 이름, 제목, 설명, 프로필 이미지, 인증 배지, 구독자 수를 반환합니다.

t.me/name 또는 t.me/s/name 형식의 채널 링크와 telegram.me, telegram.dog 링크를 쓸 수 있습니다. 채널 사용자 이름은 영문자로 시작하는 5~32자입니다.

비공개이거나 삭제된 채널은 건너뛰고 과금하지 않으며, 나머지 채널은 정상적으로 반환됩니다. 모든 링크를 읽을 수 없으면 작업이 실패하고 크레딧이 환불됩니다.

텔레그램은 구독자 수를 9.95M 같은 축약형으로 표시하는 경우가 많으며, 이 값을 해당 정수로 바꿔 반환합니다. 텔레그램이 정확한 수치를 공개하면 그 값을 그대로 반환합니다.

반환된 채널 하나당 0.5 크레딧이며, 읽을 수 있는 링크가 50개라면 25 크레딧입니다. 건너뛴 링크는 비용이 없습니다.