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. 엔드포인트 선택
프로필 URL 하나를 url에 넣어 /v1/creator/find-emails, /v1/creator/find-social-profiles, /v1/creator/age-gender 중 하나에 POST하고 task_id를 저장합니다.
2. 작업 추적
작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
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.itemsCreator 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 크레딧입니다.
이메일은 어디에서 찾나요?
소개란, 링크인바이오 페이지, 연결된 웹사이트, 크리에이터의 다른 계정에서 찾으며, 모든 이메일에 발견된 공개 페이지가 함께 붙습니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
Google Hotels API
목적지로 호텔을 검색하고, 원하는 호텔의 구글 호텔 프로필 전체와 1박 요금 캘린더를 가져옵니다. 세 API는 같은 호텔 ID로 연결됩니다.
Brand Monitoring API
브랜드, 제품, 주제를 언급한 웹 페이지를 찾아 페이지마다 감성과 감정을 점수로 매기고, 웹 전체에서 어떻게 이야기되는지 요약합니다.
AI Search API
AI 개요, ChatGPT, Google AI 모드가 시장의 질문에 어떻게 답하는지 추적합니다. 브랜드를 언급한 답변, 브랜드의 노출 수준, 답변이 인용한 도메인과 페이지를 알 수 있습니다.
Instagram API
공개 프로필을 조회하거나 찾고, 팔로워 목록 레코드, 팔로잉 관계, 작성 게시물, 프로필이 태그된 게시물, 해시태그 결과, 릴스, 스크립트, 댓글, 계정 수치, 참여도 지표, 미디어 메타데이터를 하나의 비동기 워크플로로 수집합니다.
TikTok API
지원하는 공개 TikTok 프로필, 개별 동영상 메타데이터, 최상위 댓글, 동영상 검색 결과, 지정한 해시태그의 동영상을 하나의 정규화된 비동기 워크플로로 수집합니다.
YouTube API
지원되는 공개 YouTube 채널 프로필, 동영상 상세 정보, 채널 동영상, 댓글, 쇼츠, 키워드·해시태그 결과, 제공되는 스크립트를 하나의 정규화된 비동기 워크플로로 수집합니다.


