활용 사례

공개 소셜과 뉴스, 웹을 조회하는 OSINT 모니터링 API

사건과 정책, 공공기관을 소셜과 뉴스, 웹에서 질의 하나로 추적합니다. 모든 소스가 공개 출처이고 결과는 같은 스키마로 반환되며 같은 호출을 사안이 지속되는 기간 동안 자체 주기로 재실행합니다.

/v1/search

공개 출처를 질의 하나로 조회

GET /v1/search/everywhere
GET /v1/prism/brand-mentions
GET /v1/truthsocial/user/posts
GET /v1/facebook/events/search

OSINT 모니터링 API는 사건과 지역, 공공기관에 관한 공개 게시물과 기사, 웹 페이지를 수집해 분석자가 사안의 전개를 따라갈 수 있게 합니다. SocialCrawl은 질의 하나를 소셜과 뉴스, 웹을 포함한 46개 플랫폼으로 확장하고 결과를 하나의 공통 스키마로 반환하며 비공개 기록에는 접근하지 않습니다.

실제로 만들어지는 것

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

전체 소스 상시 질의

질의와 조회 기간을 전달하면 소셜과 포럼, 뉴스, 웹의 결과를 함께 반환합니다. 자체 주기로 실행하면 네트워크별 연동 없이 관제 데스크의 수집 계층이 됩니다.

엔드포인트 순서search/everywhere (standing query, lookback)

기간 지정 대상 추적

지정한 두 날짜 사이에 하나의 대상을 네트워크 전반에서 추적하고 일 단위로 묶습니다. 얼마나 시끄러웠는지가 아니라 언제 시작됐는지를 확인할 때 사용하며 사후 검토에서 실제로 중요한 질문입니다.

엔드포인트 순서prism/brand-mentions (date-ranged entity)

공인 계정 조회

특정 공개 계정의 게시물을 짧은 주기로 조회합니다. 인물 검색이 아니라 공식 계정이나 공인 프로필 한 건에 대한 모니터링이며 대상은 이미 공개적으로 발언하는 계정입니다.

엔드포인트 순서truthsocial/user/posts (public figure)

뉴스 확인 후 본문 수집

지역별 뉴스 검색으로 보도를 찾은 뒤 페이지에서 본문을 가져옵니다. 자동 수집을 차단하는 언론사 페이지가 있으므로 헤드라인 레코드를 확정 데이터로 두고 본문은 확보되는 만큼만 사용합니다.

엔드포인트 순서google_news/search -> web/scrape

지역 사건 재구성

장소와 키워드로 공개 이벤트를 검색해 특정 지역과 날짜에 무엇이 예정돼 있었는지 재구성합니다. 운영 중인 표면 중 가장 안정적이며 API로 제공되는 경우 자체가 드뭅니다.

엔드포인트 순서facebook/events/search (local incident)

확산 여부 점검

하나의 대상에 컴포지트 조회를 실행해 특정 네트워크에서만 튀는지 여러 네트워크로 번지는지 확인합니다. 실제 사건과 단발성 화제를 가르는 기준이 이 분포입니다.

엔드포인트 순서prism/crisis-radar

OSINT 모니터링 API 동작 방식

네 번의 호출로 수집과 시계열, 지역 세부를 처리합니다. 넓게 조회한 뒤 결과가 나온 레인만 파고듭니다.

조회는 크레딧으로 과금됩니다. 목록 엔드포인트에서 결과가 없으면 과금되지 않고 업스트림 실패는 자동 환불됩니다. 모든 소스는 공개 출처입니다.

GET /v1/search/everywhere

전체 소스 조회

질의와 조회 기간을 전달하면 소셜과 포럼, 뉴스, 웹의 결과를 하나의 스키마로 반환합니다. 수집 단계입니다.

호출당 정액

GET /v1/prism/brand-mentions

시계열 구성

대상과 기간을 전달해 흩어진 언급을 그래프로 그리고 근거로 제시할 수 있는 날짜별 계열로 만듭니다.

호출당

GET /v1/google_news/search

뉴스 레인 추가

언어와 지역을 지정한 뉴스 검색을 실행합니다. 별도 도구가 아니라 소셜과 같은 자리에서 지역 보도를 확인합니다.

호출당

GET /v1/facebook/events/search

지역 세부 확인

특정 장소와 특정 날짜가 쟁점이면 장소와 키워드로 공개 이벤트를 검색합니다.

호출당

모니터링 가능한 소스

모두 같은 상시 질의에서 동작하는 레인입니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트를 확인합니다.

Universal Search아래 모든 소스로 질의 하나를 한 번에 확장하며 조회 기간과 선택적 소스 필터를 지원합니다.

Truth Social공인 프로필 단건 모니터링입니다. 범위가 좁게 설계돼 있으며 실제 사용 목적과 일치합니다.

X날짜 구간과 계정 필터를 지원하는 근거 기반 검색으로 X에서 해당 사안이 논의되는 양상을 확인합니다.

Reddit불리언 검색과 전체 댓글 트리를 제공합니다. 대용량 소스 중 가장 안정적이며 주장이 반복되지 않고 반박되는 곳입니다.

Facebook페이지 게시물과 댓글, 공개 이벤트 검색을 제공합니다. 이벤트 검색은 제품에서 가장 안정적인 엔드포인트이며 지역 사건 조사가 의존하는 지점입니다.

YouTube날짜 구간 고급 검색과 그 아래 댓글을 제공하며 사건의 영상 보도를 확인합니다.

Threads시작일과 종료일을 지정한 키워드 검색입니다. 기존 네트워크에서 사용자가 이동한 시장에서 중요합니다.

Google News언어와 지역을 지정한 뉴스 검색입니다. 단독 소스가 아니라 소셜과 나란히 놓는 레인으로 사용합니다.

