URL 조회
0 크레딧 (패스스루)/v1/prism/lookup소셜 또는 쇼핑 URL을 넣으면 플랫폼과 리소스를 해석해 게시물, 프로필, 영상, 상품 데이터를 한 봉투로 반환합니다. 과금은 해석된 엔드포인트를 따릅니다.
url, include
SocialCrawl API 키로 Prism 컴포지트 엔드포인트를 호출합니다. URL 조회, 다중 플랫폼 핸들, 브랜드 인텔리전스, 위기, GEO, 게시물·프로필 배치를 구조화 JSON으로 반환합니다. 호출은 크레딧으로 과금됩니다.
활성 컴포지트 엔드포인트는 33개입니다.
/v1/prism 아래 활성 컴포지트 엔드포인트는 33개입니다. 소셜 URL 해석, 다중 플랫폼 핸들 조회, 브랜드·위기 인텔리전스, AI 가시성, 게시물·프로필 배치 갱신을 제공합니다. 데이터 API만 지원하며 게시와 비공개 계정 접근은 포함되지 않습니다.
/v1/prism/lookup소셜 또는 쇼핑 URL을 넣으면 플랫폼과 리소스를 해석해 게시물, 프로필, 영상, 상품 데이터를 한 봉투로 반환합니다. 과금은 해석된 엔드포인트를 따릅니다.
url, include
/v1/prism/commentsTikTok, YouTube, Facebook, Reddit, Hacker News, Instagram 게시물 URL의 댓글을 끝까지 수집합니다. 플랫폼이 허용하면 답글을 중첩합니다.
url, max, replies, cursor, sort, limit
/v1/prism/creator-card핸들 하나를 여러 플랫폼에서 병렬 조회합니다. 플랫폼별 팔로워, 인증, 소개, 식별자를 반환하고 없는 플랫폼은 null입니다.
handle, platforms, include
/v1/prism/handle-audit핸들을 여러 플랫폼에 걸쳐 채점합니다. 종합 판정, 플랫폼별 점수, 활동 신호, 전량 수집 예상 크레딧을 반환합니다.
handle, platforms, sample
/v1/prism/voiceX, Threads, Bluesky, Truth Social의 최근 게시물을 시간순 단일 피드로 묶고 실제 활동 플랫폼도 함께 반환합니다.
handle, platforms, cursor, include
/v1/prism/video-intel영상 URL 하나의 상세, 지표, 댓글, 선택 자막을 반환합니다. TikTok과 Instagram에서는 댓글 작성자 프로필 일부를 포함합니다.
url, comments, include
/v1/prism/answers여러 AI 검색 엔진에 같은 질문을 던집니다. 각 답변 원문, 합친 인용, 일치·불일치 지점을 반환합니다.
query, engines, include
/v1/prism/brand-mentions키워드 하나의 기간별 언급량, 긍정·부정 비율, 주요 출처, 최근 멘션 샘플을 한 호출로 반환합니다.
keyword, date_from, date_to, date_group, page_type, include
/v1/prism/demand-signals웹 언급 추이, Reddit 속도, 상품 리뷰 수준, 선택적 앱 리뷰 속도를 합쳐 투명한 소비자 수요 지수를 만듭니다.
keyword, google_play_id, app_store_id, signals, amazon_query, country, date_from, date_to, depth
/v1/prism/campaign해시태그 또는 문구 캠페인의 전·중·후 언급량, 플랫폼별 인게이지먼트, 주요 확산 계정을 반환합니다.
hashtag or phrase, window_start, window_end, pre_days, post_days, include
/v1/prism/ai-visibility답변 엔진이 프롬프트 묶음에서 브랜드를 얼마나 언급하는지와 인용 도메인을 집계합니다. AEO·GEO 추적에 사용합니다.
brand, prompts, topic, competitors, engines, runs, preset, include
/v1/prism/crisis-radar오늘 언급량과 부정 비율을 최근 일별 기준선과 비교합니다. calm, watch, alert, crisis 상태를 주기 점검용으로 반환합니다.
brand, sensitivity, confirm, baseline_days, date_to
/v1/prism/crisis-postmortem웹, Reddit, Hacker News, 소셜을 아울러 브랜드 위기의 발단, 정점, 확산 경로 타임라인과 요약을 반환합니다.
brand, window_start, window_end, crisis_terms, include
/v1/prism/reputationTrustpilot, 앱스토어, Google Business, 웹 감성을 합산한 평판 점수와 주제별 장단점, 인용을 반환합니다.
brand, sources, country, depth, place, axis, app_store_id, google_play_id, include
/v1/prism/share-of-voice브랜드 2~5개의 인게이지먼트 가중 점유율을 웹·소셜로 나누고 감정 분포와 브랜드별 추이를 반환합니다.
brands, category_code, market_shares, include, page_type, date_from, date_to
/v1/prism/leads경쟁사 대안을 묻거나 이탈을 밝힌 공개 게시물·댓글을 모아 순위 피드로 반환합니다.
competitor, product_category, freshness, include, limit
/v1/prism/devtool-pulse개발자 도구의 GitHub 정보, Hacker News 반응, Reddit 언급, 블로그 보도와 상태 요약 라벨을 반환합니다.
query, repo, subreddit, include, date_from, date_to
/v1/prism/launch-echo출시 반응으로 Hacker News 주요 스레드·댓글, 블로그 보도, 선택적 GitHub 저장소 맥락을 반환합니다.
query, repo, threads, date_from, date_to, include
/v1/prism/org-radarGitHub 조직의 주요 저장소, 릴리스, 열린 이슈 부담, 대표 기능 요청과 불만 신호를 조직 단위로 반환합니다.
org, repos, sort, include
/v1/prism/earned-media브랜드를 언급한 뉴스·테크 매체·최신 웹 기사를 중복 없이 순위화하고 주요 매체를 함께 반환합니다.
brand, competitor, date_from, date_to, min_domain_rank, include
/v1/prism/truthsocial-pulseTruth Social 계정 하나의 프로필, 최근 게시물, 상위 게시물 상세, 관련 뉴스, 활동·감성 요약을 반환합니다.
handle, drill, posts, news_query, include, cursor
/v1/prism/audience-overlapTikTok 크리에이터 두 명의 댓글 작성자층 중복을 공통 인원, 중복 점수, 고유 인원, 신뢰도로 반환합니다.
handle_a, handle_b, platform, videos_per_creator, depth
/v1/prism/employer-brandReddit, 뉴스, YouTube의 근무 경험 이야기를 모읍니다. linkedin_url이 있으면 회사 LinkedIn 게시물 톤도 붙입니다.
company, linkedin_url, surfaces, phrases, timeframe, date_from, date_to
/v1/prism/audience-questionsReddit과 YouTube에서 실제 질문을 모아 누가·무엇을·왜·어떻게·비교 등 의도별로 묶어 반환합니다.
topic, platforms, max_questions, threads_per_source, timeframe, include
/v1/prism/product-reviewsAmazon, Google Shopping, Trustpilot에서 제품 하나의 리뷰를 모아 출처별 평점, 판매처 비교, 주제를 반환합니다.
query or asin or gid, sources, country, depth, competitors, include
/v1/prism/apps-lookupGoogle Play와 App Store 등록 정보를 나란히 비교합니다. 평점, 설치, 가격, 스토어 차이, 매칭 신뢰도를 반환합니다.
title or google_play_id or app_store_id, stores, country, language, match_threshold, include
/v1/prism/app-reviewsGoogle Play와 App Store 리뷰를 함께 모아 평점 요약, 주제 클러스터, 감성 추이, 기능 요청, 개발사 응답률을 반환합니다.
google_play_id, app_store_id, query, country, language, depth, stores, include
/v1/prism/creator-vet인게이지먼트율, 댓글 진성도, 게시 빈도, 뉴스·포럼 논란 이력을 크리에이터 검증 신호로 반환합니다.
handle, platform, depth, include
/v1/prism/korea-gap글로벌 대화와 한국어 대화의 차이를 반환합니다. Naver 표면, 채널별 분포, 번역 예시 인용이 포함됩니다.
query, include, date_from, date_to, display
/v1/prism/review-integrityAmazon, Google Shopping, Trustpilot, 공개 웹 평점을 대조해 A~F 등급을 냅니다. 결정적 통계이며 LLM을 쓰지 않습니다.
query or asin or gid, sources, country
/v1/prism/post-stats혼합 플랫폼 게시물 URL 최대 100개를 POST합니다. 조회·좋아요·댓글·공유·저장 수를 입력 순서대로 URL당 한 행으로 반환합니다.
body urls (1-100), include
/v1/prism/comment-lookup이미 아는 댓글 최대 25개를 POST해 현재 상태를 다시 확인합니다. 항목마다 found, not found, errored, deferred를 표시합니다.
body items (1-25)
/v1/prism/profiles플랫폼·핸들 쌍 최대 50개를 POST합니다. 입력 순서로 프로필과 행 상태를 반환하며 형태는 단일 profile 호출과 같습니다.
body items (1-50)
소셜이나 쇼핑 링크를 그대로 넣으면 그 URL이 가리키는 게시물과 프로필, 영상, 상품 데이터를 응답 하나에 담아 반환합니다.
URL은 있는데 어느 플랫폼 엔드포인트가 맞는지 모를 때 사용하세요. 링크 파싱과 라우팅을 직접 짤 필요가 없습니다.
0크레딧
url · Absolute http(s) URL of a single post, video, product or repo. Profile, channel and storefront URLs are NOT accepted: use that platform's own `/profile` endpoint for those.
$ curl https://www.socialcrawl.dev/v1/prism/lookup?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ \
-H "x-api-key: sc_YOUR_API_KEY"// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Prism은 /v1/prism 아래 SocialCrawl 컴포지트 계층입니다. API 키로 GET 또는 POST를 호출하고 라이브 작업에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 별도 SDK와 컴포지트용 플랫폼 OAuth는 없습니다.
x-api-key 헤더에 키를 보냅니다. /v1/prism 전 레시피와 카탈로그 나머지에 같은 SocialCrawl 키를 사용합니다.
대부분 Prism 라우트는 쿼리 파라미터 GET입니다. post-stats, comment-lookup, profiles는 JSON 본문 POST입니다. 과금 전에 형식을 검증합니다.
컴포지트는 레시피별 고정 티어, 프로브 종량, 또는 배치 항목 단위로 과금합니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다. 잘못된 파라미터는 400이며 과금하지 않습니다.
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 많은 컴포지트는 감사용 legs[] 또는 항목별 상태를 함께 반환합니다.
대부분 제품은 URL 또는 핸들에서 시작한 뒤 크리에이터·보이스 맥락을 보고, 모니터링이 목표면 브랜드·위기 인텔리전스로 이어집니다.
GET /v1/prism/lookup?url=…lookup입니다. 해석된 플랫폼 경로와 게시물·프로필 페이로드를 반환합니다.
링크는 있고 플랫폼 엔드포인트를 모를 때 사용합니다. Prism이 라우팅하고 해석된 레그를 과금합니다.
GET /v1/prism/creator-card?handle=…&platforms=…creator-card입니다. 핸들당 플랫폼별 Author 카드를 반환합니다.
깊은 수집이나 협업 전에 존재 여부와 팔로워를 확인합니다.
GET /v1/prism/handle-audit?handle=…handle-audit입니다. 채점 판정과 수집 예상 비용을 반환합니다.
전량 수집 전에 리스크와 크레딧을 사전 점검합니다.
GET /v1/prism/brand-mentions?keyword=…&date_from=…brand-mentions입니다. 언급량 타임라인, 감성, 출처를 반환합니다.
정체성이 확정된 뒤 키워드 모니터링에 사용합니다.
GET /v1/prism/lookup
?url=https://www.tiktok.com/@…/video/…
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
# multi-platform handle
GET /v1/prism/creator-card?handle=mrbeast&platforms=tiktok,instagram,youtube
GET /v1/prism/handle-audit?handle=mrbeast{
"success": true,
"data": {
"resolved": {
"platform": "tiktok",
"resource": "post",
"path": "/v1/tiktok/post"
},
"result": {
"id": "7123456789",
"url": "https://www.tiktok.com/@…/video/…",
"content": { "text": "Example caption" }
}
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}Prism은 여러 스크래퍼를 이어 붙인 원본이 아니라 완성된 컴포지트 객체를 반환합니다. 소셜 리프가 있으면 SocialCrawl 아키타입 필드명을 유지합니다.
lookup의 resolved 경로와 result, creator-card·handle-audit의 플랫폼별 카드·점수·누락 null
언급 타임라인, 감성 분할, 점유 지표, 캠페인 리프트 구간, 주제·인용 포함 평판
엔진 답변과 인용, 일치 맵, AI 답변 내 브랜드 언급률, 인용 도메인 순위
post-stats, profiles, comment-lookup: 입력 순서 항목 행과 상태, 인게이지먼트 또는 프로필 리프
다른 /v1 표면과 같은 요청 수명주기입니다. Prism은 별도 인증 경로가 아니라 레지스트리 엔드포인트 위의 컴포지트 오케스트레이션입니다.
Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 키 단위 한도와 동시성을 적용합니다.
레지스트리에서 prism 리소스를 찾습니다. 필수 파라미터와 본문 형식 검증이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 팬아웃 전에 레시피 비용을 차감하거나 종량 배치 홀드를 겁니다.
platform, resource, params로 캐시 키를 만듭니다. 히트면 credits_used 0으로 즉시 반환합니다. 미스면 레시피에 따라 플랫폼 레그, 콘텐츠 분석, AI 프로브를 병렬 실행하며 정책에 따라 재시도와 서킷 브레이커를 적용합니다.
레그를 Analytics 또는 배치 결과로 합치고 응답 계약을 검증한 뒤 성공 봉투로 감쌉니다. 레그 과금 레시피는 영수증을 붙이고 빌링 감사에 남깁니다.
과금 규칙
Prism은 SocialCrawl 소셜 읽기, 콘텐츠 분석, 앱스토어, 마켓플레이스, AI 답변 엔진 위의 컴포지트 계층입니다. 여러 스크래퍼 대신 키 하나와 봉투 하나를 사용합니다.
완성된 컴포지트 작업을 제공합니다. URL 해석, 핸들 감사, 브랜드 모니터링, 리뷰 등급, AI 가시성, 게시물 배치 갱신입니다. 읽기 전용이며 게시와 비공개 수신함 접근은 없습니다.
각 레시피는 등록된 플랫폼 엔드포인트와 분석 레그를 병렬로 호출한 뒤 코드에서 융합·채점합니다. 계약이 정한 등급은 결정적입니다. LLM은 내러티브나 클러스터링이 문서화된 경우에만 사용합니다.
success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. 컴포지트 data 객체와 선택적 legs[] 영수증으로 출처 기여를 감사할 수 있습니다.
쓰기 엔드포인트는 없습니다. /v1/prism 아래 플랫폼별 profile/full은 없습니다. 해당 경로는 각 플랫폼 허브에 있습니다. 비공개·인증 소셜 콘텐츠 보장은 없습니다.
이 API가 가장 많이 사용되는 작업입니다.
크로스 플랫폼 해석, 브랜드 인텔리전스, 크리에이터 사전 점검
호출은 lookup, creator-card, handle-audit, brand-mentions와 플래그십 인텔리전스(share-of-voice, review-integrity, ai-visibility, crisis)에 집중됩니다. 모니터링 루프에서는 post-stats 배치가 사용됩니다. URL 라우팅, 다중 플랫폼 핸들, 브랜드·위기 인텔리전스, GEO 프로브, 종량 배치 갱신을 단일 API 키 아래 컴포지트 계층으로 제공합니다.
단순 해석과 핸들 카드는 라이브 미스 시 보통 수 초입니다. 다중 소스 인텔리전스 레시피는 레그 팬아웃·융합 때문에 더 느립니다.
Prism 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
brand-mentions, crisis-radar, earned-media를 고정 주기로 돌립니다. calm을 벗어나면 crisis-postmortem으로 이어집니다.
creator-card와 handle-audit을 먼저 쓰고 지출 전에 creator-vet 또는 audience-overlap을 봅니다. 카탈로그와 같은 키를 사용합니다.
URL 라우팅은 lookup, 배치 갱신은 post-stats와 profiles, 완성된 등급·SOV 수치가 필요하면 인텔리전스 레시피를 사용합니다.
lookup 또는 creator-card로 시작합니다. 캐시 히트는 무료입니다. 인텔리전스 레시피와 POST 배치는 엔드포인트별 상위 티어를 따릅니다.
curl "https://www.socialcrawl.dev/v1/prism/lookup?url=https://www.tiktok.com/@mrbeast/video/7123456789" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/prism/creator-card?handle=mrbeast&platforms=tiktok,instagram,youtube" \
-H "x-api-key: sc_your_api_key_here"모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
같은 Prism 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | 엔드포인트를 직접 하나씩 호출 |
|---|---|---|
| 플랫폼 판별 | URL만 보고 플랫폼과 엔드포인트를 자동으로 알아내요 | URL 패턴마다 맞는 엔드포인트를 직접 연결해야 해요 |
| 익혀야 할 호출 | 지원하는 15가지 URL을 요청 형태 하나로 처리해요 | 플랫폼마다 다른 요청을 익히고 연결해야 해요 |
| 요금 | 추가 수수료 없이 원래 엔드포인트 요금만 내요 | 엔드포인트 요금은 같고, 라우팅 로직은 직접 관리해야 해요 |
| 응답 형태 | resolved{} 라우팅 블록과 legs[]가 담긴 통일된 JSON으로 와요 | 플랫폼마다 원본 응답을 직접 정규화해야 해요 |
| 유지보수 | 엔드포인트나 URL 형식이 바뀌어도 라우팅이 최신으로 유지돼요 | 플랫폼이 링크를 바꾸면 URL 파싱이 깨져요 |
플랫폼 판별
익혀야 할 호출
요금
응답 형태
유지보수
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기AI에게 SocialCrawl을 물어보세요