이름으로 성별 추정
이름이나 전체 이름으로 성별을 추정하세요
신뢰도와 예측 출처가 포함된 추정 결과를 받을 수 있습니다. 예측할 수 없는 경우 V2는 이를 알 수 없는 결과로 명확하게 표시합니다.
- 이름과 전체 이름
- 국가를 알고 있을 때 선택적으로 보내는 국가 컨텍스트
- 라틴 문자와 비라틴 문자 체계의 이름
GenderAPI.io · REST API v2
이름, 이메일 주소, 사용자 이름을 위한 Gender API
이름, 전체 이름, 이메일 주소 또는 사용자 이름으로 가능성이 높은 성별을 추정하세요. GenderAPI.io V2는 예측 출처, 신뢰도와 선택적 국가 컨텍스트를 구조화된 JSON으로 반환합니다.
GenderAPI.io V2
이름으로 V2 요청 보내기
GET
https://api.genderapi.io/api/v2/gender?type=name&value=Hyejin2026년 10월 1일에 받은 실제 V2 응답입니다. 요청을 보내면 실시간 결과를 확인할 수 있습니다.
| 이름 | Hyejin |
|---|---|
| 성별 | 여성 |
| 신뢰도 | 99% |
| 국가 | 대한민국 (KR) |
| 출처 | 이름 데이터셋 |
| 사용한 크레딧 | 1 |
{
"data": {
"input": {
"type": "name",
"value": "Hyejin",
"country": null
},
"name": "hyejin",
"gender": "female",
"country": "KR",
"confidence": 0.9900990099009901,
"confidence_kind": "observed_frequency",
"sample_count": 303,
"source": "dataset",
"result_status": "identified",
"reason": null,
"country_source": "dataset",
"match": {
"name": "hyejin",
"method": "normalized",
"scope": "global",
"country": null
}
},
"meta": {
"request_id": "2a295e0b-94ba-4643-b457-75aa52d0fa36",
"duration_ms": 9,
"access": {
"mode": "api_key",
"reason": null
},
"usage": {
"charged_credits": 1,
"remaining_credits": 49999,
"billing_status": "confirmed",
"resets_at": null,
"limit": null,
"period_seconds": null
}
}
}이름과 전체 이름 분석
전 세계 이름을 위한 Gender API
항목을 하나씩 확인하거나, 일괄 요청을 보내거나, 스프레드시트 도구를 사용하세요. V2는 예측이 있는 결과와 없는 결과를 구분하므로 애플리케이션이 추측하지 않고 불확실성을 그대로 유지할 수 있습니다.
- 지원 범위는 이름과 국가에 따라 다릅니다
- 전 세계
- 출처와 해석 기준을 함께 제공하는 신뢰도
- 0–1
- 결과와 사용한 크레딧을 JSON으로 반환
- V2
- API 키 사용 시 일괄 요청당 항목 수, IP 체험은 10개
- 50
이메일로 성별 추정
이메일 주소에 담긴 이름 신호를 활용하세요
일반적인 이메일 형식에서 이름 신호를 해석하고, 추정 결과와 그 출처로 CRM, 리드 및 분석 데이터를 보강하세요.
- 개인 및 업무용 이메일 주소
- CRM 레코드 보강
- 응답에 포함된 신뢰도와 출처
사용자 이름으로 성별 추정
사용자 이름과 별명을 분석하세요
사용자 이름에 포함된 알려진 이름을 인식합니다. forceToGenderize를 사용하면 실제 이름이 없는 별명도 추정을 요청할 수 있지만, 예측이 보장되지는 않습니다.
- 소셜 미디어와 커뮤니티의 사용자 데이터
- 선택적 별명 분석
- 예측이 없을 때의 명확한 상태 표시
Excel 및 CSV 처리
이름 목록을 한 번에 처리하세요
Excel 또는 CSV 파일을 업로드하고 원본 열을 선택한 뒤 결과를 내려받으세요. 자체 애플리케이션에서 일괄 요청을 보내려면 V2 일괄 요청 가이드를 참고하세요.
- Excel 및 CSV 파일
- 이름, 전체 이름 또는 이메일 주소 열
- 선택적 국가 컨텍스트
GenderAPI.io 연동
API를 연동하거나 이미 쓰는 도구와 연결하세요
REST API로 시작하거나 GenderAPI.io를 스프레드시트, 이커머스 플랫폼 및 자동화 도구와 연결하세요. 각 가이드에는 해당 연동이 사용하는 API 버전이 안내되어 있습니다.
REST APIGoogle SheetsExcel 및 CSVShopifyAirtableZapierMakeIntegrately
모든 연동 보기자주 묻는 질문
시작하기 전에 알아둘 내용
요청 유형, 신뢰도, 무료 사용과 크레딧 비용을 확인하세요. 요청 형식과 코드 예시는 V2 문서에서 볼 수 있습니다.
자주 묻는 질문 모두 보기GenderAPI.io는 무엇인가요?
GenderAPI.io는 이름, 이메일 주소 또는 사용자 이름으로 가능성이 높은 성별을 추정합니다. V2는 예측, 신뢰도, 출처와 사용한 크레딧을 JSON으로 반환합니다. 이 결과는 이름 패턴에 기반한 추정이며, 본인이 밝힌 성별 정체성을 확인하는 것이 아닙니다.
V2는 언제 AI를 사용하나요?
단일 요청은 먼저 데이터셋을 조회합니다. 데이터셋에서 예측을 얻지 못하면 기본적으로 AI를 사용합니다. 이 기본 모드는 AI 사용을 포함해 총 1크레딧입니다. 일괄 요청에서는 AI가 기본적으로 꺼져 있습니다. AI 모드를 선택하거나 별명 분석을 위해 forceToGenderize를 켤 수 있습니다.
신뢰도와 알 수 없는 결과는 어떻게 해석하나요?
V2의 confidence 필드에는 0부터 1까지의 값 또는 null이 들어갑니다. confidence_kind 필드는 데이터셋에서 관측된 빈도와 모델이 보고한 값을 구분합니다. 신뢰도가 결과의 정확성을 보장하지는 않습니다. 예측이 없으면 응답에 gender: null과 result_status: unknown이 포함됩니다.
요청 한 번에 크레딧이 얼마나 드나요?
V2의 기본 요청은 AI를 사용하거나 정상 처리된 결과에 예측이 없는 경우에도 1크레딧입니다. AI 모드 always는 2크레딧입니다. forceToGenderize를 사용하면 데이터셋 예측은 1크레딧이고, AI가 필요하면 총 2크레딧입니다. 일괄 요청은 항목별로 과금됩니다.
요청 한 번에 여러 항목을 보낼 수 있나요?
예. V2는 유효한 API 키를 사용하면 일괄 요청당 최대 50개 항목을, IP 체험에서는 최대 10개 항목을 받습니다. 따라서 HTTP 요청 한 번에 여러 크레딧이 사용될 수 있습니다. 더 큰 파일은 Excel·CSV 도구나 다른 연동으로도 처리할 수 있습니다.
API를 무료로 사용해 볼 수 있나요?
API 키가 없으면 V2 데모는 24시간마다 10크레딧을 제공하는 IP 체험을 사용하며, 이 크레딧은 같은 IP 주소를 쓰는 모든 사용자가 공유합니다. 무료 계정에는 매일 200크레딧이 제공됩니다. 이는 고정된 요청 횟수가 아니라 크레딧 한도이므로 2크레딧이 드는 모드를 쓰면 잔액이 더 빨리 줄어듭니다.
기존 API 키를 V2에서도 사용할 수 있나요?
예. V1과 V2는 같은 API 키와 같은 계정 잔액을 사용합니다. 기존 V1 연동은 계속 작동합니다. 엔드포인트, 응답 필드와 오류 형식이 V1과 다르므로 새 연동은 V2 문서를 기준으로 구축하세요.
개발 시작하기
GenderAPI.io를 무료로 사용해 보세요
계정을 만들고 매일 제공되는 200크레딧으로 첫 요청을 테스트한 뒤, 필요할 때 Excel 또는 CSV 파일을 처리하세요.