URL 기반 댓글 수집
지원하는 네트워크의 게시물 링크를 전달하면 댓글을 반환합니다. 답글은 상위 댓글 아래에 중첩되고 페이지네이션은 서버에서 끝까지 처리합니다. 플랫폼마다 따로 작성하던 댓글 수집 코드를 제거할 수 있습니다.
엔드포인트 순서
prism/comments (any platform URL)활용 사례
답글 트리까지 수집하는 댓글 API
게시물 URL을 전달하면 해당 게시물의 댓글을 반환합니다. 답글은 상위 댓글 아래에 중첩되고 페이지네이션은 서버에서 처리됩니다. 모든 플랫폼이 같은 댓글과 작성자 스키마를 사용하므로 응답 파싱은 한 번만 작성합니다.
/v1/prism
게시물 URL 기준 전체 댓글 트리
- GET /v1/prism/comments
- GET /v1/reddit/post/comments
- GET /v1/tiktok/video/comment/replies
- GET /v1/youtube/video/comments
댓글 수집 API는 공개 게시물의 댓글과 답글을 구조화된 데이터로 반환합니다. SocialCrawl은 46개 플랫폼의 게시물 URL을 받아 댓글 트리 전체를 공통 스키마로 반환합니다. 의견이 실제로 쌓이는 답글의 답글 계층까지 포함하며 플랫폼별 OAuth 앱 등록이 필요하지 않습니다.
실제로 만들어지는 것
모두 현재 운영 중인 패턴입니다. 각 카드 아래의 엔드포인트 순서가 실제 호출 순서입니다.
레딧 전체 댓글 트리
깊은 답글을 포함한 스레드 전체를 페이지당 5크레딧으로 수집합니다. 정렬은 인기와 최신, 논쟁 중에서 지정합니다. 레딧 OAuth 앱 등록과 토큰 갱신 과정이 없습니다.
엔드포인트 순서
reddit/post/comments (full tree)틱톡 답글 트리 수집
영상의 최상위 댓글을 조회한 뒤 각 스레드의 답글을 커서로 끝까지 확장합니다. 이 API에서 가장 깊게 수집되는 작업이며 페이지네이션도 그 용도로 설계했습니다.
엔드포인트 순서
tiktok/post/comments -> video/comment/replies유튜브 댓글과 답글
영상의 댓글 스레드를 조회하고 필요한 스레드의 답글을 이어서 가져옵니다. 두 응답 모두 다른 네트워크와 같은 스키마로 반환됩니다.
엔드포인트 순서
youtube/video/comments -> video/comment/replies인스타그램 게시물 댓글
커서 페이지네이션으로 조회하며 댓글마다 작성자 정보가 함께 반환됩니다. 작성자 기준으로 묶을 때 추가 호출이 필요하지 않습니다.
엔드포인트 순서
instagram/post/comments특정 댓글 추적
이미 알고 있는 댓글을 한 번의 호출로 최대 25개까지 다시 조회하고 현재 지표를 받습니다. 해당 스레드를 처음부터 다시 페이지네이션하지 않습니다. 실패한 항목은 환불됩니다.
엔드포인트 순서
prism/comment-lookup (track one comment)댓글 수집 API 동작 방식
네 번의 호출로 전체 작업을 처리합니다. 컴포지트로 시작하고 정렬과 깊이를 직접 제어할 때 원본 엔드포인트로 내려갑니다.
조회는 크레딧으로 과금됩니다. 메터링 엔드포인트는 실제 반환량 기준으로 과금하며 업스트림 실패는 자동 환불됩니다.
POST /v1/prism/comments게시물 URL로 댓글 수집
지원 플랫폼의 URL을 전달합니다. 답글은 중첩 구조로 반환되고 커서를 직접 다루지 않아도 끝까지 조회합니다.
반환량 과금 (최소 2크레딧)GET /v1/reddit/post/comments레딧 스레드 수집
정렬 기준을 지정하고 커서로 트리를 순회합니다. 장문의 의견이 가장 많이 축적되는 곳입니다.
페이지당 5크레딧GET /v1/tiktok/post/comments틱톡 최상위 댓글 조회
영상의 최상위 댓글을 먼저 조회해 어떤 스레드를 확장할지 결정합니다.
페이지당 1크레딧GET /v1/tiktok/video/comment/replies답글 트리 확장
댓글 ID를 전달해 해당 스레드의 답글을 끝까지 조회합니다. 남겨 둔 스레드 수만큼 반복합니다.
페이지당 1크레딧
댓글을 수집할 수 있는 플랫폼
모두 같은 키로 동작하는 레인입니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트를 확인합니다.
기존 구성과 비교
대부분 최상위 댓글만 보여 주는 리스닝 좌석을 구매하거나 네트워크마다 스크래퍼를 직접 운영합니다. 달라지는 지점은 다음과 같습니다.
| Capability | SocialCrawl | 일반적인 구성 |
|---|---|---|
| 답글 깊이 | 답글이 있는 모든 플랫폼에서 스레드 최하단까지 순회합니다. | 최상위 댓글만 제공하거나 답글을 별도 상품으로 분리합니다. |
| 커버리지 | 같은 API 키로 46개 플랫폼과 375개 엔드포인트의 댓글을 조회합니다. | 플랫폼마다 스크래퍼가 따로 있고 인증과 댓글 형태도 제각각입니다. |
| 인증 | SocialCrawl API 키로 레딧을 포함한 모든 네트워크를 인증합니다. | 플랫폼마다 OAuth 앱과 심사, 토큰 갱신이 필요합니다. |
| 응답 형태 | 모든 플랫폼이 같은 댓글과 작성자 스키마를 사용하므로 파싱 코드를 한 번만 작성합니다. | 공급업체마다 응답 형태가 달라 직접 정규화합니다. |
| 특정 댓글 추적 | 이미 아는 댓글 최대 25개를 한 번의 호출로 다시 조회해 현재 지표를 받습니다. | 댓글을 다시 찾으려면 스레드 전체를 재조회합니다. |
| 과금 방식 | 소멸되지 않는 크레딧 팩에서 호출 단위로 차감하며 업스트림 실패는 환불합니다. | 월 구독이거나 최소 물량이 붙은 레코드 단가 계약입니다. |
댓글 수집 API 자주 묻는 질문
댓글 수집 API란 무엇입니까?
댓글 수집 API는 게시물의 공개 댓글을 구조화된 데이터로 반환합니다. 댓글마다 작성자와 본문, 작성 시각, 참여 지표가 포함됩니다. 브라우저에서 스레드를 열어 확인하는 대신 저장하고 필터링하고 점수화할 수 있는 레코드를 받습니다.
최상위 댓글이 아니라 답글까지 받을 수 있습니까?
가능합니다. 컴포지트 엔드포인트는 답글을 상위 댓글 아래에 중첩해 반환하고, 원본 엔드포인트는 답글 전용 호출을 제공해 커서로 스레드가 끝날 때까지 순회합니다. 스레드의 실제 논쟁은 대부분 첫 번째 계층 아래에서 이루어집니다.
어떤 플랫폼의 댓글을 수집할 수 있습니까?
SocialCrawl은 46개 플랫폼과 375개 엔드포인트를 제공합니다. 댓글은 레딧과 틱톡, 유튜브, 인스타그램, 페이스북, 링크드인, 해커뉴스에서 수집하며 이 플랫폼들의 URL을 모두 받는 컴포지트 엔드포인트도 제공합니다. API 키 하나로 전부 조회합니다.
플랫폼마다 레딧 OAuth나 개발자 계정이 필요합니까?
필요하지 않습니다. SocialCrawl API 키로 한 번 인증합니다. 레딧 OAuth 앱 등록과 네트워크별 심사 절차, 플랫폼 정책이 바뀔 때마다 갱신하던 자격 증명이 없습니다.
게시물 하나에서 댓글 수만 개를 수집하려면 어떻게 합니까?
커서로 페이지를 넘기면서 도달한 위치를 저장합니다. 원본 목록 엔드포인트는 페이지 단위로 과금하므로 깊은 스레드는 깊이만큼 비용이 발생하고, 컴포지트 엔드포인트는 실제 반환량 기준으로 과금합니다. 대량으로 수집한 뒤 자체 저장소에서 필터링하는 방식이 일반적인 운영 패턴입니다.
특정 댓글 하나를 조회하거나 계속 추적할 수 있습니까?
가능합니다. 댓글 URL이나 ID를 전달하면 해당 댓글과 현재 지표를 바로 반환합니다. 이미 아는 댓글은 한 번의 호출로 최대 25개까지 다시 확인합니다. 댓글이 수천 개인 게시물에서 자사 댓글의 상태를 확인할 때 전체 재조회가 필요하지 않습니다.
수집한 댓글로 제품을 만들 수 있습니까?
가공한 화면을 자체 사용자에게 제공하는 것은 가능합니다. 약관은 대시보드와 파생 제품을 허용하고 원본 전달과 대량 재배포를 제한합니다. 설계가 어디에 해당하는지 불확실하면 개발 전에 문의하시기 바랍니다.
AI에게 SocialCrawl을 물어보세요
요청
curl -X POST "https://socialcrawl.dev/v1/prism/comments" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
-H "content-type: application/json" \
-d '{"url":"https://www.reddit.com/r/SaaS/comments/abc123/","max":200,"replies":true}'curl -G "https://socialcrawl.dev/v1/reddit/post/comments" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "url=https://www.reddit.com/r/SaaS/comments/abc123/" \
--data-urlencode "sort=top"두 호출 모두 실제 데이터로 동작합니다. 키와 게시물 URL만 바꾸면 그대로 실행됩니다.