해석과 조회, 지표 수집
핸들을 전달하면 프로필을 반환하고 이어서 최근 게시물과 각 게시물의 참여 지표를 조회합니다. 이 API에서 가장 많이 반복되는 순서이며 어느 네트워크를 지정해도 동작 방식이 같습니다.
엔드포인트 순서
profile -> profile/posts -> post/stats활용 사례
공개 계정을 분석하는 크리에이터 분석 API
핸들을 해석하고 게시물을 조회한 뒤 각 게시물의 참여 지표를 수집합니다. 같은 순서가 모든 네트워크에서 동일하게 동작하며, 배치 호출 한 번으로 여러 플랫폼의 게시물 URL 100개까지 현재 지표를 받습니다.
/v1/instagram
핸들 입력, 게시물과 지표 반환
- GET /v1/instagram/profile
- GET /v1/instagram/profile/posts
- GET /v1/tiktok/profile/videos
- GET /v1/prism/post-stats
크리에이터 분석 API는 공개 핸들을 해석해 프로필과 게시물, 게시물별 참여 지표를 구조화된 데이터로 반환합니다. SocialCrawl은 46개 플랫폼에서 같은 조회 순서를 사용하며, 배치 호출 한 번으로 여러 플랫폼의 게시물 URL 100개까지 현재 지표를 반환하고 실패한 URL은 환불합니다.
실제로 만들어지는 것
모두 현재 운영 중인 패턴입니다. 각 카드 아래의 엔드포인트 순서가 실제 호출 순서입니다.
게시물 100개를 한 번의 호출로
여러 플랫폼의 게시물 URL을 최대 100개까지 한 요청에 담아 현재 참여 지표를 받습니다. 과금은 성공한 URL 기준이며 삭제된 링크는 환불됩니다. 매일 아침 수백 번씩 호출하던 작업이 두 번의 호출로 줄어듭니다.
엔드포인트 순서
prism/post-stats (100 URLs per call)틱톡 크리에이터 피드
핸들을 해석한 뒤 영상 피드를 커서로 조회합니다. 자체 주기로 반복 실행하면 단일 시점 값이 아니라 게시물별 시계열이 쌓입니다.
엔드포인트 순서
tiktok/profile -> tiktok/profile/videos유튜브 채널 인벤토리
채널 레코드를 먼저 조회하고 영상과 쇼츠를 이어서 가져옵니다. 업로드별 참여 지표와 함께 게시 주기와 포맷 구성을 확인합니다.
엔드포인트 순서
youtube/channel -> channel/videos전체 아카이브 백필
최근 페이지만으로 부족할 때 계정의 전체 게시물 이력을 커서로 순회합니다. 백필은 한 번만 수행하고 이후에는 증분 조회로 전환합니다.
엔드포인트 순서
instagram/profile/posts/full (archive)핸들 하나를 여러 네트워크에서
플랫폼과 핸들 쌍을 최대 50개까지 전달하면 행마다 정규화된 작성자 레코드를 반환합니다. 해석에 실패한 핸들은 환불되므로 정리되지 않은 입력 목록도 비용 부담이 적습니다.
엔드포인트 순서
prism/profiles (one handle, many networks)크리에이터 분석 API 동작 방식
네 번의 호출로 전체 작업을 처리합니다. 이 중 두 개가 배치 엔드포인트이며 일일 로스터 운영 비용을 결정합니다.
조회는 크레딧으로 과금됩니다. 배치 엔드포인트는 성공한 행 기준으로 과금하며 삭제된 링크와 해석되지 않는 핸들은 자동 환불됩니다.
GET /v1/instagram/profile핸들 해석
핸들을 전달하면 정규화된 프로필을 반환합니다. 팔로워 수와 이후 호출에 필요한 계정 식별자가 포함됩니다.
1크레딧GET /v1/instagram/profile/posts게시물 조회
커서로 계정의 게시물을 순회합니다. 각 게시물에는 조회 시점의 참여 지표가 함께 담깁니다.
페이지당 1크레딧POST /v1/prism/post-stats지표 배치 갱신
여러 플랫폼의 게시물 URL을 최대 100개까지 한 요청에 담아 URL별 현재 참여 지표를 받습니다. 게시물마다 반복하던 루프를 대체합니다.
성공한 URL당 1크레딧GET /v1/prism/profiles프로필 배치 조회
플랫폼과 핸들 쌍을 최대 50개까지 한 요청에 담아 추적 중인 로스터 전체의 작성자 레코드를 받습니다.
해석된 핸들당 1크레딧
계정을 추적할 수 있는 플랫폼
모두 같은 키로 동작하는 레인입니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트를 확인합니다.
기존 구성과 비교
대부분 계정 연동을 요구하는 공식 API를 붙이거나 네트워크마다 스크래퍼를 직접 운영합니다. 달라지는 지점은 다음과 같습니다.
| Capability | SocialCrawl | 일반적인 구성 |
|---|---|---|
| 대상 계정 | 아직 계약하지 않은 크리에이터와 경쟁사를 포함해 모든 공개 계정을 조회합니다. | 도구에 연동하고 권한을 승인한 계정만 조회됩니다. |
| 배치 수집 | 여러 플랫폼의 게시물 URL을 요청당 100개까지 처리하고 성공한 URL 기준으로 과금합니다. | 게시물마다 요청이 필요해 일일 로스터가 수백 번의 호출이 됩니다. |
| 실패한 조회 | 삭제된 링크와 해석되지 않는 핸들은 자동으로 환불됩니다. | 결과가 없는 시도까지 포함해 요청 수로 과금합니다. |
| 지표 고지 | 플랫폼별로 어떤 지표가 외부 계정에 공개되는지 문서에 명시합니다. | 지표를 일괄로 약속하고 절반의 네트워크에서 조용히 누락됩니다. |
| 커버리지 | 같은 API 키로 46개 플랫폼의 크리에이터 계정을 조회합니다. | 네트워크마다 연동이 따로 있고 인증과 응답 형태도 제각각입니다. |
| 과금 방식 | 소멸되지 않는 크레딧 팩에서 호출 단위로 차감하므로 백필도 일회성 비용입니다. | 월 좌석 요금이거나 추적 크리에이터 수에 따른 등급제입니다. |
크리에이터 분석 API 자주 묻는 질문
크리에이터 분석 API란 무엇입니까?
크리에이터 분석 API는 공개 핸들을 프로필과 게시물, 게시물별 참여 지표 레코드로 변환합니다. 좌석 단위로 판매되는 대시보드 대신 직접 저장하고 자사 데이터와 결합하고 원하는 형태로 시각화할 수 있는 데이터를 받습니다.
내 계정이 아닌 계정에서 어떤 지표를 받을 수 있습니까?
팔로워와 팔로잉, 게시물 수, 게시물별 좋아요와 댓글, 작성 시각을 네트워크 전반에서 반환합니다. 조회수와 공유 수는 플랫폼이 공개하는 범위에서 반환되며 인스타그램의 경우 릴스 같은 영상 형식에 해당합니다. 인스타그램은 저장 수를 어떤 제공자에게도 공개하지 않고 스토리 지표는 계정 소유자만 확인할 수 있으므로 타인 계정의 저장 수와 스토리 지표는 어떤 API로도 조회되지 않습니다.
자사 계정뿐 아니라 경쟁사도 추적할 수 있습니까?
가능합니다. 모두 공개 데이터를 조회하므로 대상 계정이 무언가를 연동하거나 추적 사실을 인지할 필요가 없습니다. 자사 계정과 같은 주기로 경쟁사 집합을 추적하는 방식이 가장 일반적인 사용 형태입니다.
매일 로스터 전체의 참여 지표를 수집하려면 어떻게 합니까?
배치 지표 엔드포인트를 사용합니다. 여러 플랫폼의 게시물 URL을 최대 100개까지 한 요청에 담아 보내고 자체 수집 시각과 함께 저장합니다. 실패한 URL은 환불되므로 삭제된 링크가 섞여 있어도 그만큼은 과금되지 않습니다.
크리에이터의 전체 게시물 이력을 백필할 수 있습니까?
가능합니다. 아카이브 엔드포인트가 계정의 전체 게시물 이력을 커서로 순회합니다. 오래된 계정은 수천 건에 이르므로 백필은 한 번만 수행하고 커서 위치를 저장한 뒤 이후 게시물은 증분으로 조회합니다.
참여율은 어떻게 계산합니까?
최근 게시물을 조회하고 고정된 게시물을 제외해 과거 흥행작이 평균을 왜곡하지 않게 한 다음, 남은 게시물의 참여 지표를 팔로워 수로 나눕니다. 공유 수는 좋아요보다 조작하기 어렵기 때문에 가중치를 더 두는 방식도 함께 사용됩니다.
크리에이터 단위로 과금합니까, 호출 단위로 과금합니까?
호출 단위입니다. 조회는 크리에이터별 구독이 아니라 소멸되지 않는 크레딧 팩에서 차감됩니다. 계정 20개를 추적하든 2,000개를 추적하든 차이는 사용량이며 라이선스 등급이 아닙니다. 가입 시 무료 크레딧 100개를 제공하고 카드 등록이 필요하지 않습니다.
AI에게 SocialCrawl을 물어보세요
요청
curl -G "https://socialcrawl.dev/v1/instagram/profile/posts" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "handle=natgeo"curl -X POST "https://socialcrawl.dev/v1/prism/post-stats" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
-H "content-type: application/json" \
-d '{"urls":["https://www.instagram.com/p/ABC/","https://www.tiktok.com/@user/video/123"]}'두 호출 모두 실제 데이터로 동작합니다. 키와 핸들만 바꾸면 그대로 실행됩니다.