telegram/
channel-search

공개 텔레그램 채널의 전체 게시물 기록에서 단어나 문구를 검색해 일치하는 게시물을 최대 100개, 본문, 게시 날짜, 조회수, 반응과 함께 반환합니다.

Telegram Channel Search API

채널 전체 기록
최대 100개 일치
조회수와 반응
일치 없으면 과금 없음
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Telegram Channel Search

Telegram Channel Search는 공개 채널이 지금까지 올린 모든 게시물에서 단어나 문구를 찾아 일치하는 게시물을 본문, 게시 날짜, 조회수, 반응과 함께 돌려줍니다. 아무리 오래된 언급이라도 찾을 수 있어 영향력 있는 채널이 어떤 프로젝트를 다룬 적이 있는지, 특정 주제를 얼마나 자주 다루는지, 언급마다 관심을 얼마나 받았는지 알 수 있습니다.

Telegram Channel Search API 주요 기능

  • 전체 기록 검색query는 채널이 올린 모든 게시물을 대상으로 하므로 몇 년 전 언급도 오늘 게시물처럼 찾아냅니다.
  • 최대 100개 일치 게시물results_limit으로 반환할 일치 개수를 1~100(기본 20) 사이에서 정합니다.
  • 일치 게시물별 조회수와 반응일치한 게시물마다 metrics.views_count와 metrics.likes_count가 있어 그 언급이 받은 관심을 보여 줍니다.
  • 일치한 만큼만 과금일치한 게시물 하나당 0.5 크레딧이며, 아무것도 찾지 못한 검색은 비용이 없습니다.

Telegram Channel Search API 매개변수

매개변수필수설명
url필수검색할 공개 텔레그램 채널 링크 하나입니다. 예: https://t.me/durov. t.me/s/, telegram.me, telegram.dog 링크도 쓸 수 있습니다.
query필수채널 게시물에서 찾을 단어나 문구입니다. 예: TON.
results_limit선택반환할 일치 게시물 수입니다. 1~100 사이의 정수, 기본값은 20입니다.

Telegram Channel Search API 사용 방법

채널 링크와 검색어를 보내고 일치하는 게시물을 읽습니다.

  1. {"url": "https://t.me/durov", "query": "TON", "results_limit": 20}을 /v1/telegram/channel-search로 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-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://t.me/durov","query":"TON","results_limit":20}'

Telegram Channel Search API 추천 활용 사례

  • 프로젝트 언급 여부 확인: 제휴를 제안하기 전에 인플루언서나 뉴스 채널에서 토큰, 제품, 브랜드 이름을 검색합니다.
  • 출시 관련 게시물 모으기: 제품 출시나 이벤트에 관해 채널이 올린 게시물을 모두 한 목록으로 모아 회고에 씁니다.
  • 광고 집행 전 채널 실사: 게재 지면을 사기 전에 채널이 과거 경쟁사나 특정 주제를 홍보한 적이 있는지 검색해 이력을 파악합니다.
  • 채널 간 주제 조사: 같은 검색어를 여러 채널에 실행해 언급 빈도와 해당 게시물의 조회수를 비교합니다.

Telegram Channel Search API 활용 팁

  • 티커와 프로젝트 정식 명칭을 따로 검색하면 채널에서 쓰는 두 가지 표기를 모두 잡을 수 있습니다.
  • 검색 결과의 사진은 그 사진을 보여 주는 게시물로 연결됩니다. 이미지 파일이 필요하면 그 게시물 url을 Telegram Post Detail API로 보내세요.
  • 검색 한 번은 채널 하나를 대상으로 합니다. 주제에 맞는 다른 채널을 찾으려면 아는 채널에서 시작해 Telegram Similar Channels API를 쓰세요.

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

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

다른 플랫폼 둘러보기

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

Telegram Channel Search API — 자주 묻는 질문

Telegram Channel Search API는 공개 텔레그램 채널 하나의 전체 게시물 기록에서 단어나 문구를 검색하는 프로그래밍 인터페이스입니다. 일치하는 게시물을 최대 100개, 본문, 게시 날짜, 조회수, 반응과 함께 반환합니다.

url로 넘긴 채널 안을 그 채널의 전체 기록에 걸쳐 검색합니다. 주제별로 새 채널을 찾으려면 아는 채널에서 시작해 Telegram Similar Channels API를 쓰세요.

일치하는 게시물을 최대 100개까지 받을 수 있으며 results_limit으로 지정합니다. 기본값은 20개입니다.

검색 결과의 사진은 그 사진을 보여 주는 게시물로 연결됩니다. 그 게시물 링크를 Telegram Post Detail API로 넘기면 이미지 파일 자체를 받을 수 있습니다.

반환된 일치 게시물 하나당 0.5 크레딧이며, 기본값 20개는 10 크레딧입니다. 일치하는 게시물이 없으면 비용이 없습니다.