100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
무료로 시작하기
활용 사례

9개 플랫폼의 새 언급을 주기적으로 받는 소셜 리스닝 API

키워드나 주제, 최대 300개 계정을 지켜보는 리스너를 만들어 두면 정해 둔 주기로 새 게시물을 확인합니다. 새 게시물은 한 번만 API 또는 서명된 웹훅으로 전달됩니다.

무료로 시작호출 순서 보기
/v1/listening/streams

정해 둔 주기로 확인하는 리스너

  • GET /v1/listening/streams
  • GET /v1/listening/streams/{id}/mentions
  • GET /v1/webhook-endpoints
  • GET /v1/prism/discover

소셜 리스닝 API는 키워드와 주제, 계정 목록에 맞는 공개 게시물을 감시하고 새 게시물을 전달합니다. SocialCrawl에서는 POST /v1/listening/streams로 리스너를 만듭니다. 리스너는 레딧, 유튜브, X, 네이버, 구글 뉴스, 틱톡, 페이스북, 스레드, 링크드인을 정해 둔 주기로 확인하고 새 게시물을 한 번만 언급으로 전달합니다.

실제로 만들어지는 것

모두 현재 운영 중인 패턴입니다. 각 카드 아래의 엔드포인트 순서가 실제 호출 순서입니다.

키워드와 주제 리스너

POST /v1/listening/streams로 키워드나 불리언 주제를 감시하는 리스너를 만듭니다. 주제에는 AND, OR, NOT, 따옴표 구문, 괄호를 쓸 수 있습니다. 정해 둔 주기로 확인하고 새 게시물을 언급으로 한 번만 전달하므로 중복을 제거하는 코드가 필요 없습니다. 언어와 국가, 제외어, 협찬 게시물 기준으로 걸러 낼 수도 있습니다.

엔드포인트 순서listening/streams (keywords or rule) -> mentions

레딧 언급 심층 수집

불리언 질의와 커서 페이지네이션으로 조회한 뒤 필요한 게시물의 댓글 트리 전체를 가져옵니다. 레딧 OAuth 설정이 필요하지 않습니다. 리스너에서는 comments를 new_posts로 설정하면 새 레딧 게시물마다 달린 댓글도 받습니다.

엔드포인트 순서reddit/omni-search -> reddit/post/comments

최대 300개 계정 패널

리스너 하나에 계정을 최대 300개까지 지정하면 해당 계정의 새 게시물이 언급으로 전달됩니다. 경쟁사 목록이나 크리에이터 명단, 언론 계정 목록을 추적할 때 사용합니다.

엔드포인트 순서listening/streams (accounts, schedule.purpose) -> mentions

서명된 웹훅과 재시도

새 게시물을 Standard Webhooks 서명이 붙은 웹훅으로 받습니다. 전달에 실패하면 최대 41시간 동안 재시도합니다. 같은 언급은 이벤트 피드 GET /v1/events에서도 읽을 수 있습니다.

엔드포인트 순서webhook-endpoints -> mention.created (signed, retried)

에이전시용 고객사별 사용량

리스너 하나에 주제 그룹을 최대 500개까지 담고 metadata.client로 고객사별 사용량을 집계합니다. 에이전시가 고객사마다 드는 비용을 나눠 볼 수 있습니다.

엔드포인트 순서listening/streams (groups, metadata.client) -> listening/usage

판정까지 거친 브랜드 상시 모니터링

Discover에 브랜드와 기간을 전달하면 여러 플랫폼의 게시물을 중복 없이 하나의 목록으로 반환합니다. 지정한 날짜 안의 게시물만 남기고 질문에 맞는지 판정합니다. 같은 요청에 schedule을 붙여 보내면 직전 실행이 끝난 지점부터 자동으로 다시 실행되고, 비용은 무료 드라이런으로 먼저 확인할 수 있습니다.

엔드포인트 순서prism/discover (brands, period, schedule)

소셜 리스닝 API 동작 방식

호출 네 번으로 규칙의 가격 확인부터 새 언급 수신까지 처리합니다.

드라이런은 아무것도 만들지 않으며 0크레딧입니다. 확인 한 번에 읽는 페이지는 같은 API 호출과 같은 가격으로 과금됩니다. 최신 글부터 반환하는 레인에서는 새 글이 없는 페이지가 환불되어 조용한 리스너는 견적보다 적게 듭니다. 주제와 무관한 게시물을 걸러 내는 관련성 확인은 가격에 포함됩니다.

  1. POST /v1/listening/streams?dry_run=1

    드라이런으로 가격 확인

    POST /v1/listening/streams?dry_run=1에 규칙을 보냅니다. 리스너를 만들지 않고 월 비용을 크레딧과 금액으로 반환하며, 규칙을 문장으로 다시 풀어 보여 줍니다.

    0크레딧
  2. POST /v1/listening/streams

    리스너 생성

    같은 본문을 dry_run 없이 보냅니다. schedule.max_credits_per_month로 월 지출 상한을 정합니다. 첫 확인은 이미 올라와 있는 게시물을 기준선으로 저장할 뿐 아무것도 전달하지 않습니다.

    읽은 페이지당
  3. GET /v1/listening/streams/{id}/mentions

    언급 읽기

    리스너의 언급 경로나 이벤트 피드 GET /v1/events에서 읽습니다. 이후 확인부터는 새 게시물만 전달됩니다.

    0크레딧
  4. POST /v1/webhook-endpoints

    웹훅 연결

    POST /v1/webhook-endpoints로 HTTPS 엔드포인트를 등록하면 새 게시물이 Standard Webhooks 서명과 함께 전달됩니다. 실패한 전달은 최대 41시간 동안 재시도합니다.

    무료

