검색과 지역 확인, 최근 게시물 검토
키워드로 후보를 찾고 각 계정이 실제로 어느 시장에서 게시하는지 확인한 뒤 최근 영상을 확인합니다. 지역 확인 단계가 있어야 국내 캠페인 후보 목록이 해외 계정으로 채워지지 않습니다.
엔드포인트 순서
search/users -> profile/region -> profile/videos활용 사례
검증까지 포함한 인플루언서 검색 API
키워드나 해시태그로 크리에이터를 찾고 어느 시장에서 활동하는지 확인한 뒤 비용을 집행하기 전에 점수화합니다. 검색과 검증이 같은 키와 같은 스키마에서 동작합니다.
/v1/prism
선별과 점수화 후 집행
- GET /v1/tiktok/search/users
- GET /v1/instagram/search/profiles
- GET /v1/tiktok/profile/region
- GET /v1/prism/creator-vet
인플루언서 검색 API는 키워드와 니치, 해시태그로 크리에이터를 찾아 공개 프로필과 최근 게시물을 반환하므로 비용을 집행하기 전에 자격을 검증할 수 있습니다. SocialCrawl은 46개 플랫폼에서 검색과 지역 확인, 검증을 같은 키로 처리하며 참여 품질과 댓글 진정성, 게시 주기, 논란 신호를 하나의 점수화된 응답으로 반환합니다.
실제로 만들어지는 것
모두 현재 운영 중인 패턴입니다. 각 카드 아래의 엔드포인트 순서가 실제 호출 순서입니다.
집행 전 크리에이터 점수화
핸들을 전달하면 참여 품질과 댓글 진정성, 게시 주기, 논란 신호를 하나의 점수화된 레코드로 반환합니다. 메터링 호출이므로 전체 후보가 아니라 최종 후보 목록에 실행합니다.
엔드포인트 순서
prism/creator-vet (one handle, scored)해시태그에서 크리에이터로
니치 해시태그를 검색하고 상위 게시물의 계정을 확보한 뒤 각 프로필을 해석합니다. 해시태그 검색은 노출 최적화가 잘된 계정보다 실제로 활동하는 계정을 드러냅니다.
엔드포인트 순서
instagram/search/hashtag -> profile여러 네트워크의 통합 카드
같은 핸들의 틱톡과 인스타그램, 유튜브, X 작성자 정보를 통합 카드로 반환합니다. 한 네트워크의 팔로워 수만으로 크리에이터를 판단하지 않게 됩니다.
엔드포인트 순서
prism/creator-card (cross-platform card)니치 용어 기반 프로필 검색
해당 니치가 스스로를 설명할 때 쓰는 표현을 이미 알고 있다면 프로필을 직접 검색하고 확인이 필요한 계정만 해석합니다.
엔드포인트 순서
instagram/search/profiles -> profile링크 인 바이오 확장
링크 스택 페이지에는 크리에이터의 나머지 핸들과 상업용 링크가 정리되어 있습니다. 페이지가 공개되어 있고 접근 가능한 경우에만 조회되므로 발굴 단계가 아니라 보강 단계로 사용합니다.
엔드포인트 순서
linktree/page (resolve the link stack)인플루언서 검색 API 동작 방식
네 번의 호출로 니치에서 결정까지 이어집니다. 저렴한 호출은 전체 후보에, 메터링 호출은 최종 후보에 실행합니다.
조회는 크레딧으로 과금됩니다. 메터링 엔드포인트는 실제 반환량 기준으로 과금하며 업스트림 실패는 자동 환불됩니다.
GET /v1/tiktok/search/users후보 검색
키워드나 니치 표현으로 사용자를 검색하고 결과를 페이지 단위로 순회합니다. 각 행에 팔로워 수가 포함되므로 필터링은 자체 코드에서 처리합니다.
페이지당 1크레딧GET /v1/tiktok/profile/region활동 시장 확인
소개글의 국기 이모지로 추정하는 대신 계정이 게시하는 지역을 확인하고 후보 목록에 올립니다.
핸들당 1크레딧GET /v1/tiktok/profile/videos최근 게시물 검토
크리에이터의 최근 게시물을 조회하고 고정 게시물을 제외한 참여율을 직접 계산합니다.
페이지당 1크레딧GET /v1/prism/creator-vet집행 전 검증
최종 후보를 참여 품질과 댓글 진정성, 게시 주기, 논란 신호로 점수화합니다. 여러 플랫폼을 함께 확인할 수도 있습니다.
메터링, 50크레딧부터
크리에이터를 찾을 수 있는 플랫폼
모두 같은 키로 동작하는 레인입니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트를 확인합니다.
기존 구성과 비교
대부분 좌석 라이선스로 크리에이터 데이터베이스를 구매하거나 단일 네트워크 검색 위에 발굴 기능을 직접 만듭니다. 달라지는 지점은 다음과 같습니다.
| Capability | SocialCrawl | 일반적인 구성 |
|---|---|---|
| 데이터 시점 | 호출할 때마다 공개 프로필을 그 시점에 직접 조회합니다. | 공급업체 주기로 갱신되는 사전 색인 데이터베이스를 조회합니다. |
| 검증 신호 | 검증 호출에서 참여 품질과 댓글 진정성을 근거가 되는 원본 댓글과 함께 반환합니다. | 산출 근거를 확인할 수 없는 자체 점수만 제공합니다. |
| 지역 | 접촉 전에 계정이 어느 시장에서 게시하는지 확인합니다. | 소개글 텍스트로 국가를 추정하거나 값이 비어 있습니다. |
| 커버리지 | 같은 API 키로 46개 플랫폼과 375개 엔드포인트에서 검색과 검증을 처리합니다. | 네트워크마다 디렉터리가 따로 있거나 두 개 플랫폼에서 멈춥니다. |
| 과금 방식 | 소멸되지 않는 크레딧 팩에서 호출 단위로 차감하므로 단발성 캠페인 조사도 단발성 비용입니다. | 최소 좌석 수가 있는 연간 플랫폼 라이선스입니다. |
| 제품화 가능 여부 | 가공된 고객용 화면으로 제공하는 것이 약관에 명시적으로 허용됩니다. | 대개 제한되거나 건별 협의가 필요합니다. |
인플루언서 검색 API 자주 묻는 질문
인플루언서 검색 API란 무엇입니까?
인플루언서 검색 API는 키워드와 니치, 해시태그에 해당하는 크리에이터를 구조화된 레코드로 반환하고 각 크리에이터의 공개 프로필과 최근 게시물을 함께 제공합니다. 크리에이터 데이터베이스가 만들어지는 원본 데이터를 그대로 받아 자체 필터와 자체 점수 기준을 적용합니다.
팔로워 수와 니치, 국가로 필터링할 수 있습니까?
검색은 키워드나 해시태그를 받아 후보 프로필과 팔로워 수를 반환하므로 니치와 규모 필터링은 사전 색인 값이 아니라 조회 시점의 실제 수치로 자체 코드에서 처리합니다. 지역은 최종 후보에 실행하는 별도 확인 호출이며 소개글에서 국가를 읽는 방식보다 정확합니다.
참여 지표가 진짜인지 어떻게 판단합니까?
검증 호출을 실행하면 핸들의 참여 품질과 댓글 진정성, 게시 주기, 논란 신호를 반환합니다. 진성 댓글의 기준을 직접 정의하려면 크리에이터의 최근 게시물 댓글을 그대로 수집해 자체적으로 점수화할 수도 있습니다. 두 방식 모두 같은 키를 사용합니다.
같은 크리에이터를 다른 플랫폼에서 찾을 수 있습니까?
가능합니다. 크리에이터 카드 엔드포인트가 핸들 하나로 틱톡과 인스타그램, 유튜브, X의 작성자 레코드를 통합해 반환합니다. 링크 인 바이오 페이지가 공개되어 있고 접근 가능하면 크리에이터가 직접 정리한 핸들도 함께 확보됩니다.
캠페인 전에 참여율을 어떻게 계산합니까?
크리에이터의 최근 게시물을 조회하고 고정 게시물을 제외해 과거 흥행작이 평균을 왜곡하지 않게 한 다음, 남은 게시물의 참여 지표를 팔로워 수로 나눕니다. 조회 시점의 실제 게시물 데이터로 계산하므로 산출 방식을 그대로 설명할 수 있습니다.
크리에이터 단위로 과금합니까, 호출 단위로 과금합니까?
호출 단위입니다. 검색과 프로필 조회는 1크레딧이며 검증 호출은 크리에이터의 게시물과 댓글을 실제로 분석하므로 50크레딧부터 메터링됩니다. 캠페인 조사는 구독이 아니라 그때 발생하는 비용으로 처리됩니다.
이 데이터로 인플루언서 플랫폼을 만들 수 있습니까?
가공한 화면을 자체 사용자에게 제공하는 것은 가능합니다. 약관은 대시보드와 파생 제품을 허용하고 원본 전달과 대량 재배포를 제한합니다. 발굴 제품을 만드는 고객이 실제로 사용하는 형태이며 설계가 어디에 해당하는지 불확실하면 개발 전에 문의하시기 바랍니다.
AI에게 SocialCrawl을 물어보세요
요청
curl -G "https://socialcrawl.dev/v1/tiktok/search/users" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "query=skincare creator"curl -G "https://socialcrawl.dev/v1/prism/creator-vet" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "handle=charlidamelio" \
--data-urlencode "platform=tiktok"두 호출 모두 실제 데이터로 동작합니다. 키와 질의만 바꾸면 그대로 실행됩니다.