Telegram Channel Scraper
Telegram Channel Scraper는 공개 방송형 채널의 피드를 읽으며, 각 게시물에는 본문, 게시 시각, 조회수, 반응 합계, 사진이나 동영상이 담겨 있습니다. 여러 게시물의 조회수와 반응을 보면 채널 독자가 실제로 무엇을 읽고 반응하는지 알 수 있어 일일 요약, 콘텐츠 벤치마킹, 과거 아카이브 구축에 활용됩니다.
Telegram Channel Scraper API 주요 기능
- 최신 게시물부터 최대 1000개results_limit으로 수집할 개수를 1~1000(기본 20) 사이에서 정하며, 가장 최근 게시물부터 거슬러 올라가며 읽습니다.
- 정수로 받는 조회수metrics.views_count는 661K 같은 텔레그램 축약 표기를 정수로 바꿔 주므로 게시물끼리 바로 비교하고 합산할 수 있습니다.
- Star를 포함한 반응 합계metrics.likes_count는 게시물에 달린 모든 반응을 이모지 반응과 유료 Star 반응 구분 없이 하나의 참여 수치로 합산합니다.
- 게시물별 사진과 동영상media는 첨부 항목마다 image 또는 video 유형과 파일 직접 URL을 담습니다.
- 안정적인 게시물 ID각 행의 id는 durov/564처럼 채널과 게시물 번호를 합친 값이며, url은 게시물로 바로 연결됩니다.
Telegram Channel Scraper API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | 공개 텔레그램 채널 링크 하나입니다. 예: https://t.me/durov. t.me/s/, telegram.me, telegram.dog 형식도 쓸 수 있습니다. |
results_limit | 선택 | 수집할 게시물 수이며 최신순으로 정렬됩니다. 1~1000 사이의 정수, 기본값은 20입니다. |
Telegram Channel Scraper API 사용 방법
채널 링크와 수집 개수를 보내고 게시물을 최신순으로 읽습니다.
- {"url": "https://t.me/durov", "results_limit": 20}을 /v1/telegram/channel-posts로 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-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://t.me/durov","results_limit":20}'Telegram Channel Scraper API 추천 활용 사례
- 채널 일일 요약: 매일 아침 최근 게시물 20~50개를 가져와 뉴스나 시세 채널들이 밤사이 올린 내용을 요약합니다.
- 조회수 기반 콘텐츠 벤치마킹: 최근 게시물을 views_count와 likes_count로 정렬해 독자를 붙잡는 형식과 주제를 파악합니다.
- 채널 아카이브 백필: 처음 한 번 큰 results_limit으로 채널 이력을 확보하고, 이후 실행에서는 새 게시물만 수집합니다.
- 공지 채널 모니터링: 프로젝트나 브랜드 채널에 새 게시물이 올라오면 본문과 링크를 알림이나 리서치 데이터베이스로 보냅니다.
Telegram Channel Scraper API 활용 팁
- published_at을 이전 실행 시각과 비교해 이미 저장한 게시물에 닿으면 저장을 멈추세요. 정기 실행의 데이터 양과 비용이 줄어듭니다.
- 보관할 사진과 동영상은 수집 직후 내려받으세요. 텔레그램 파일 링크는 일정 시간이 지나면 만료됩니다.
- 조회수와 반응은 수집 시점의 값이므로 스냅샷마다 collected_at을 함께 저장하고, 게시 시기가 비슷한 게시물끼리 비교하세요.
관련 API
Telegram Channel Scraper API 외에 Telegram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Telegram Channel Info API — 링크로 공개 텔레그램 채널을 최대 50개까지 조회해 제목, 설명, 프로필 이미지, 인증 배지, 정수로 변환된 구독자 수를 가져옵니다.
- Telegram Post Detail API — 링크로 특정 텔레그램 게시물을 최대 50개 가져오며, 여러 공개 채널을 섞을 수 있고 전체 본문, 게시 시각, 조회수, 반응, 미디어를 포함합니다.
- Telegram Comments API — 텔레그램 채널 게시물의 댓글을 토론 그룹에서 최대 100개 수집하며 작성자 이름, 본문, 시각, 반응, 답글 대상을 포함합니다.
- Telegram Similar Channels API — 공개 채널 옆에 텔레그램이 추천하는 채널을 보통 10개 안팎으로 찾아 제목, 인증 배지, 정확한 구독자 수를 가져옵니다.
- Telegram Channel Search API — 공개 텔레그램 채널의 전체 게시물 기록에서 단어나 문구를 검색해 일치하는 게시물을 최대 100개, 본문, 날짜, 조회수, 반응과 함께 가져옵니다.