telegram/
channel-posts

공개 텔레그램 채널의 게시물을 최신 글부터 거슬러 올라가며 작업당 최대 1000개 수집하고, 본문, 게시 시각, 조회수, 반응 합계, 첨부된 사진과 동영상을 반환합니다.

Telegram Channel Scraper API

최대 1000개 게시물
최신순
조회수와 반응
사진과 동영상
결과당 0.3 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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

채널 링크와 수집 개수를 보내고 게시물을 최신순으로 읽습니다.

  1. {"url": "https://t.me/durov", "results_limit": 20}을 /v1/telegram/channel-posts로 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-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을 함께 저장하고, 게시 시기가 비슷한 게시물끼리 비교하세요.

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

다른 플랫폼 둘러보기

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

Telegram Channel Scraper API — 자주 묻는 질문

Telegram Channel Scraper API는 공개 텔레그램 채널의 게시물을 최신순으로 작업당 최대 1000개까지 수집하는 프로그래밍 인터페이스입니다. 각 게시물에는 본문, 게시 시각, 조회수, 반응 합계, 첨부 미디어가 포함됩니다.

results_limit으로 1~1000개를 지정할 수 있으며 기본값은 20개입니다. 게시물은 최신순으로 반환되므로 작은 값을 넣으면 최근 활동을 볼 수 있습니다.

텔레그램에서 likes_count는 게시물에 달린 모든 반응의 합계로, 이모지 반응과 유료 Star 반응을 하나의 숫자로 합친 값입니다.

공개 채널이며, t.me/name, t.me/s/name, telegram.me, telegram.dog 형식의 링크로 지정합니다. 비공개 등의 이유로 채널을 읽을 수 없으면 작업이 실패하고 크레딧이 환불됩니다.

사진과 동영상 URL은 텔레그램 파일 서버를 가리키며 일정 시간이 지나면 만료됩니다. 필요한 파일은 작업이 끝난 뒤 바로 내려받으세요.

반환된 게시물 하나당 0.3 크레딧이며, 기본값 20개는 6 크레딧, 1000개는 300 크레딧입니다.