리스너가 감시하는 플랫폼

레딧, 유튜브, X, 네이버, 구글 뉴스, 틱톡, 페이스북, 스레드, 링크드인에서 리스너를 만들 수 있습니다. 링크를 열면 해당 플랫폼의 엔드포인트를 확인합니다.

기존 구성과 비교

대부분 채널별 리스닝 좌석을 구매하거나 여러 스크래퍼를 직접 연결합니다. 달라지는 지점은 다음과 같습니다.

CapabilitySocialCrawl일반적인 구성
커버리지리스너는 9개 플랫폼을 감시하고 같은 키로 직접 호출하면 69개 플랫폼을 조회합니다.채널별 과금이라 보통 두세 개 네트워크에서 멈춥니다.
응답 형태모든 언급이 공통 스키마를 사용하므로 후속 코드를 한 번만 작성합니다.공급업체마다 응답 형태가 달라 직접 정규화합니다.
댓글 깊이같은 키로 전체 댓글과 답글 트리를 조회하고, 리스너 옵션으로 새 레딧 게시물의 댓글도 받습니다.최상위 댓글만 제공하거나 별도 상품으로 분리됩니다.
과금 방식소멸되지 않는 크레딧 팩을 사용합니다. 리스너 비용은 만들기 전에 무료 드라이런으로 확인하고 월 상한으로 제한합니다.연간 좌석 라이선스이며 채널별로 부과되는 경우가 많습니다.
시작 방법가입 시 무료 크레딧을 제공하며 리스너 비용은 쓰기 전에 드라이런으로 확인합니다.영업 미팅 후 온보딩을 진행합니다.
제품화 가능 여부가공된 고객용 화면으로 제공하는 것이 약관에 명시적으로 허용됩니다.대개 제한되거나 건별 협의가 필요합니다.

소셜 리스닝 API 자주 묻는 질문

소셜 리스닝 API란 무엇입니까?

소셜 리스닝 API는 키워드와 주제, 계정을 언급한 공개 게시물을 구조화된 데이터로 반환합니다. SocialCrawl의 리스너는 이 검색을 정해 둔 주기로 대신 실행하고 새 게시물을 한 번만 전달합니다.

리스너는 어떤 플랫폼을 감시할 수 있습니까?

레딧, 유튜브, X, 네이버, 구글 뉴스, 틱톡, 페이스북, 스레드, 링크드인 9개입니다. 키워드와 불리언 주제, 최대 300개 계정을 지정할 수 있습니다. 나머지 69개 플랫폼과 679개 엔드포인트는 직접 호출로 조회합니다.

얼마나 자주 확인합니까?

30분마다부터 7일마다까지 직접 정합니다. 30분 주기는 최신 글부터 반환하는 레딧, 유튜브, X, 네이버 뉴스에서만 지원합니다. 첫 확인은 기준선을 저장하고 아무것도 전달하지 않으며 이후 확인부터 새 게시물만 전달합니다.

플랫폼마다 OAuth나 개발자 계정이 필요합니까?

필요하지 않습니다. SocialCrawl API 키 하나로 인증합니다. 플랫폼별 OAuth 앱과 심사 절차, 별도 자격 증명 갱신이 없습니다.

새 게시물을 내 시스템으로 받으려면 어떻게 합니까?

리스너의 언급 경로에서 읽거나 GET /v1/events를 조회하거나 웹훅 엔드포인트를 등록해 서명된 푸시로 받습니다. 웹훅은 Standard Webhooks 서명을 사용하며 실패하면 최대 41시간 재시도합니다. 새 게시물은 언급으로 한 번만 전달됩니다.

비용은 얼마입니까?

확인 한 번에 읽는 페이지는 같은 API 호출과 같은 가격입니다. 최신 글부터 반환하는 레인에서는 새 글이 없는 페이지가 환불되므로 조용한 리스너는 견적보다 적게 듭니다. POST /v1/listening/streams?dry_run=1은 0크레딧으로 월 비용을 알려 주고 schedule.max_credits_per_month는 월 지출 상한을 정합니다. 주제와 무관한 게시물을 걸러 내는 관련성 확인은 가격에 포함됩니다. 가입 시 무료 크레딧 100개를 제공하며 카드 등록이 필요하지 않습니다.

이 데이터로 제품을 만들 수 있습니까?

가공한 화면을 자체 사용자에게 제공하는 것은 가능합니다. 약관은 대시보드와 파생 제품을 허용하고 원본 전달과 대량 재배포를 제한합니다. 설계가 어디에 해당하는지 불확실하면 개발 전에 문의하시기 바랍니다.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기Perplexity에 물어보기Gemini에 물어보기Claude에 물어보기Grok에 물어보기

첫 리스너 만들기

가입 시 무료 크레딧 100개를 제공합니다. 리스너 비용은 드라이런으로 먼저 확인합니다. 카드 등록과 영업 미팅이 없습니다.

무료로 시작문서 보기
요청
curl -X POST "https://www.socialcrawl.dev/v1/listening/streams?dry_run=1" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" -H "Content-Type: application/json" \
  -d '{"keywords": ["your brand"], "platforms": ["reddit", "youtube"], "schedule": {"every": "1h", "name": "Brand watch"}}'
curl -X POST "https://www.socialcrawl.dev/v1/listening/streams" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"keywords": ["your brand"], "platforms": ["reddit", "youtube"], "schedule": {"every": "1h", "max_credits_per_month": 5000, "name": "Brand watch"}}'

각 호출은 실제 데이터로 동작합니다. 키와 질의만 바꾸면 그대로 실행됩니다.