Telegram 스크래퍼 API
공개 텔레그램 채널의 프로필과 게시물 기록, 개별 게시물을 엔드포인트 3개로 다룹니다. 구독자 수는 반올림 없이 정확하게, 사진과 영상은 바로 열리는 주소로 돌아와요. 봇 토큰이나 전화번호, MTProto 세션 없이 호출당 1 credit면 됩니다.
한눈에 보기
SocialCrawl Telegram API는 Telegram 데이터를 구조화된 JSON으로 돌려드려요. x-api-key 하나로 3개 엔드포인트를 호출하고, 비용은 호출당 1크레딧부터예요. 다른 63개 플랫폼과 같은 통합 스키마를 쓰니까, 한 번 작성한 클라이언트 코드가 어디서든 그대로 동작해요.
SocialCrawl, 여기서 만나요
Telegram API, 브라우저에서 바로 써 보세요
실제 핸들을 넣고 진짜 요청을 보내, SocialCrawl이 돌려주는 JSON을 그대로 확인하세요. 가입도, 키도 필요 없어요. 프로덕션에서 받는 응답과 똑같이 와요.
공개 텔레그램 채널이나 그룹의 프로필을 반환합니다. 표시 이름과 소개글, 프로필 이미지 URL, 인증 배지, 정확한 구독자 수가 담깁니다.
핸들만 있고 채널 개요를 보고 싶을 때, 또는 글을 넘겨보기 전에 공개 채널인지 확인할 때 사용하세요.
Telegram Profile API, 직접 써 보세요
코드 한 줄 짜기 전에, 실제 데이터부터
Telegram API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
2026년 9월 업데이트
SocialCrawl 팀이 관리하고 2026년 9월에 검수했어요
Telegram에서 어떤 데이터를 받을 수 있나요
모든 Telegram 엔드포인트가 같은 통합 JSON 스키마로 응답해서, 파서 하나로 플랫폼 전체를 다룰 수 있어요. 아래는 Telegram API가 실제 응답에서 돌려주는 필드예요.
Telegram 스크래핑, 3단계면 끝나요
프록시도, 헤드리스 브라우저도, 로그인 세션도 필요 없어요. 인증된 GET 요청을 한 번 보내면 구조화된 JSON이 돌아와요.
- 1
무료 API 키 받기
계정을 만들고 대시보드에서 키를 복사하세요. 가입하면 100 크레딧을 무료로 드리고, 카드 등록도 필요 없어요.
- 2
Profile 엔드포인트 호출하기
x-api-key 헤더에 키를 담아 GET 요청을 보내세요. Telegram Profile 요청 전체는 이렇게 생겼어요:
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/telegram/profile?handle=telegram" - 3
통합 JSON 읽기
응답은 SocialCrawl의 공통 구조로 돌아와요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때는 engagement_rate·content_category 같은 계산 필드도 채워져요. 클라이언트는 공통 응답 구조를 기준으로 작성하고, 보강 필드는 선택적으로 처리하면 돼요.
요건과 제한
첫 Telegram 호출 전에 알아 두면 좋은 것들이에요.
- 인증
- API 키 하나를 x-api-key 요청 헤더에 담으면 끝이에요. OAuth 절차도, 앱 심사도, 플랫폼마다 따로 관리할 자격 증명도 없어요.
- 페이지네이션
- 리스트 엔드포인트는 next_cursor와 has_more 플래그를 함께 돌려드려요. 커서를 다시 넣어 결과를 넘겨 가면 되고, 모든 플랫폼에서 방식이 같아요.
- 크레딧
- Telegram 호출은 1 크레딧부터 시작하고, 요청마다 차감돼요. 가입하면 100 크레딧을 무료로 드리고, 크레딧은 만료되지 않아요.
- 속도 제한
- 한도는 API 키당 분당 600회, 동시 요청 50개예요. 무료 플랜까지 모든 플랜이 같은 한도를 쓰고, 한도에 걸린 요청은 크레딧이 빠지지 않아요. 이 둘 말고는 크레딧 잔액이 유일한 제한이에요.
Telegram API 비용은 얼마인가요
구독 없이 크레딧 단위로만 계산하는 간단한 요금이에요. 호출한 만큼만 내고, 각 Telegram 엔드포인트의 정확한 크레딧 비용은 아래에 있어요.
| 엔드포인트 | 호출당 크레딧 |
|---|---|
| Profile | 1 크레딧 |
| Profile Posts | 1 크레딧 |
| Post | 1 크레딧 |
가입하면 100 크레딧을 무료로 드리고, 카드 등록도 필요 없어요.
크레딧 팩 기준으로 계산하면 호출당 약 £0.002에서 £0.006 정도이고, 크레딧은 만료되지 않아요.
소셜 미디어 데이터를 몇 초 만에 수집하는 방법
개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 64개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.
모든 플랫폼을 하나의 스키마로
동일한 응답 구조로 64개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.
단순 수집을 넘어 계산된 필드 제공
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.
코드 한 줄 쓰기 전에, 데이터부터
Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}SocialCrawl은 64개의 서로 다른 플랫폼을 어떻게 처리하나요?
소셜 미디어 스크래핑은 어렵습니다. 스키마 정규화와 인증, 요청 제한, 페이지네이션까지 데이터가 도착하기 전에 필요한 모든 과정을 SocialCrawl이 처리합니다.
한번의 코드 작성 과정으로 모든 플랫폼을 조회하세요.
64개 플랫폼은 64개의 서로 다른 JSON 구조를 반환합니다. SocialCrawl은 모든 응답을 하나의 일관된 구조로 정형화합니다.
지표는 자동 계산되며 함께 제공됩니다
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때 참여율, 예상 도달, 콘텐츠 카테고리, 언어 같은 지표를 계산해 함께 담아요.
모든 플랫폼에 적용되는 하나의 커서
플랫폼마다 페이지네이션 방식은 다릅니다. SocialCrawl은 일관된 커서 기반 시스템을 제공합니다.
필요할 땐 새로, 반복 조회는 무료로
캐시 미스가 나면 현재 공개된 데이터를 새로 가져와요. 같은 요청은 데이터 종류에 따라 2~30분 동안 캐시되고, 캐시 적중은 0크레딧이에요. Cache-Control: no-cache를 보내면 정상 요금으로 새로 조회해요.
인증, 프록시, 요청 제한까지 모두 처리
플랫폼 인증, IP 순환, 요청 제한 관리까지 모두 처리합니다. GET 요청만 보내면 됩니다.
개발자들의 이야기
플랫폼마다 따로 짜야 했던 시절이 있었잖아요. 이제는 파서 하나가 64개 플랫폼을 다 받아내요. 연동에 갈리던 몇 주가 그냥 사라졌어요.
에이전트가 어떤 플랫폼 데이터든 그냥 흘려보내듯 처리하더라고요. 코드 한 줄도 플랫폼마다 갈라 짤 필요가 없어요. 스키마 하나로 처음부터 끝까지 똑같으니까요.
인플루언서 URL만 붙이면 팔로워, 참여율, 카테고리까지 한 화면에 떠요. 한 줄도 코딩하기 전에, 데이터부터 다 보여요.
직접 스크래퍼를 만들다가 SocialCrawl로 옮겼어요. 까다로운 건 SocialCrawl이 알아서 처리해 주니까, 우리는 인사이트에만 매달리면 돼요.
engagement_rate, estimated_reach, content_category 같은 계산 필드가 들어오면서 우리 데이터 파이프라인 한 층이 통째로 사라졌어요.
SocialCrawl과 공식 텔레그램 API, 뭐가 다른가요?
같은 Telegram 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | 공식 텔레그램 API |
|---|---|---|
| 공개 채널 읽기 | 핸들이나 t.me 주소만 있으면 가능 | 봇이 관리자인 채널만 읽을 수 있음 |
| 필요한 인증 | x-api-key 하나 | 봇 토큰, MTProto는 실제 전화번호 계정 필요 |
| 게시물 기록 | 커서로 공개 기록 전체를 넘겨보기 | 실시간으로 받은 메시지 외에는 조회 불가 |
| 미디어 | 사진과 영상 모두 바로 열리는 주소 | 파일 id를 받아 인증 다운로드를 한 번 더 |
| 응답 형태 | 다른 플랫폼과 동일한 표준 JSON | 프로토콜 플래그와 int64 id가 섞인 원본 객체 |
| 호출 제한 | 계정 기본 한도, 채널별 제한 없음 | 봇·채팅 단위 플러드 제한이 걸림 |
공개 채널 읽기
필요한 인증
게시물 기록
미디어
응답 형태
호출 제한
Telegram 스크래핑 비용은 얼마인가요
SocialCrawl은 크레딧 단위로 요금을 매겨요. 호출한 만큼만 내면 되고, 대부분의 Telegram 엔드포인트는 호출당 몇 크레딧이면 충분해요. 가입하면 100 크레딧을 무료로 드려요. 구독도, 컴퓨트 유닛도, 카드 등록도 필요 없어요.
요금 보기Telegram 스크래핑, 법적으로 문제없을까요
SocialCrawl은 공개된 Telegram 데이터만 돌려드려요. 공개 데이터 스크래핑은 hiQ 대 LinkedIn 판결처럼 법원에서 대체로 인정받아 왔지만, 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. 관련 법과 플랫폼 약관을 지키는 책임은 이용자에게 있어요.
자주 쓰는 Telegram 스크래핑 용어
Telegram 데이터가 필요할 때 개발자들이 검색하는 표현과, 각각이 SocialCrawl에서 무엇을 뜻하는지 정리했어요.
- Telegram scraper API
- Telegram scraper API는 스크래핑 인프라를 직접 돌리지 않고도 Telegram 데이터를 구조화된 JSON으로 받아 오는 API예요. 프록시·파싱·포맷 변경은 SocialCrawl이 처리하니, 엔드포인트만 호출하면 깔끔한 필드가 돌아와요. 요금은 호출당 1 크레딧부터예요.
- Telegram data API
- Telegram data API는 공개된 Telegram 데이터를 필요할 때 프로그램으로 읽는 방법이에요. SocialCrawl은 x-api-key 하나로 3개의 Telegram 엔드포인트를 열어 두고, 모두 같은 통합 스키마를 써서 플랫폼마다 통합 코드를 바꿀 필요가 없어요.
- scrape Telegram
- Telegram을 스크래핑한다는 건 공개 데이터를 손으로가 아니라 프로그램으로 추출하는 거예요. SocialCrawl에서는 인증된 요청 하나만 보내면 Telegram을 스크래핑할 수 있고, 응답은 모든 플랫폼에서 쓰는 같은 JSON 구조로 정규화돼 돌아와요.
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기텔레그램 채널 데이터는 어떻게 수집하나요?
봇 토큰이나 전화번호가 있어야 하나요?
어떤 텔레그램 채널을 읽을 수 있나요?
조회 수와 반응 수는 정확한 값인가요?
채널 기록 전체는 어떻게 넘겨보나요?
텔레그램 API 요금은 어떻게 되나요?
Telegram 데이터 스크래핑, 법적으로 괜찮을까요?
Telegram 스크래핑 API와 공식 Telegram API는 뭐가 다른가요?
AI에게 SocialCrawl을 물어보세요
Telegram 데이터, 가져올 준비 되셨어요?
API 키 받고 60초 안에 3개의 Telegram 엔드포인트에 닿아요.
무료로 시작하기