기본 사용법
첫 번째 Gender API 요청 보내기
입력값 하나를 보내면 예측 성별, 신뢰도, 국가 정보와 사용량을 받을 수 있습니다. 이름으로 시작하고, 보유한 데이터가 이메일이나 사용자 이름이라면 해당 전용 엔드포인트를 사용하세요.
인증
key 쿼리 매개변수로 API 키를 추가합니다. 운영용 키는 서버에 안전하게 보관하고 브라우저 코드나 공개 저장소에 노출하지 마세요.
기계 판독형 API 리소스
최신 GenderAPI 계약을 OpenAPI, Swagger 또는 Postman 형식으로 사용하세요.
GET
이름으로 성별 예측
이름 또는 전체 이름
입력값이 이름 또는 전체 이름이라면 기본 엔드포인트를 사용합니다.
https://api.genderapi.io/apicURL
curl "https://api.genderapi.io/api?name=Jiwon&country=KR&key=YOUR_API_KEY"선택 매개변수
| 매개변수 | 유형 | 설명 |
|---|---|---|
country | string | KR 또는 US 같은 두 글자 국가 코드입니다. |
askToAI | boolean | true이면 데이터베이스에서 이름을 찾지 못했을 때 AI 보완 분석을 요청합니다. |
forceToGenderize | boolean | 사람 이름처럼 보이지 않는 특이한 입력도 예측하도록 시도합니다. |
주의해서 사용하세요. 판타지 이름, 별명 또는 이름 신호가 약한 입력에 대한 강제 예측은 정확도가 낮을 수 있습니다.
GET
이메일로 성별 예측
이메일 주소
이메일 엔드포인트는 주소에서 이름을 추출한 뒤 성별 예측을 수행합니다.
https://api.genderapi.io/api/emailcURL
curl "https://api.genderapi.io/api/email?email=jiwon.kim%40example.com&country=KR&askToAI=true&key=YOUR_API_KEY"이름이 내부에서 추출되므로 이 엔드포인트에서는
forceToGenderize를 사용할 수 없습니다.GET
사용자 이름으로 성별 예측
소셜 미디어 사용자 이름
알아볼 수 있는 이름이 포함된 사용자 이름, 핸들 및 별명에는 이 엔드포인트를 사용합니다.
https://api.genderapi.io/api/usernamecURL
curl "https://api.genderapi.io/api/username?username=jiwon_kim&country=KR&askToAI=true&forceToGenderize=true&key=YOUR_API_KEY"JSON 응답
GenderAPI 응답 구조 이해하기
세 엔드포인트 모두 동일한 핵심 응답 구조를 사용합니다.
200 OK
{
"status": true,
"used_credits": 1,
"remaining_credits": 4999,
"expires": 1743659200,
"q": "Jiwon",
"name": "jiwon",
"gender": "female",
"country": "KR",
"total_names": 325,
"probability": 98,
"duration": "4ms"
}응답 필드
| 필드 | 유형 | 설명 |
|---|---|---|
status | boolean | 요청이 성공적으로 처리되었는지 나타냅니다. |
used_credits | integer | 이번 요청에 사용된 크레딧 수입니다. |
remaining_credits | integer | 요청 처리 후 남은 크레딧 수입니다. |
expires | integer | 요금제 만료 시각을 나타내는 UNIX 타임스탬프입니다. |
q | string | 전송한 이름, 이메일 또는 사용자 이름 원문입니다. |
name | string | 정규화되었거나 입력에서 추출된 이름입니다. |
gender | string | 예측 결과입니다. male, female 또는 "null"을 반환합니다. |
country | string | 가장 가능성이 높은 ISO 3166-1 alpha-2 국가 코드입니다. |
total_names | integer | 예측에 활용된 이름 레코드 수입니다. |
probability | integer | 성별 예측 신뢰도를 백분율로 표시합니다. |
duration | string | 서버에서 요청을 처리하는 데 걸린 시간입니다. |
입력값은 항상 URL 인코딩하세요
공백과 특수 문자는 HTTP 클라이언트에서 인코딩해야 합니다. 예를 들어 일반 공백 대신jiwon%20kim을 사용하세요.
다음 단계