질의 하나로 전체 네트워크 조회
키워드를 한 번 보내면 소셜과 포럼, 뉴스, 웹의 결과를 함께 반환합니다. 대부분의 리스닝 제품이 이 호출 위에 만들어집니다. 라우터로도 사용합니다. 먼저 실행해 반응이 큰 소스를 확인한 뒤 해당 플랫폼을 직접 조회합니다.
엔드포인트 순서
search/everywhere -> post -> comments활용 사례
모든 플랫폼을 아우르는 소셜 리스닝 API
브랜드와 제품, 주제가 언급되는 곳을 한 번에 추적합니다. 요청 한 번이 소셜과 포럼, 뉴스, 웹으로 동시에 확장되고 결과는 모두 같은 스키마로 반환됩니다.
/v1/search
질의 하나로 전체 소스 조회
- GET /v1/search/everywhere
- GET /v1/reddit/omni-search
- GET /v1/twitter/ai-search
- GET /v1/prism/brand-mentions
소셜 리스닝 API는 브랜드와 제품, 주제에 대한 공개 언급을 소셜 플랫폼과 포럼, 뉴스에서 한 번의 요청으로 수집합니다. SocialCrawl은 질의 하나를 46개 플랫폼으로 확장하고 결과를 하나의 공통 스키마로 반환합니다. 플랫폼마다 별도 연동을 작성할 필요가 없습니다.
실제로 만들어지는 것
모두 현재 운영 중인 패턴입니다. 각 카드 아래의 엔드포인트 순서가 실제 호출 순서입니다.
레딧 언급 심층 수집
불리언 질의와 커서 페이지네이션으로 조회한 뒤 필요한 게시물의 댓글 트리 전체를 가져옵니다. 레딧 OAuth 설정이 필요하지 않습니다.
엔드포인트 순서
reddit/omni-search -> reddit/post/comments근거 기반 X 검색
날짜 필터와 계정 포함 또는 제외 조건으로 질문하면 근거가 되는 게시물과 함께 답변을 반환합니다.
엔드포인트 순서
twitter/ai-search -> twitter/tweet기간 지정 언급 추적
지정한 기간 동안 하나의 대상을 네트워크 전반에서 추적하고 일 단위로 묶습니다. 언급량뿐 아니라 급증의 형태를 확인합니다.
엔드포인트 순서
prism/brand-mentions (date-ranged)스레드와 신흥 네트워크
시작일과 종료일을 지정해 스레드를 검색합니다. 기존 네트워크에서 사용자가 이동한 시장에서 유용합니다.
엔드포인트 순서
threads/search -> threads/post뉴스도 같은 레인으로
언어와 지역을 지정해 뉴스를 검색합니다. 별도 도구가 아니라 소셜과 같은 자리에서 조회합니다.
엔드포인트 순서
google_news/search -> web/scrape소셜 리스닝 API 동작 방식
네 번의 호출로 전체 작업을 처리합니다. 넓게 조회한 뒤 결과가 있는 지점만 깊게 파고듭니다.
조회는 크레딧으로 과금됩니다. 목록 엔드포인트에서 결과가 없으면 과금되지 않고 업스트림 실패는 자동 환불됩니다.
GET /v1/search/everywhere전체 소스로 확장
질의와 조회 기간, 선택적 소스 필터를 전달합니다. 소셜과 포럼, 뉴스, 웹의 결과를 하나의 스키마로 반환합니다.
호출당 정액GET /v1/reddit/omni-search레딧 정밀 수집
불리언 연산자와 커서 페이지네이션을 지원합니다. 장문의 브랜드 의견이 실제로 축적되는 곳입니다.
페이지당GET /v1/prism/brand-mentions기간 단위 추적
기간과 일 단위 그룹을 지정해 흩어진 언급을 시계열로 만듭니다.
호출당POST /v1/prism/comments댓글 트리 수집
플랫폼과 관계없이 게시물 URL을 전달하면 댓글과 답글을 공통 스키마로 반환합니다.
호출당 정액
리스닝 가능한 플랫폼
모두 같은 질의에서 동작하는 레인입니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트를 확인합니다.
기존 구성과 비교
대부분 채널별 리스닝 좌석을 구매하거나 여러 스크래퍼를 직접 연결합니다. 달라지는 지점은 다음과 같습니다.
| Capability | SocialCrawl | 일반적인 구성 |
|---|---|---|
| 커버리지 | 키 하나로 포럼과 뉴스, 웹을 포함한 46개 플랫폼을 조회합니다. | 채널별 과금이라 보통 두세 개 네트워크에서 멈춥니다. |
| 응답 형태 | 모든 소스가 공통 스키마를 사용하므로 후속 코드를 한 번만 작성합니다. | 공급업체마다 응답 형태가 달라 직접 정규화합니다. |
| 댓글 깊이 | 같은 키로 전체 댓글과 답글 트리를 조회합니다. | 최상위 댓글만 제공하거나 별도 상품으로 분리됩니다. |
| 과금 방식 | 소멸되지 않는 크레딧 팩으로 호출당 과금하며 업스트림 실패는 환불합니다. | 연간 좌석 라이선스이며 채널별로 부과되는 경우가 많습니다. |
| 시작 방법 | 가입 시 무료 크레딧을 제공하며 첫 호출을 바로 실행합니다. | 영업 미팅 후 온보딩을 진행합니다. |
| 제품화 가능 여부 | 가공된 고객용 화면으로 제공하는 것이 약관에 명시적으로 허용됩니다. | 대개 제한되거나 건별 협의가 필요합니다. |
소셜 리스닝 API 자주 묻는 질문
소셜 리스닝 API란 무엇입니까?
소셜 리스닝 API는 키워드와 브랜드, 주제를 언급한 공개 게시물과 댓글, 기사를 구조화된 데이터로 반환합니다. 소셜 리스닝 도구로 판매되는 대시보드를 직접 제어하는 데이터 피드로 대체합니다.
어떤 플랫폼을 모니터링할 수 있습니까?
SocialCrawl은 46개 플랫폼과 375개 엔드포인트를 제공합니다. 레딧과 X, 틱톡, 인스타그램, 유튜브, 페이스북, 스레드, 링크드인, 해커뉴스, 구글 뉴스, 웹을 포함합니다. API 키 하나로 전부 조회합니다.
요청 한 번으로 여러 플랫폼을 검색할 수 있습니까?
가능합니다. 유니버설 검색 엔드포인트가 질의 하나를 모든 소스로 병렬 확장하고 중복을 제거한 결과를 공통 스키마로 반환합니다. 일부 소스만 조회하도록 범위를 지정할 수도 있습니다.
플랫폼마다 OAuth나 개발자 계정이 필요합니까?
필요하지 않습니다. SocialCrawl API 키 하나로 인증합니다. 플랫폼별 OAuth 앱과 심사 절차, 별도 자격 증명 갱신이 없습니다.
일회성이 아니라 기간별로 추적하려면 어떻게 합니까?
브랜드 언급 엔드포인트에 기간과 일 단위 그룹을 지정하거나, 고정 질의를 자체 스케줄로 재실행해 결과를 저장합니다. 동일 대상을 반복 조회하는 방식이 가장 일반적인 운영 패턴입니다.
비용은 얼마입니까?
조회는 소멸되지 않는 크레딧 팩에서 차감됩니다. 좌석이나 채널이 아니라 호출 단위로 과금합니다. 가입 시 무료 크레딧 100개를 제공하며 카드 등록이 필요하지 않습니다.
이 데이터로 제품을 만들 수 있습니까?
가공한 화면을 자체 사용자에게 제공하는 것은 가능합니다. 약관은 대시보드와 파생 제품을 허용하고 원본 전달과 대량 재배포를 제한합니다. 설계가 어디에 해당하는지 불확실하면 개발 전에 문의하시기 바랍니다.
AI에게 SocialCrawl을 물어보세요
요청
curl -G "https://socialcrawl.dev/v1/search/everywhere" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "query=your brand name" \
--data-urlencode "lookback_days=7"curl -G "https://socialcrawl.dev/v1/reddit/omni-search" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode 'query="your brand" AND (review OR alternative)'두 호출 모두 실제 데이터로 동작합니다. 키와 질의만 바꾸면 그대로 실행됩니다.