활용 사례

소셜 미디어부터 AI 답변까지 추적하는 브랜드 모니터링 API

브랜드를 언급한 게시물과 구매자가 카테고리를 물을 때 AI 엔진이 내놓는 답변을 추적합니다. 각 확인 작업은 API 호출 한 번으로 끝나고 원하는 주기로 반복 실행할 수 있습니다.

/v1/prism

AI 답변과 소셜 속 브랜드 언급

GET /v1/prism/ai-visibility
GET /v1/search/everywhere
GET /v1/prism/discover
GET /v1/prism/brand-mentions

브랜드 모니터링 API는 소셜 플랫폼에 올라온 브랜드 언급과 AI 답변 엔진이 브랜드를 소개하는 방식을 저장하고 비교할 수 있는 데이터로 반환합니다. SocialCrawl은 구매자의 질문에 퍼플렉시티와 그록이 브랜드를 얼마나 자주 언급하는지 측정하고 소셜 소스 전체의 언급을 한 번의 호출로 수집합니다. 두 작업 모두 매주 반복 실행할 수 있으며 요금은 실행당 21크레딧부터입니다.

이 API로 할 수 있는 작업

각 작업은 호출 한 번 또는 몇 번의 연속 호출로 끝납니다. 카드 아래 줄이 실제 요청 순서입니다.

AI 답변에 브랜드가 나오는지 확인

브랜드와 구매자 질문을 보내고 경쟁사는 최대 5개까지 함께 넣습니다. 퍼플렉시티와 그록이 같은 질문에 여러 번 답하면 엔진별로 각 브랜드가 언급된 답변의 비율이 반환됩니다.

엔드포인트 순서prism/ai-visibility -> per_brand.visibility_pct

AI 엔진이 인용하는 사이트

모든 답변에는 인용한 도메인이 함께 반환되고 전체 실행을 합친 순위로 정리됩니다. web_baseline을 추가하면 인용된 도메인 가운데 아직 검색 순위에 오르지 못한 곳을 확인할 수 있습니다.

엔드포인트 순서prism/ai-visibility (include=web_baseline) -> citations

새 언급을 하루 한 번 수집

검색 한 번으로 소셜 소스 전체에서 브랜드명을 찾습니다. 일간 모니터(Monitor)가 이 검색을 다시 실행하고 결과를 웹훅으로 보냅니다.

엔드포인트 순서search/everywhere -> monitors (daily)

경쟁사와 비교하는 월간 리포트

Discover 실행 한 번으로 지난달 게시물을 브랜드와 경쟁사별로 모읍니다. 모든 게시물의 관련성과 입장을 판정한 뒤 브랜드별로 집계합니다.

엔드포인트 순서prism/discover (period=last_month, one group per brand)

언급량과 감성 추이

시작일을 지정하면 언급량과 감성이 시계열로 반환되고 추세 방향도 계산됩니다. 데이터는 공개 웹보다 며칠 늦게 반영되며 응답마다 감성 수치의 출처가 표시됩니다.

엔드포인트 순서prism/brand-mentions (date_from) -> computed trend

브랜드별 상위 게시물의 댓글

같은 Discover 실행에서 브랜드별 상위 게시물의 댓글을 읽고 감성을 분류합니다. 리포트에는 게시물과 함께 댓글 반응도 포함됩니다.

엔드포인트 순서prism/discover (comments=inline) -> comments.items

브랜드 모니터링 API 동작 방식

네 번의 호출로 두 가지 작업을 모두 처리합니다. 먼저 한 번씩 실행해 보고 계속 지켜볼 호출만 일정으로 등록합니다.

요금은 만료되지 않는 크레딧 팩에서 차감됩니다. 업스트림 호출이 실패하면 전액 환불되고 사용량 기반 호출은 쓰지 않은 크레딧이 환불됩니다.

GET /v1/prism/ai-visibility

AI 답변 점유율 측정

브랜드와 주제 또는 프롬프트 최대 20개, 경쟁사를 보냅니다. preset=quick이면 프롬프트마다 퍼플렉시티와 그록에서 5번씩 실행되고 엔진별 노출 비율과 인용 도메인이 반환됩니다.

프로브당 2크레딧, preset=quick 주제 1개는 최대 20크레딧

GET /v1/search/everywhere

소셜 언급 수집

한 번의 질의로 여러 소셜 소스에서 조회 기간 안의 게시물을 검색하고 순위를 매긴 결과를 공통 스키마로 반환합니다.

호출당 정액 20크레딧

POST /v1/prism/discover

월간 리포트 생성

