프로필
1 크레딧/v1/snapchat/profile공개 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.
handle
Snapchat 엔드포인트
공개 Snapchat 프로필 읽기 엔드포인트는 1개입니다. 데이터 API만 지원합니다.
Snapchat API2개 엔드포인트 지원
문서 보기Snapchat 계정의 공개 프로필을 돌려줍니다: 표시 이름, Bitmoji 아바타 URL, 구독자 수, 소개.
Snapchat 계정이 실제로 있는지 확인하고 공개 정보를 읽을 때 사용하세요.
1크레딧
GET/v1/snapchat/profile?handle=djkhaled305
handle · Snapchat username
$ curl https://www.socialcrawl.dev/v1/snapchat/profile?handle=djkhaled305 \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Snapchat API 동작 방식
Snapchat도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/snapchat/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 별도 SDK는 없습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. SocialCrawl 카탈로그 전 구간에 같은 키를 사용합니다.
GET과 쿼리 파라미터
라우트는 GET입니다. handle, url, query, cursor를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.
크레딧 과금
라이브 미스는 라우트 티어를 차감합니다. 캐시 히트는 0입니다. 빈 응답과 하드 실패는 환불됩니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다.
연동 순서
대부분 호출은 공개 Snapchat 핸들을 프로필 카드로 해석합니다.
01핸들
GET /v1/snapchat/profile공개 핸들 문자열입니다.
@ 없이 username에서 시작합니다.
02프로필
GET /v1/snapchat/profileAuthor 형태 공개 프로필입니다.
캐시 미스 시 표준 1 크레딧입니다.
03캐시
GET /v1/snapchat/profile히트 시 credits_used 0인 동일 봉투입니다.
반복 조회 비용을 낮춥니다.
04파이프라인
GET /v1/snapchat/profile다운스트림 잡용 공유 Author 필드입니다.
다른 플랫폼과 같은 스키마입니다.
요청
GET /v1/snapchat/profile
?handle=djkhaled305
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here응답 봉투
{
"success": true,
"data": { "/* Author | Post | PostList | CommentList | … */": true },
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data 형태
archetype이 맞으면 필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다.
Authorprofile
id, username, display_name, avatar_url, bio, followers, url, ext
PostList / Postprofile
items[].post에 id, url, content, engagement, author, published_at, ext
CommentListprofile
댓글 라우트가 있을 때 items[]에 author, content.text, engagement, published_at
Search / Mediaprofile
검색 결과, 미디어 메타데이터, 대본 등 라우트별 필드
게이트웨이 내부
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기입니다.
- 01
엣지 수신
Next.js catch-all이 Hono 소셜 API로 연결됩니다. request_id를 발급하고 키를 인증한 뒤 속도 제한과 동시성을 적용합니다.
- 02
검증 후 차감
레지스트리에서 라우트를 찾습니다. 필수 파라미터를 먼저 검사합니다. 잘못된 입력은 미과금 400입니다. 유효 호출은 upstream 전에 차감합니다.
- 03
캐시 또는 수집
platform + resource + params로 캐시 키를 만듭니다. 히트는 credits_used 0입니다. 미스는 재시도와 서킷 브레이커로 upstream을 호출합니다.
- 04
정규화 후 반환
upstream JSON을 Author / Post / PostList / CommentList(또는 라우트 archetype)로 매핑하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
- 표준 라이브 미스: 티어 비용(보통 1 크레딧)
- 고급 읽기: 보통 5 크레딧
- 프리미엄 읽기: 보통 10 크레딧
- 종량제 라우트: 문서화된 최소 바닥
- 캐시 히트: 0 크레딧
- 빈 응답·하드 실패: 자동 환불
- 잘못된 파라미터: 400, 미과금
- 크레딧 부족: 402, 미과금
- 비활성 라우트: 503, 미과금
데이터 수집 방식
Snapchat은 SocialCrawl의 공개 읽기 데이터입니다. 공유 스키마로 정규화하므로 별도 OAuth를 배울 필요가 없습니다.
이 API에서의 Snapchat
레지스트리에 노출된 공개 Snapchat 표면입니다. 연구·모니터링·제품 작업을 위한 읽기 전용입니다.
SocialCrawl 접근 방식
하나의 게이트웨이 뒤에서 소셜 읽기 upstream을 호출합니다. 등록된 두꺼운 라우트는 Prism 컴포지트로 단계를 묶습니다.
엣지에서 나가는 형태
success, data, credits_used, request_id, cached 통일 JSON 봉투입니다. Author / Post / Comment 리프를 공유합니다.
제공하지 않는 범위
쓰기 엔드포인트와 비공개 수신함은 없습니다. 비활성 라우트는 활성 개수에 넣지 않습니다.
필드 매핑
public profile / channel→ author.*프로필 식별자와 카운터
public item payload→ data.*게시물 본문과 참여 지표
list / search page→ items[] or hits댓글 또는 검색 결과
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
1active Snapchat endpoints in the registry
1라이브 프로필 미스당 크레딧
Snapchat 모니터링과 콘텐츠 분석
호출은 Snapchat 프로필, 콘텐츠 목록, 검색, 심화 경로에 집중됩니다. 공유 스키마의 구조화 Snapchat JSON과 SocialCrawl API 키 하나입니다.
상세 읽기는 캐시 미스 기준 수 초 수준입니다. 검색과 두꺼운 컴포지트는 더 느린 경로입니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
모니터링 잡
Python, cron, Slack 봇Snapchat 프로필과 피드를 폴링합니다. 참여 속도가 뛰면 알립니다.
리서치·VoC
Node, 노트북, BI 적재Snapchat에서 검색 후 게시물을 확장해 브랜드·제품·경쟁 언어를 모읍니다.
백엔드 제품 잡
Go, 워커, Explorer해석-목록-상세를 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다.
두 줄로 호출
라이브 미스는 티어별 크레딧을 사용합니다. 캐시 히트는 무료입니다. 빈 응답과 하드 실패는 환불됩니다.
curl "https://www.socialcrawl.dev/v1/snapchat/profile?handle=djkhaled305" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/snapchat/profile?handle=djkhaled305" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Snapchat API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 직접 스크래핑, 뭐가 다른가요?
같은 Snapchat 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | 직접 스크래핑 |
|---|---|---|
| 인증 | x-api-key 헤더 하나면 돼요 | 없어요. 프록시와 요청 핑거프린트를 직접 관리해야 해요 |
| 설정·심사 | 가입 후 바로 호출할 수 있어요 | 스크레이퍼와 프록시 풀, 파싱 코드를 먼저 만들어야 해요 |
| 레이트 리밋 | 크레딧 기반이라 쓴 만큼만 차감돼요 | 차단당하기 전까지 프록시가 버티는 만큼이에요 |
| 응답 스키마 | 51개 플랫폼 공통 통합 JSON이에요 | 원본 HTML을 직접 파싱하고 레이아웃이 바뀔 때마다 다시 고쳐야 해요 |
| 요금 | 프로필당 1 크레딧, 가입 시 100 크레딧 무료예요 | 프록시·서버·개발 비용이 볼륨에 따라 계속 늘어나요 |
| 데이터 범위 | 표시 이름, Bitmoji, 구독자 수, 소개글 등 공개 프로필 필드예요 | 추출하는 만큼 가져갈 수 있지만 법적·기술적 리스크를 직접 져야 해요 |
| 유지보수 | Snapchat 마크업이 바뀌어도 스키마가 유지돼요 | Snapchat이 리디자인할 때마다 셀렉터가 깨져요 |
인증
SocialCrawl
x-api-key 헤더 하나면 돼요
직접 스크래핑
없어요. 프록시와 요청 핑거프린트를 직접 관리해야 해요
설정·심사
SocialCrawl
가입 후 바로 호출할 수 있어요
직접 스크래핑
스크레이퍼와 프록시 풀, 파싱 코드를 먼저 만들어야 해요
레이트 리밋
SocialCrawl
크레딧 기반이라 쓴 만큼만 차감돼요
직접 스크래핑
차단당하기 전까지 프록시가 버티는 만큼이에요
응답 스키마
SocialCrawl
51개 플랫폼 공통 통합 JSON이에요
직접 스크래핑
원본 HTML을 직접 파싱하고 레이아웃이 바뀔 때마다 다시 고쳐야 해요
요금
SocialCrawl
프로필당 1 크레딧, 가입 시 100 크레딧 무료예요
직접 스크래핑
프록시·서버·개발 비용이 볼륨에 따라 계속 늘어나요
데이터 범위
SocialCrawl
표시 이름, Bitmoji, 구독자 수, 소개글 등 공개 프로필 필드예요
직접 스크래핑
추출하는 만큼 가져갈 수 있지만 법적·기술적 리스크를 직접 져야 해요
유지보수
SocialCrawl
Snapchat 마크업이 바뀌어도 스키마가 유지돼요
직접 스크래핑
Snapchat이 리디자인할 때마다 셀렉터가 깨져요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기Snapchat에 공식 API가 있나요?
Snapchat은 광고 집행용 Marketing API, Conversions API, 그리고 Snap Kit 개발자 플랫폼만 공개해요. 공개 프로필 데이터를 가져오는 공식 API는 없어서, SocialCrawl이 프로필 엔드포인트 하나로 그 공백을 채워 드려요. Snap 개발자 계정 없이 x-api-key로 바로 호출할 수 있어요.
Snapchat 데이터는 어떻게 수집하나요?
GET /v1/snapchat/profile에 Snapchat 핸들을 handle 파라미터로 담아 호출하면 돼요. 표시 이름, Bitmoji 아바타 URL, 구독자 수, 소개글이 통합 스키마 JSON으로 와요. 다른 SocialCrawl 플랫폼과 동일한 구조라서 기존 파싱 코드를 그대로 재사용할 수 있어요.
Snapchat에서 어떤 데이터를 받을 수 있나요?
공개 프로필 정보만 받아볼 수 있어요. 표시 이름, Bitmoji 아바타 URL, 구독자(팔로워) 수, 소개글이 포함돼요. Snapchat은 Stories, Spotlight, 친구 목록을 외부에 공개하지 않아서 해당 필드는 제공되지 않아요. 광고 데이터가 필요하다면 공식 Snap Marketing API를 쓰세요.
Snapchat API는 요금이 얼마인가요?
프로필 엔드포인트는 호출당 1 크레딧(스탠다드 티어)이 소진돼요. 새 계정에는 100 크레딧이 무료로 제공되고, 신용카드 없이 Snapchat 프로필을 약 100건 받아보실 수 있어서 유료 플랜으로 넘어가기 전에 충분히 테스트하실 수 있어요.
Snapchat 프로필을 수집하는 게 법적으로 괜찮나요?
SocialCrawl은 snapchat.com/add/handle에서 로그인 없이 누구나 볼 수 있는 공개 프로필 페이지만 가져와요. 공개 정보이지만, 사용 목적이 Snapchat 약관과 개인정보 관련 법령에 맞는지는 서비스 쪽에서 직접 확인하고 쓰시는 걸 권해요. SocialCrawl은 GDPR 정당한 이익에 기반한 문서화된 프레임워크로 운영돼요. 로그인 없이 볼 수 있는 공개 데이터만 다루고, 계정 자격 증명은 일절 사용하지 않으며, 캐시는 2~30분만 유지되고 영구 저장하지 않아요. 자신의 공개 정보에 대한 옵트아웃 채널도 운영해요. 자세한 내용은 socialcrawl.dev/legal/public-data-notice에서 확인하실 수 있어요.
Snap Kit으로는 원하는 데이터를 못 받나요?
Snap Kit은 내 앱에 직접 로그인하고 권한을 준 사용자의 데이터만 받아올 수 있어요. 제3자의 공개 프로필은 가져올 수 없어요. SocialCrawl은 공개된 Snapchat 핸들이라면 동의 플로우나 앱 심사 없이 바로 받아볼 수 있어요.
가장 좋은 Snapchat 스크레이퍼 API는 무엇인가요?
Snapchat에는 공개 프로필을 읽는 공식 API가 없어서, 핸들 하나로 프로필을 돌려주는 API 자체가 드물어요. SocialCrawl은 GET 한 번에 표시 이름, Bitmoji 아바타, 구독자 수, 소개글을 1 크레딧으로 받아볼 수 있어요. 신용카드 없이 100 크레딧 무료로 시작할 수 있어요.
AI에게 SocialCrawl을 물어보세요