계정명 하나로 전체 네트워크 확인
계정명과 확인할 네트워크를 전달하면 해당 계정명이 존재하는 네트워크의 공개 프로필을 반환합니다. 특정 네트워크를 참고가 아니라 확정으로 다뤄야 한다면 그 플랫폼의 프로필 호출로 다시 확인합니다.
엔드포인트 순서
prism/handle-audit (one handle, every network)활용 사례
공개 계정을 네트워크 전반에서 확인하는 조회 API
계정명 하나를 모든 네트워크에 한 번에 확인합니다. 공개 프로필만 조회하므로 어떤 계정이 공식 계정인지, 어떤 계정이 브랜드명을 도용하는지, 각 계정이 실제로 무엇을 게시하는지 확인합니다.
/v1/prism
계정명 하나로 전체 네트워크 확인
- GET /v1/prism/lookup
- GET /v1/prism/handle-audit
- GET /v1/prism/profiles
- GET /v1/google/search
크로스 플랫폼 계정 조회 API는 공개 계정명 하나를 여러 네트워크에서 동시에 확인하고 존재하는 프로필을 반환합니다. 어떤 계정이 공식 계정이고 어떤 계정이 브랜드를 사칭하는지 판단할 수 있습니다. SocialCrawl은 46개 플랫폼을 공개 프로필 데이터로만 조회하며 비공개 기록 조회와 연락처 확인, 익명 해제 기능을 제공하지 않습니다.
실제로 만들어지는 것
모두 현재 운영 중인 패턴입니다. 각 카드 아래의 엔드포인트 순서가 실제 호출 순서입니다.
여러 프로필 동시 조회
컴포지트 호출 하나로 여러 프로필을 요청한 뒤 이상한 계정만 상세 조회합니다. 계정 확인 작업은 대부분 넓게 펼친 다음 한 건만 깊게 보는 형태로 끝납니다.
엔드포인트 순서
prism/profiles -> per-platform profile웹 검색에서 출발
사이트 지정 검색으로 브랜드나 공개 계정이 이미 어디에 존재하는지 먼저 확인합니다. 계정명이 네트워크마다 일치하는 경우가 드물기 때문에 실무에서 가장 흔한 첫 단계입니다.
엔드포인트 순서
google/search site: -> platform profileURL을 레코드로 변환
지원 네트워크의 링크를 전달하면 어떤 플랫폼 엔드포인트를 호출해야 하는지 몰라도 구조화된 프로필이나 게시물을 반환합니다. 입력이 정제된 계정명이 아니라 보고서에서 추출한 링크 목록일 때 유용합니다.
엔드포인트 순서
prism/lookup (any URL, structured)브랜드 보호 점검
같은 브랜드명을 주기적으로 네트워크 전반에 조회하고 결과를 비교합니다. 브랜드명과 로고, 제품명을 사용하는 신규 계정이 확인 대상이며 실행 간 차이로 드러납니다.
엔드포인트 순서
instagram/profile -> tiktok/profile자기 신고 링크 페이지 대조
크리에이터 링크 페이지는 본인이 직접 계정을 밝히는 유일한 지점이므로 협업 검증에 유용합니다. 페이지가 응답하는 경우에만 확인되므로 증명이 아니라 보조 근거로 다루어야 합니다.
엔드포인트 순서
linktree/page -> resolve each link계정 조회 API 동작 방식
네 번의 호출로 계정명 하나에서 공개 계정의 전체 분포를 확인합니다. 넓게 펼친 뒤 중요한 항목만 확정합니다.
조회는 크레딧으로 과금됩니다. 목록 엔드포인트에서 결과가 없으면 과금되지 않고 업스트림 실패는 자동 환불됩니다. 반환되는 데이터는 모두 공개 프로필 정보입니다.
GET /v1/prism/handle-audit계정명 점검
계정명과 플랫폼 목록을 전달하면 해당 계정명으로 존재하는 공개 프로필을 반환합니다. 확산 단계이며 상황을 가장 빠르게 파악하는 방법입니다.
호출당GET /v1/prism/profiles프로필 일괄 조회
확인된 프로필을 컴포지트 레코드 하나로 요청합니다. 팔로워 수와 소개, 인증 상태가 응답 여섯 개가 아니라 한 화면에 정렬됩니다.
호출당GET /v1/google/search웹 검색 병행
사이트 지정 질의로 계정명 표기가 다른 네트워크를 찾습니다. 계정명은 달라져도 브랜드명은 유지됩니다.
호출당GET /v1/prism/lookup남은 URL 처리
남은 URL을 엔드포인트 하나에 전달하면 소속 플랫폼과 관계없이 구조화된 레코드를 반환합니다.
호출당 정액
조회 대상 네트워크
모두 같은 계정 조회 과정에서 동작하는 레인입니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트를 확인합니다.
기존 방식과 비교
대부분 계정을 직접 하나씩 확인하거나 사용자명 선점 여부만 알려 주는 도구를 사용합니다. 달라지는 지점은 다음과 같습니다.
| Capability | SocialCrawl | 일반적인 구성 |
|---|---|---|
| 반환 내용 | 소개와 팔로워 수, 최근 게시물을 포함한 공개 프로필 전체를 반환하므로 어느 계정이 진짜인지 판단합니다. | 사용 중인지 여부만 표시하고 브랜드와 선점자를 구분할 근거를 제공하지 않습니다. |
| 커버리지 | 키 하나로 신규 네트워크와 개발자 플랫폼을 포함한 46개 플랫폼을 조회합니다. | 고정된 목록을 사용하며 네트워크 구조가 바뀌면 갱신이 멈춥니다. |
| 데이터 범위 | 공개 프로필 데이터만 사용하며 그 범위를 명시적으로 밝힙니다. | 출처를 모호하게 표기해 컴플라이언스 검토에서 질문이 남습니다. |
| 계정명 불일치 | 사이트 지정 웹 검색으로 표기가 다른 네트워크까지 찾아냅니다. | 완전 일치만 확인하므로 한 글자만 다른 사칭 계정을 놓칩니다. |
| 과금 방식 | 소멸되지 않는 크레딧 팩으로 호출당 과금하므로 비정기 점검 비용이 낮게 유지됩니다. | 점검 실행 여부와 무관하게 월 좌석 요금이 청구됩니다. |
| 시작 방법 | 가입 시 무료 크레딧을 제공하며 첫 호출을 바로 실행합니다. | 영업 미팅 후 온보딩을 진행합니다. |
계정 조회 API 자주 묻는 질문
크로스 플랫폼 계정 조회 API란 무엇입니까?
공개 계정명 하나를 여러 소셜 네트워크에서 한 번에 확인하고 해당 계정명으로 존재하는 공개 프로필을 반환하는 API입니다. 계정이 어디에 있는지, 어느 계정이 공식인지, 어느 계정이 브랜드명을 무단으로 사용하는지 판단하는 데 사용합니다.
어떤 데이터를 사용합니까?
공개 프로필 데이터만 사용합니다. 계정명과 표시 이름, 소개, 팔로워 수, 인증 상태, 공개 게시물이며 해당 프로필을 방문한 사람이 보는 것과 동일한 정보입니다. 비공개 기록과 구매한 신원 데이터, 로그인 이후 영역은 사용하지 않습니다.
전화번호나 이메일로 사람을 찾을 수 있습니까?
불가능합니다. 전화번호와 이메일 주소를 비롯한 개인 식별자로 조회하는 기능이 없고 익명 해제 절차도 제품 어디에도 없습니다. 입력은 공개 계정명이나 공개 URL, 검색어이고 출력은 공개 프로필입니다.
어떤 용도로 사용합니까?
브랜드 보호와 계정 검증이 주된 용도입니다. 자사 공식 계정을 네트워크 전반에서 확정하고, 브랜드명이나 로고를 도용한 사칭 계정을 찾고, 협업 전에 크리에이터 계정을 검증하며, 기관과 공인의 공개 계정을 조사 목적으로 추적하는 작업입니다.
GDPR을 준수합니까?
SocialCrawl은 공개 데이터만 반환하며 유럽 컴플라이언스 요건이 있는 고객도 이 기준으로 사용합니다. 저장하는 데이터의 관리 주체와 처리의 법적 근거는 고객에게 있으므로 보관 기간을 짧게 두고 문서화한 목적 범위 안에서 사용하시기 바랍니다. 데이터 처리 기준은 요청하시면 공유합니다.
계정명이 플랫폼마다 일치합니까?
일치하는 경우가 많지만 항상 그렇지는 않습니다. 그래서 권장 순서가 계정 점검과 사이트 지정 웹 검색을 함께 쓰는 형태입니다. 점검이 완전 일치를 빠르게 잡아내고 검색이 같은 브랜드가 다른 이름으로 활동하는 네트워크를 잡아냅니다. 단일 일치는 결론이 아니라 단서로 다루어야 합니다.
계정 확인 비용은 얼마입니까?
조회는 소멸되지 않는 크레딧 팩에서 차감됩니다. 좌석이 아니라 호출 단위로 과금합니다. 컴포지트 확산 호출은 단건 프로필 호출보다 비싸지만 여러 호출을 대체합니다. 가입 시 무료 크레딧 100개를 제공하며 카드 등록이 필요하지 않습니다.
AI에게 SocialCrawl을 물어보세요
요청
curl -G "https://socialcrawl.dev/v1/prism/handle-audit" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "handle=nasa" \
--data-urlencode "platforms=instagram,tiktok,youtube,twitter"curl -G "https://socialcrawl.dev/v1/prism/lookup" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "url=https://www.tiktok.com/@nasa"두 호출 모두 실제 데이터로 동작합니다. 키와 계정명만 바꾸면 그대로 실행됩니다.