POST 요청에 브랜드마다 그룹을 지정하고 period=last_month를 넣으면 백그라운드에서 실행됩니다. 결과는 브랜드별로 나뉘며 각 브랜드의 입장 집계가 포함됩니다. 먼저 dry_run으로 보내면 견적을 무료로 받습니다.

브랜드 6개, 1개월 339크레딧 (20/10/2026 측정)

GET /v1/prism/brand-mentions

추이 추적

키워드와 시작일을 보내면 기간 동안의 언급량과 감성, 계산된 추세 방향, 판정을 마친 최근 언급을 받습니다.

호출당 정액 50크레딧

정기 실행 플랜과 요금

아래 플랜은 각각 요청 한 번으로 등록합니다. 모니터는 호출을 정해진 주기로 다시 실행하고 결과를 웹훅으로 보냅니다. Discover 일정은 리포트를 다시 실행하고 이전 실행에서 받지 않은 게시물만 전달합니다.

AI 답변 속 브랜드 주간 점검

실행당 21크레딧

월 약 84크레딧

구매자 질문 1개를 경쟁사 2개와 함께 엔진마다 5번씩 실행합니다. 매주 결과가 이전 실행 대비 변화와 함께 웹훅으로 전달됩니다.

실행마다 호출하는 경로GET /v1/prism/ai-visibility

요청

curl -X POST "https://www.socialcrawl.dev/v1/monitors" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "recipe": "prism/ai-visibility",
  "params": {
    "brand": "acme",
    "topic": "best project management software",
    "competitors": "rival one,rival two",
    "preset": "quick"
  },
  "cadence": "weekly",
  "webhook_url": "https://example.com/hooks/socialcrawl",
  "name": "Acme in AI answers"
}'

소셜 언급 일간 수집

실행당 21크레딧

월 약 630크레딧

최근 하루 동안의 브랜드 언급을 소셜 소스에서 매일 한 번 수집해 웹훅으로 보냅니다.

실행마다 호출하는 경로GET /v1/search/everywhere

요청

curl -X POST "https://www.socialcrawl.dev/v1/monitors" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "recipe": "search/everywhere",
  "params": {
    "query": "acme",
    "lookback_days": 1
  },
  "cadence": "daily",
  "webhook_url": "https://example.com/hooks/socialcrawl",
  "name": "Acme mentions"
}'

경쟁사 비교 리포트 주간 실행

실행당 약 44크레딧

월 최대 1,500크레딧

브랜드 2개의 모든 게시물을 관련성과 입장으로 판정합니다. 실행마다 새 게시물만 전달되며 월 한도를 넘기기 전에 일정이 멈췄다가 다음 달에 다시 시작됩니다.

실행마다 호출하는 경로POST /v1/prism/discover

요청

curl -X POST "https://www.socialcrawl.dev/v1/prism/discover" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "groups": [
    {
      "id": "acme",
      "brand": "Acme"
    },
    {
      "id": "rival-one",
      "brand": "Rival One"
    }
  ],
  "period": "7d",
  "label": [
    "mention",
    "stance"
  ],
  "max_credits": 300,
  "schedule": {
    "every": "7d",
    "max_credits_per_run": 300,
    "max_credits_per_month": 1500,
    "name": "Acme weekly report"
  }
}'

요청에 "dry_run": true를 추가하면 일정을 만들기 전에 견적을 무료로 받습니다. 모니터 실행 1회 요금은 호출 요금에 1크레딧을 더한 값이며 실패한 실행은 환불됩니다.

무료로 시작하고 일정 등록 모니터 사용법 보기

데이터 출처

아래 플랫폼은 이 페이지의 호출이 데이터를 가져오는 소스입니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트 목록을 확인할 수 있습니다.

Prism이 페이지의 복합 호출입니다. AI 가시성과 Discover, 브랜드 언급을 제공합니다.

Perplexity측정 대상 답변 엔진입니다. 답변마다 인용 출처가 함께 나옵니다.

X그록 답변은 X의 AI 검색으로 수집됩니다. 측정 대상인 두 번째 엔진입니다.

Universal Search한 번의 질의로 소셜 소스를 함께 검색합니다.

Reddit브랜드를 두고 긴 의견이 오가는 곳입니다. 브랜드명으로 검색합니다.

TikTok키워드로 짧은 영상 속 언급을 검색합니다.

Instagram게시물과 브랜드별 상위 게시물의 댓글을 읽습니다.

YouTube리뷰와 비교 영상을 정확한 날짜 범위로 검색합니다.

일반적인 구성과 비교

보통 소셜 리스닝 도구와 AI 가시성 도구를 따로 구독합니다. 두 작업을 API 호출로 처리하면 아래 항목이 달라집니다.

