creator/
age-gender

Instagram, TikTok, YouTube, X, Threads 프로필 사진 속 얼굴로 크리에이터의 연령대와 성별을 추정하고 성별 추정의 신뢰도 점수를 반환합니다.

Age and Gender Detection API

프로필 URL 하나
연령대
신뢰도가 붙은 성별
5개 SNS
요청당 1 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Age and Gender Detection

크리에이터의 프로필 사진은 얼굴이 선명한 사진인 경우가 많아, 계정 주인의 대략적인 연령대와 성별을 빠르게 가늠할 수 있습니다. 이 조회는 사진을 추정 연령 범위와 신뢰도가 붙은 성별로 바꿔 주므로, 콘텐츠를 검토하기 전에 크리에이터 명단을 인구 통계 기준으로 정렬할 수 있습니다.

Age and Gender Detection API 주요 기능

  • 추정 연령 범위age_min과 age_max로 24세에서 30세처럼 추정 연령의 하한과 상한을 연 단위로 알려 줍니다.
  • 신뢰도가 붙은 성별gender는 male 또는 female을 반환하고, gender_confidence는 그 추정의 확실성을 0부터 100으로 나타냅니다.
  • 5개 SNS 입력 지원url에는 Instagram, TikTok, YouTube, X, Threads 프로필을 넣을 수 있으며 결과의 network와 username으로 계정을 식별합니다.
  • 조회마다 정확히 한 행요청마다 x:levelsio처럼 네트워크와 핸들을 합친 id를 가진 한 행을 반환하므로, 추정 결과를 크리에이터 목록에 바로 연결할 수 있습니다.

Age and Gender Detection API 매개변수

매개변수필수설명
url필수프로필 사진을 분석할 Instagram, TikTok, YouTube, X, Threads 프로필 URL 하나.

Age and Gender Detection API 사용 방법

크리에이터 프로필 URL 하나를 보내고 나이와 성별 추정 결과를 읽습니다.

  1. /v1/creator/age-gender에 {"url": "https://x.com/levelsio"}을 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items의 한 행을 읽고, 성별 값을 쓰기 전에 gender_confidence를 확인합니다.
curl -X POST "https://api.socq.ai/v1/creator/age-gender" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://x.com/levelsio"}'

Age and Gender Detection API 추천 활용 사례

  • 캠페인 페르소나에 맞는 크리에이터 선별: 후보 명단을 연령대와 성별로 걸러 캠페인 타깃 페르소나에 맞는 크리에이터만 콘텐츠 검토 단계로 보냅니다.
  • 크리에이터 DB 세분화: 각 레코드에 age_min, age_max, gender를 더하고 데이터베이스를 연령대별로 나눠 보고서와 캠페인 계획에 활용합니다.
  • 크리에이터 구성 균형 맞추기: 론칭 전에 섭외 예정 크리에이터의 연령과 성별 구성을 확인하고 한쪽에 치우쳐 있으면 조정합니다.

Age and Gender Detection API 활용 팁

  • 얼굴이 선명한 사진을 쓰는 개인 계정에 사용하세요. 얼굴 하나가 또렷하게 보일 때 나이와 성별 추정이 가장 정확합니다.
  • 자동 필터에서 성별을 쓰기 전에 gender_confidence 최솟값을 정하고, 그보다 낮은 결과는 수동 검토로 넘기세요.
  • 추정치는 범위로 보고 age_min과 age_max가 목표 연령대와 겹치는지로 크리에이터를 비교하세요.

Age and Gender Detection API 외에 Creator의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Influencer Email Finder API — Instagram, TikTok, YouTube, X, Facebook 프로필 하나로 크리에이터가 공개한 비즈니스 이메일을 찾아 각각 발견된 페이지와 함께 반환합니다.
  • Social Media Profile Finder API — 프로필 URL 하나로 크리에이터가 다른 SNS에서 운영하는 계정을 찾아 각각 0~1 신뢰도와 매칭 근거와 함께 반환합니다.

다른 플랫폼 둘러보기

Creator 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Age and Gender Detection API — 자주 묻는 질문

Age and Gender Detection API는 프로필 사진 속 얼굴로 크리에이터의 연령대와 성별을 추정하는 프로그래밍 인터페이스입니다. Instagram, TikTok, YouTube, X, Threads 프로필을 지원하며 성별 추정에 신뢰도 점수를 붙입니다.

프로필 사진의 얼굴을 분석해 연 단위 연령 범위와 성별을 산출하며, gender_confidence가 0부터 100으로 성별 추정의 확실성을 보여 줍니다.

프로필 사진에 얼굴 하나가 선명하게 나온 개인 계정입니다. 추정은 그 얼굴을 기준으로 하며, 각 행에 network와 username도 담겨 있어 원래 목록과 대조할 수 있습니다.

요청마다 Instagram, TikTok, YouTube, X, Threads 프로필 URL 하나를 보냅니다.

조회 한 번에 1 크레딧이 들고 한 행이 반환됩니다. 프로필이 존재하지 않으면 작업이 실패하고 전액 환불됩니다.