Telegram Public Data API
t.me 링크로 공개 텔레그램 채널을 읽습니다. 구독자 수가 담긴 채널 정보, 조회수와 반응이 담긴 게시물, 개별 게시물, 토론 그룹 댓글, 추천 채널, 전체 기록 검색을 지원합니다.
사용할 수 있는 Telegram API
Channel Info, Channel Scraper, Similar Channels, Channel Search는 채널 링크로 시작하고, Post Detail과 Comments는 게시물 링크로 시작합니다. 모든 결과에는 다음 엔드포인트로 바로 넘길 수 있는 링크가 들어 있습니다.
어떤 텔레그램 데이터를 가져올 수 있나요?
각 엔드포인트는 공개 채널이 누구에게나 보여 주는 내용으로 만든 안정적인 SocQ 기록을 반환합니다.
채널 정보
사용자 이름, 제목, 설명, 프로필 이미지, 인증 배지, 정수로 변환된 구독자 수를 요청당 최대 50개 채널까지 반환합니다.
게시물과 미디어
본문, 게시 시각, 조회수, 유료 Star 반응을 포함한 반응 합계, 사진과 동영상 링크를 최신순으로 최대 1000개, 또는 링크 지정으로 최대 50개 가져옵니다.
토론 그룹 댓글
게시물 하나당 최대 100개 댓글의 작성자 이름, 본문, 시각, 반응과 함께 답글 스레드를 재구성할 parent_id와 post_id를 반환합니다.
추천 채널
텔레그램이 채널 옆에 추천하는 채널을 보통 10개 안팎으로, 텔레그램이 보여 주는 순서와 정확한 구독자 수와 함께 반환합니다.
채널 내 검색
채널 하나의 전체 기록에서 단어나 문구와 일치하는 게시물을 최대 100개, 조회수와 반응과 함께 반환합니다.
SocQ와 Telegram API
텔레그램 자체 API는 텔레그램 앱과 봇을 만들기 위한 것입니다. SocQ는 공개 채널 데이터를 저장, 비교, 결합하기 쉬운 정규화된 기록으로 반환합니다.
| 기능 | SocQ | Telegram API |
|---|---|---|
| 접근 방식 | SocQ API 키 | 텔레그램 앱 ID와 로그인된 계정, 또는 봇 토큰 |
| 시작 입력 | 공개 t.me 채널 링크와 게시물 링크 | 클라이언트 세션 안에서 확인한 텔레그램 객체 식별자 |
| 출력 | 수치가 정수로 담긴 정규화된 JSON 기록 | 텔레그램 고유 객체 |
| 작동 방식 | 결과를 저장하고 페이지로 읽는 비동기 작업 | 직접 운영하는 클라이언트의 실시간 호출 |
Telegram API 작동 방식
여섯 엔드포인트 모두 같은 비동기 제출, 폴링, 읽기 흐름을 따릅니다.
1. 링크에서 시작
채널 링크는 Channel Info, Channel Scraper, Similar Channels, Channel Search로, 게시물 링크는 Post Detail이나 Comments로 보냅니다.
2. 작업 폴링
반환된 task_id로 /v1/tasks/{task_id}를 호출해 처리가 성공하거나 실패할 때까지 기다립니다.
3. 결과 연결
Channel Scraper나 Channel Search의 게시물 url은 Comments나 Post Detail로, Similar Channels의 채널 url은 Channel Info로 넘깁니다.
SocQ API 키로 인증합니다. Channel Scraper는 기본 20개 게시물을 반환하며 최대 1000개까지 받을 수 있습니다.
curl -X POST "https://api.socq.ai/v1/telegram/channel-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://t.me/durov","results_limit":20}'
# 이어서 게시물 하나의 댓글을 읽습니다:
# POST /v1/telegram/post-comments
# {"url":"https://t.me/tginfo/4455"}
# GET /v1/tasks/{task_id} 폴링Telegram API 주요 활용 사례
스폰서 전 채널 검토
Channel Info로 구독자 수와 인증 여부를 확인하고 Channel Scraper로 최근 게시물 조회수를 본 뒤 유료 게재를 결정합니다.
채널 요약과 알림
뉴스, 시세, 프로젝트 채널의 최신 게시물을 정기적으로 모아 새 본문과 링크를 요약이나 알림으로 보냅니다.
커뮤니티 피드백
공지에 달린 댓글을 모아 주제별로 묶고, 독자의 반응과 반복되는 질문을 파악합니다.
분야 지형 정리
Similar Channels로 시드 채널에서 바깥쪽으로 넓혀 가며 구독자 규모가 붙은 관련 채널 목록을 만듭니다.
언급 조사
영향력 있는 채널에서 브랜드, 토큰, 제품 이름을 검색하고 언급마다 받은 관심을 측정합니다.
데이터 범위
결과는 수집 시점에 공개 텔레그램 채널이 누구에게나 보여 주는 내용을 반영합니다.
- 모든 엔드포인트는 공개 채널을 읽으며, 채널 사용자 이름이나 채널 안의 게시물 번호로 대상을 지정합니다.
- 댓글은 채널이 게시물에 연결한 토론 그룹에서 가져오며, 작업 하나에서 게시물당 최대 100개입니다.
- Similar Channels는 텔레그램이 해당 채널에 보여 주는 추천을 반환하며, 보통 10개 안팎입니다.
- Channel Search는 요청 하나로 채널 하나의 전체 기록을 검색하고 일치 항목을 최대 100개 반환합니다.
- 수치는 collected_at 시점의 스냅샷이고 사진과 동영상 파일 링크는 임시 링크이므로, 보관할 파일은 미리 내려받으세요.
Telegram API 자주 묻는 질문
Telegram API란 무엇인가요?
Telegram API는 공개 텔레그램 채널을 링크로 읽어 채널 정보, 게시물, 토론 그룹 댓글, 추천 채널, 채널 내 검색 결과를 정규화된 JSON 기록으로 반환하는 SocQ 엔드포인트 모음입니다.
어떤 Telegram API를 쓸 수 있나요?
Telegram Channel Info API, Telegram Channel Scraper API, Telegram Post Detail API, Telegram Comments API, Telegram Similar Channels API, Telegram Channel Search API입니다.
텔레그램 계정이나 봇 토큰이 필요한가요?
아니요. 요청에는 SocQ API 키와 공개 채널 또는 게시물 링크만 있으면 됩니다.
어떤 링크 형식을 지원하나요?
t.me/durov나 t.me/s/durov 같은 채널 링크와 그 telegram.me, telegram.dog 형식을 지원합니다. Post Detail과 Comments에는 t.me/durov/510 같은 게시물 링크를 씁니다.
구독자 수와 조회수는 어떤 형태로 반환되나요?
정수로 반환됩니다. 9.95M, 661K 같은 텔레그램 축약 표기는 정수로 바뀌며, Similar Channels는 정확한 구독자 수를 반환합니다.
엔드포인트별 요금은 어떻게 되나요?
Channel Info, Post Detail, Similar Channels, Channel Search는 반환된 결과 하나당 0.5 크레딧, Channel Scraper와 Comments는 게시물이나 댓글 하나당 0.3 크레딧입니다. 읽을 수 없는 링크는 건너뛰거나 환불되며, 댓글이 없는 게시물과 일치 항목이 없는 검색은 비용이 없습니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
Link in Bio API
크리에이터가 Instagram, TikTok, YouTube 소개란에 넣는 링크 하나를 표시 이름, 소개, 프로필 사진, 공개된 연락처 이메일, 연결된 SNS 프로필, 각 버튼의 제목과 연결 주소라는 구조화된 데이터로 바꿉니다.
Creator API
Instagram, TikTok, YouTube, X, Facebook, Threads 프로필 하나에서 출발해 크리에이터의 공개 비즈니스 이메일, 다른 SNS 계정, 프로필 사진 기반 나이·성별 추정을 가져옵니다.
Google Hotels API
목적지로 호텔을 검색하고, 원하는 호텔의 구글 호텔 프로필 전체와 1박 요금 캘린더를 가져옵니다. 세 API는 같은 호텔 ID로 연결됩니다.
Brand Monitoring API
브랜드, 제품, 주제를 언급한 웹 페이지를 찾아 페이지마다 감성과 감정을 점수로 매기고, 웹 전체에서 어떻게 이야기되는지 요약합니다.
AI Search API
AI 개요, ChatGPT, Google AI 모드가 시장의 질문에 어떻게 답하는지 추적합니다. 브랜드를 언급한 답변, 브랜드의 노출 수준, 답변이 인용한 도메인과 페이지를 알 수 있습니다.
Instagram API
공개 프로필을 조회하거나 찾고, 팔로워 목록 레코드, 팔로잉 관계, 작성 게시물, 프로필이 태그된 게시물, 해시태그 결과, 릴스, 스크립트, 댓글, 계정 수치, 참여도 지표, 미디어 메타데이터를 하나의 비동기 워크플로로 수집합니다.