Capability	SocialCrawl	일반적인 구성
커버리지	소셜 언급과 AI 답변을 같은 키로 조회하며 69개 플랫폼을 함께 사용할 수 있습니다.	소셜 리스닝용과 AI 가시성용으로 구독이 두 개 필요합니다.
응답 형태	모든 호출이 공통 스키마의 JSON을 반환하므로 자체 데이터베이스에 그대로 저장합니다.	도구마다 대시보드와 CSV 내보내기 형식이 다릅니다.
AI 답변	반복 실행한 결과로 엔진별 노출 비율과 답변이 인용한 도메인을 제공합니다.	답변 한 건을 직접 확인하거나 실행할 때마다 바뀌는 순위를 봅니다.
과금 방식	만료되지 않는 크레딧 팩으로 호출당 과금됩니다. 주간 AI 점검은 월 약 84크레딧입니다.	월 단위 사용자당 요금이며 추적 프롬프트나 채널마다 요금이 따로 부과되는 경우가 많습니다.
시작 방법	가입 시 무료 크레딧 100개가 제공되고 일정을 만들기 전에 dry run 견적을 무료로 받을 수 있습니다.	체험 전에 데모 미팅을 거칩니다.
정기 실행	모니터와 Discover 일정에 직접 정한 실행당 한도와 월 한도가 적용됩니다.	갱신 주기가 요금제 등급에 따라 정해져 있습니다.

브랜드 모니터링 API 자주 묻는 질문

브랜드 모니터링 API란 무엇입니까?

브랜드 모니터링 API는 브랜드를 언급한 공개 게시물과 AI 답변 엔진이 그 브랜드를 소개하는 방식을 구조화된 데이터로 반환합니다. 결과를 저장하고 실행 간에 비교해 알림이나 리포트를 직접 만들 수 있습니다.

AI 엔진이 우리 브랜드를 언급하는지 어떻게 확인합니까?

GET /v1/prism/ai-visibility에 브랜드와 구매자 질문 또는 프롬프트 목록, 경쟁사 최대 5개를 보냅니다. 퍼플렉시티와 그록이 프롬프트마다 여러 번 답하면 응답에 엔진별로 각 브랜드가 언급된 답변의 비율과 인용 도메인이 담깁니다.

어떤 AI 엔진을 측정합니까?

퍼플렉시티 소나와 그록입니다. 두 엔진 모두 웹 검색을 근거로 답하고 사용한 출처를 함께 반환합니다. 챗GPT와 제미나이, 클로드는 현재 측정하지 않으므로 결과는 두 엔진에 한정됩니다.

브랜드를 매주 모니터링하면 비용이 얼마입니까?

질문 1개로 주간 AI 가시성 점검을 하면 실행당 21크레딧, 월 약 84크레딧이며 API의 dry run 견적과 같은 금액입니다. 소셜 일간 수집은 실행당 21크레딧, 월 약 630크레딧입니다. 크레딧 팩은 만료되지 않고 가입 시 무료 크레딧 100개를 제공합니다.

경쟁사와 비교할 수 있습니까?

가능합니다. AI 가시성은 같은 답변에서 경쟁사를 최대 5개까지 측정합니다. Discover 실행은 브랜드마다 그룹을 따로 만들기 때문에 모든 게시물과 집계에 해당 브랜드가 표시됩니다.

변화가 생기면 알림을 받을 수 있습니까?

POST /v1/monitors로 모니터를 만듭니다. 실행할 때마다 결과와 이전 실행 대비 변화가 서명된 웹훅으로 전송됩니다. 알림 규칙을 설정하면 지표가 정한 기준을 넘을 때만 웹훅을 보냅니다.

이 데이터로 고객 리포트나 제품을 만들 수 있습니까?

사용자나 고객에게 가공해 보여 주는 형태라면 가능합니다. 약관은 대시보드와 리포트, 파생 제품을 허용하고 원본 데이터를 그대로 넘기거나 대량으로 재배포하는 것은 제한합니다.

AI에게 SocialCrawl을 물어보세요

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

무료 크레딧으로 브랜드 모니터링 시작

가입 시 무료 크레딧 100개를 제공합니다. 카드 등록이 필요 없고 일정마다 실행 전에 견적을 무료로 받을 수 있습니다.

무료로 시작 문서 보기

요청

curl "https://www.socialcrawl.dev/v1/prism/ai-visibility?brand=acme&topic=best%20project%20management%20software&competitors=rival%20one,rival%20two&preset=quick" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

curl "https://www.socialcrawl.dev/v1/search/everywhere?query=acme&lookback_days=7" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

첫 번째 호출은 질문 1개로 AI 답변을 측정하고 두 번째 호출은 최근 7일의 소셜 언급을 수집합니다. 키와 브랜드, 질문만 바꾸면 그대로 실행됩니다.