telegram/
post-detail

링크로 특정 텔레그램 게시물을 가져옵니다. 작업당 최대 50개, 여러 공개 채널의 게시물을 섞을 수 있으며 각각 전체 본문, 게시 시각, 조회수, 반응 합계, 미디어를 반환합니다.

Telegram Post Detail API

요청당 최대 50개 게시물
여러 채널 혼합
조회수와 반응
사진과 동영상
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Telegram Post Detail

Telegram Post Detail은 채널 게시물 하나의 전체 기록으로, 본문, 게시 시각, 조회수, 반응 합계, 첨부된 사진이나 동영상을 담고 있습니다. 이미 알고 있는 게시물에서 이 값을 읽으면 캠페인 게시물 수치를 갱신하고, 공지 내용을 기록하고, 보유한 링크에 도달 수치를 붙일 수 있습니다.

Telegram Post Detail API 주요 기능

  • 여러 채널의 게시물을 한 번에urls에는 t.me/channel/post_id 형식의 게시물 링크를 최대 50개 넣을 수 있고, 같은 요청 안에서 서로 다른 채널의 링크를 섞을 수 있습니다.
  • 현재 조회수와 반응metrics.views_count와 metrics.likes_count가 수집 시점의 조회수와 반응 합계를 정수로 알려 줍니다.
  • 전체 본문과 미디어text에는 게시물 본문 전체가, media에는 사진이나 동영상마다 유형과 파일 URL이 들어갑니다.
  • 찾을 수 없는 게시물은 건너뛰고 과금 없음삭제된 게시물과 비공개 채널의 게시물은 제외되고 과금되지 않습니다. 작업이 실패하고 환불되는 것은 모든 링크를 읽을 수 없을 때뿐입니다.

Telegram Post Detail API 매개변수

매개변수필수설명
urls필수t.me/channel/post_id 형식의 텔레그램 게시물 링크 최대 50개입니다. 예: https://t.me/durov/510. 서로 다른 공개 채널의 링크를 섞어도 됩니다.

Telegram Post Detail API 사용 방법

필요한 게시물 링크를 보내고 찾은 게시물마다 전체 기록을 하나씩 읽습니다.

  1. {"urls": ["https://t.me/durov/510"]}을 /v1/telegram/post-detail로 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/post-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://t.me/durov/510"]}'

Telegram Post Detail API 추천 활용 사례

  • 캠페인 게시물 수치 갱신: 스폰서 게시물이나 공지 게시물의 링크를 저장해 두고 정기적으로 다시 수집해 조회수와 반응의 추이를 봅니다.
  • 게시물 내용 기록: 보고서, 분쟁 대응, 뉴스에서 인용된 게시물의 본문과 게시 시각을 collected_at과 함께 저장합니다.
  • 공유된 게시물 링크 보강: 채팅, 기사, 스프레드시트에서 모은 게시물 링크를 출처 채널, 도달 수치, 미디어가 담긴 전체 기록으로 바꿉니다.

Telegram Post Detail API 활용 팁

  • 여러 채널의 링크는 하나씩 보내지 말고 최대 50개짜리 요청 하나로 묶으세요.
  • author.username은 각 게시물이 속한 채널을 나타내므로 섞인 배치를 채널별로 묶을 때 편리합니다.
  • 링크를 모르는 상태에서 채널의 최신 게시물을 모으려면 Telegram Channel Scraper API를 쓰고, Post Detail은 이미 특정한 게시물에 쓰세요.

Telegram Post Detail API 외에 Telegram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Telegram Channel Info API — 링크로 공개 텔레그램 채널을 최대 50개까지 조회해 제목, 설명, 프로필 이미지, 인증 배지, 정수로 변환된 구독자 수를 가져옵니다.
  • Telegram Channel Scraper API — 공개 텔레그램 채널의 게시물을 최신순으로 최대 1000개 수집하며 본문, 게시 시각, 조회수, 반응 합계, 사진과 동영상을 포함합니다.
  • Telegram Comments API — 텔레그램 채널 게시물의 댓글을 토론 그룹에서 최대 100개 수집하며 작성자 이름, 본문, 시각, 반응, 답글 대상을 포함합니다.
  • Telegram Similar Channels API — 공개 채널 옆에 텔레그램이 추천하는 채널을 보통 10개 안팎으로 찾아 제목, 인증 배지, 정확한 구독자 수를 가져옵니다.
  • Telegram Channel Search API — 공개 텔레그램 채널의 전체 게시물 기록에서 단어나 문구를 검색해 일치하는 게시물을 최대 100개, 본문, 날짜, 조회수, 반응과 함께 가져옵니다.

다른 플랫폼 둘러보기

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

Telegram Post Detail API — 자주 묻는 질문

Telegram Post Detail API는 공개 텔레그램 채널의 특정 게시물을 링크로 요청당 최대 50개까지 가져오는 프로그래밍 인터페이스입니다. 각 게시물의 본문, 게시 시각, 조회수, 반응 합계, 미디어를 반환합니다.

https://t.me/durov/510처럼 채널 이름과 게시물 번호가 들어간 링크를 넣습니다. 같은 링크의 t.me/s/, telegram.me, telegram.dog 형식도 쓸 수 있습니다.

네. 최대 50개의 링크를 자유롭게 섞을 수 있으며, 각 행의 author 필드로 게시물이 어느 채널에서 왔는지 알 수 있습니다.

건너뛰고 과금하지 않으며, 나머지 게시물은 정상적으로 반환됩니다. 모든 링크를 읽을 수 없으면 작업이 실패하고 크레딧이 환불됩니다.

반환된 게시물 하나당 0.5 크레딧이며, 읽을 수 있는 게시물 50개를 꽉 채운 배치는 25 크레딧입니다.