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 사용 방법
채널 링크와 검색어를 보내고 일치하는 게시물을 읽습니다.
- {"url": "https://t.me/durov", "query": "TON", "results_limit": 20}을 /v1/telegram/channel-search로 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-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를 쓰세요.
관련 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개 안팎으로 찾아 제목, 인증 배지, 정확한 구독자 수를 가져옵니다.