Bluesky신규 네트워크의 기관 계정과 공개 계정을 프로필과 게시물로 조회합니다.

Prism기간 지정 대상 추적과 확산 점검을 호출 하나로 처리하는 컴포지트입니다.

Web ScrapingAPI가 없는 소스를 검색하고 수집합니다. 입찰 공고와 고시, 지역 목록이 해당합니다. 자동 수집을 거부하는 페이지가 있으므로 일부만 확보될 수 있습니다.

Tavily본문 추출을 포함한 근거 기반 웹 검색이며 지역 언어 뉴스 질의도 지원합니다.

기존 구성과 비교

대부분 엔터프라이즈 모니터링 플랫폼을 구매하거나 스크래퍼를 직접 유지합니다. 달라지는 지점은 다음과 같습니다.

Capability	SocialCrawl	일반적인 구성
커버리지	키 하나로 소셜과 뉴스, 웹을 포함한 46개 플랫폼을 조회합니다.	소셜 도구와 별도 뉴스 공급업체, 나머지를 담당할 스크래퍼를 함께 운영합니다.
데이터 범위	공개 출처만 사용하며 모든 플랫폼에 같은 기준을 적용하고 그 범위를 명시합니다.	출처가 혼재해 컴플라이언스 검토에서 업체별로 확인해야 합니다.
산출물	공통 스키마의 구조화된 레코드를 반환하므로 저장과 비교, 출처 URL 인용이 바로 가능합니다.	대시보드로 제공하고 내보내기는 유료 옵션으로 분리합니다.
시계열 작업	기간과 일 단위 그룹을 질의 파라미터로 지정하므로 날짜별 계열이 호출 한 번에 나옵니다.	차트로 볼 수는 있지만 동일하게 재현하기 어렵습니다.
과금 방식	소멸되지 않는 크레딧 팩으로 호출당 과금하므로 단기 관제는 단기 비용으로 끝납니다.	상시 조직을 전제로 한 연간 플랫폼 라이선스로 청구됩니다.
시작 방법	가입 시 무료 크레딧을 제공하며 첫 호출을 바로 실행합니다.	구매 절차를 거친 뒤 온보딩을 진행합니다.

OSINT 모니터링 API 자주 묻는 질문

OSINT API란 무엇입니까?

OSINT API는 특정 사안과 사건, 조직에 관한 공개 게시물과 기사, 웹 페이지를 구조화된 데이터로 반환합니다. 여러 사이트를 직접 수집하던 작업을 질의 하나로 대체하고 결과를 저장하고 인용할 수 있는 단일 스키마로 반환합니다.

어떤 소스를 조회합니까?

SocialCrawl은 46개 플랫폼과 375개 엔드포인트를 제공합니다. 소셜 네트워크와 포럼, 지역별 뉴스, 공개 이벤트 목록, 웹을 포함합니다. 질의 하나를 전부에 동시에 실행하거나 해당 관제에 필요한 레인만 지정할 수 있습니다.

공개 데이터만 사용합니까?

공개 데이터만 사용합니다. 반환되는 모든 항목은 해당 페이지나 프로필을 방문한 사람이 보는 것과 동일하게 공개된 정보입니다. 비공개 기록 접근과 로그인 이후 데이터, 구매한 신원 데이터, 익명 해제 기능은 제품 어디에도 없습니다.

개인을 모니터링하는 데 사용할 수 있습니까?

이 API는 공인과 공식 계정, 조직, 장소, 주제를 대상으로 설계됐습니다. 일반 개인에 대한 비공개 기록과 연락처, 관계 그래프를 제공하지 않으므로 개인 표적 워크플로는 지원하지 않습니다. 공인과 기관 모니터링이 지원되는 형태입니다.

공개 데이터 모니터링은 GDPR을 준수합니까?

SocialCrawl은 공개 데이터만 반환하며 유럽 컴플라이언스 요건이 있는 고객도 이 기준으로 사용합니다. 저장하는 데이터의 관리 주체와 처리의 법적 근거는 고객에게 있으므로 목적을 문서화하고 보관 기간을 짧게 두며 수집 범위를 그 목적에 맞추시기 바랍니다. 데이터 처리 기준은 요청하시면 공유합니다.

상시 관제를 주기적으로 실행할 수 있습니까?

가능합니다. 자체 스케줄러에서 질의를 재실행하는 방식입니다. 이 API의 운영 모니터링은 대부분 크론 작업이나 n8n 워크플로, 엣지 함수가 고정 질의를 폴링하고 새 결과를 저장하는 형태입니다. 동일 대상을 반복 조회하는 방식이 가장 일반적인 운영 패턴입니다.

상시 모니터링 비용은 얼마입니까?

조회는 소멸되지 않는 크레딧 팩에서 차감됩니다. 좌석 수나 채널 수가 아니라 실행한 호출 수에 따라 비용이 결정됩니다. 짧은 관제는 짧은 관제에 해당하는 비용으로 끝납니다. 가입 시 무료 크레딧 100개를 제공하며 카드 등록이 필요하지 않습니다.

AI에게 SocialCrawl을 물어보세요

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

첫 관제 질의 실행

가입 시 무료 크레딧 100개를 제공합니다. 공개 출처만 사용하며 카드 등록과 구매 절차가 없습니다.

무료로 시작 문서 보기

요청

curl -G "https://socialcrawl.dev/v1/search/everywhere" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  --data-urlencode "query=port strike supply disruption" \
  --data-urlencode "lookback_days=3"

curl -G "https://socialcrawl.dev/v1/prism/brand-mentions" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  --data-urlencode "keyword=municipal budget vote" \
  --data-urlencode "date_from=2026-07-01" \
  --data-urlencode "date_to=2026-08-01"

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