API 목록으로 돌아가기
크리에이터 인텔리전스

Creator 데이터 API

Instagram, TikTok, YouTube, X, Facebook, Threads 프로필 하나에서 출발해 크리에이터의 공개 비즈니스 이메일, 다른 SNS 계정, 프로필 사진 기반 나이·성별 추정을 가져옵니다.

사용할 수 있는 Creator API

공개 연락처 이메일은 Influencer Email Finder API, 다른 SNS 계정은 Social Media Profile Finder API, 프로필 사진 기반 추정은 Age and Gender Detection API를 사용합니다.

어떤 크리에이터 데이터를 가져올 수 있나요?

모든 Creator API는 프로필 URL 하나를 받아, 보낸 프로필과 연결된 정규화된 행을 반환합니다.

공개 비즈니스 이메일

소개란, 링크인바이오 페이지, 연결된 웹사이트, 다른 계정에 공개된 연락처 이메일을 찾아 각각 발견된 페이지와 함께 반환합니다.

다른 SNS 계정

크리에이터의 다른 SNS 계정을 네트워크, 사용자 이름, URL, 0~1 신뢰도, 매칭 근거와 함께 나열합니다.

연령대와 성별

프로필 사진 속 얼굴로 연령 범위와 성별을 추정하고 0~100 신뢰도를 붙입니다.

출발 프로필 정보

조회한 네트워크, 핸들, 프로필 URL을 모든 행에 남겨 기존 크리에이터 명단과 쉽게 연결합니다.

SocQ와 수작업 크리에이터 조사 비교

SocQ는 프로필 URL을 요청 한 번으로 구조화된 행으로 바꿉니다. 수작업 조사는 소개란, 링크 페이지, 웹사이트, 다른 SNS를 하나씩 열어 찾은 내용을 직접 기록해야 합니다.

기능SocQ수작업 조사
시작 입력요청마다 프로필 URL 하나각 SNS와 페이지를 직접 검색
이메일 탐색 범위소개란, 링크인바이오 페이지, 연결된 웹사이트, 다른 계정(이메일마다 출처 페이지 포함)페이지를 하나씩 방문
SNS 간 매칭모든 매칭에 신뢰도 점수와 근거계정마다 개인 판단
결과물데이터베이스에 바로 넣을 수 있는 정규화된 행직접 관리하는 메모와 스프레드시트

Creator API 작동 방식

모든 Creator API는 SocQ 공통 비동기 작업과 저장된 결과 흐름을 따릅니다.

  1. 1. 엔드포인트 선택

    프로필 URL 하나를 url에 넣어 /v1/creator/find-emails, /v1/creator/find-social-profiles, /v1/creator/age-gender 중 하나에 POST하고 task_id를 저장합니다.

  2. 2. 작업 추적

    작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 결과 행 읽기

    data.results.items를 읽고, has_more가 true인 동안 next_cursor를 따라갑니다.

크리에이터의 공개 비즈니스 이메일 찾기

SocQ API 키로 인증하고 프로필 URL 하나를 보냅니다. 이메일을 찾은 조회는 8 크레딧, 찾지 못한 조회는 0.5 크레딧입니다.

curl -X POST "https://api.socq.ai/v1/creator/find-emails" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/miguelangeles"}'

# Poll GET /v1/tasks/{task_id}
# Read the emails and their source_urls in data.results.items

Creator API 주요 활용 사례

인플루언서 섭외

캠페인 후보 명단의 모든 크리에이터에 공개 비즈니스 이메일과 그 출처를 붙입니다.

SNS 통합 크리에이터 레코드

크리에이터의 TikTok, YouTube, X, Facebook 계정을 하나의 레코드에 모으고 SNS 간 중복을 병합합니다.

인구 통계 기준 선별

콘텐츠를 검토하기 전에 추정 연령대와 성별로 크리에이터 명단을 거릅니다.

제한 사항과 공개 데이터 정책

Creator API는 공개 프로필과 공개 페이지를 기반으로 동작하며, 요청마다 프로필 URL 하나를 받습니다.

  • Influencer Email Finder와 Social Media Profile Finder는 Instagram, TikTok, YouTube, X, Facebook 프로필을 받으며, 이메일 조회에서는 YouTube 채널을 @handle이나 채널 ID로도 지정할 수 있습니다.
  • Age and Gender Detection은 Instagram, TikTok, YouTube, X, Threads 프로필을 받으며 얼굴이 선명한 개인 계정에 적합합니다.
  • Influencer Email Finder는 크리에이터가 공개한 이메일을, 각 이메일이 실린 페이지와 함께 반환합니다.
  • 존재하지 않는 프로필이면 작업이 실패하고 전액 환불됩니다.

Creator API 자주 묻는 질문

Creator API란 무엇인가요?

SNS 프로필 URL 하나에서 출발해 크리에이터의 공개 비즈니스 이메일, 다른 SNS 계정, 프로필 사진 기반 나이·성별 추정을 돌려주는 세 가지 조회 API입니다.

어떤 SNS에서 시작할 수 있나요?

이메일·계정 조회는 Instagram, TikTok, YouTube, X, Facebook, 나이·성별 추정은 Instagram, TikTok, YouTube, X, Threads에서 시작할 수 있습니다.

Creator API 요금은 어떻게 되나요?

Influencer Email Finder는 이메일을 찾으면 8 크레딧, 찾지 못하면 0.5 크레딧이고, Social Media Profile Finder는 조회당 8 크레딧, Age and Gender Detection은 조회당 1 크레딧입니다.

이메일은 어디에서 찾나요?

소개란, 링크인바이오 페이지, 연결된 웹사이트, 크리에이터의 다른 계정에서 찾으며, 모든 이메일에 발견된 공개 페이지가 함께 붙습니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.