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 하나를 보내고 나이와 성별 추정 결과를 읽습니다.
- /v1/creator/age-gender에 {"url": "https://x.com/levelsio"}을 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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가 목표 연령대와 겹치는지로 크리에이터를 비교하세요.
관련 API
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 신뢰도와 매칭 근거와 함께 반환합니다.