# 이름, 이메일 주소, 사용자 이름을 위한 Gender API

> 이름, 전체 이름, 이메일 주소 또는 사용자 이름으로 가능성이 높은 성별을 추정하세요. GenderAPI.io V2는 예측 출처, 신뢰도와 선택적 국가 컨텍스트를 구조화된 JSON으로 반환합니다.

Canonical HTML: https://www.genderapi.io/ko

Last reviewed: 2026-09-30

## 개요

이름, 전체 이름, 이메일 주소 또는 사용자 이름으로 가능성이 높은 성별을 추정하세요. GenderAPI.io V2는 예측 출처, 신뢰도와 선택적 국가 컨텍스트를 구조화된 JSON으로 반환합니다.

## 이름으로 V2 요청 보내기

요청마다 1크레딧이 사용됩니다. 저장된 API 키가 없거나 키를 인식할 수 없으면 24시간마다 10크레딧을 제공하는 IP 체험이 사용되며, 이 크레딧은 같은 IP 주소를 쓰는 모든 사용자가 공유합니다.

2026년 10월 1일에 받은 실제 V2 응답입니다. 요청을 보내면 실시간 결과를 확인할 수 있습니다.

**응답 예시이며 실시간 요청의 결과가 아닙니다**

```json
{
  "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
    }
  }
}
```

- [HTML 페이지에서 실시간 데모 열기](https://www.genderapi.io/ko#name-demo)

## 전 세계 이름을 위한 Gender API

항목을 하나씩 확인하거나, 일괄 요청을 보내거나, 스프레드시트 도구를 사용하세요. V2는 예측이 있는 결과와 없는 결과를 구분하므로 애플리케이션이 추측하지 않고 불확실성을 그대로 유지할 수 있습니다.

지원 범위는 이름과 국가에 따라 다릅니다: 전 세계

출처와 해석 기준을 함께 제공하는 신뢰도: 0–1

결과와 사용한 크레딧을 JSON으로 반환: V2

API 키 사용 시 일괄 요청당 항목 수, IP 체험은 10개: 50

## 이름이나 전체 이름으로 성별을 추정하세요

신뢰도와 예측 출처가 포함된 추정 결과를 받을 수 있습니다. 예측할 수 없는 경우 V2는 이를 알 수 없는 결과로 명확하게 표시합니다.

- 이름과 전체 이름

- 국가를 알고 있을 때 선택적으로 보내는 국가 컨텍스트

- 라틴 문자와 비라틴 문자 체계의 이름

- [이름용 V2 API 살펴보기 →](https://www.genderapi.io/ko/docs/v2/gender-from-name)

## 이메일 주소에 담긴 이름 신호를 활용하세요

일반적인 이메일 형식에서 이름 신호를 해석하고, 추정 결과와 그 출처로 CRM, 리드 및 분석 데이터를 보강하세요.

- 개인 및 업무용 이메일 주소

- CRM 레코드 보강

- 응답에 포함된 신뢰도와 출처

- [이메일 주소용 V2 API 살펴보기 →](https://www.genderapi.io/ko/docs/v2/gender-from-email)

## 사용자 이름과 별명을 분석하세요

사용자 이름에 포함된 알려진 이름을 인식합니다. forceToGenderize를 사용하면 실제 이름이 없는 별명도 추정을 요청할 수 있지만, 예측이 보장되지는 않습니다.

- 소셜 미디어와 커뮤니티의 사용자 데이터

- 선택적 별명 분석

- 예측이 없을 때의 명확한 상태 표시

- [사용자 이름용 V2 API 살펴보기 →](https://www.genderapi.io/ko/docs/v2/gender-from-username)

## 이름 목록을 한 번에 처리하세요

Excel 또는 CSV 파일을 업로드하고 원본 열을 선택한 뒤 결과를 내려받으세요. 자체 애플리케이션에서 일괄 요청을 보내려면 V2 일괄 요청 가이드를 참고하세요.

- Excel 및 CSV 파일

- 이름, 전체 이름 또는 이메일 주소 열

- 선택적 국가 컨텍스트

- [V2 일괄 요청 가이드 읽기 →](https://www.genderapi.io/ko/docs/v2/batch)

## API를 연동하거나 이미 쓰는 도구와 연결하세요

REST API로 시작하거나 GenderAPI.io를 스프레드시트, 이커머스 플랫폼 및 자동화 도구와 연결하세요. 각 가이드에는 해당 연동이 사용하는 API 버전이 안내되어 있습니다.

- [모든 연동 보기](https://www.genderapi.io/ko/integrations)

## 시작하기 전에 알아둘 내용

요청 유형, 신뢰도, 무료 사용과 크레딧 비용을 확인하세요. 요청 형식과 코드 예시는 V2 문서에서 볼 수 있습니다.

- [자주 묻는 질문 모두 보기 →](https://www.genderapi.io/ko/frequently-asked-questions)

### 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 파일을 처리하세요.

- [계정 만들기](https://app.genderapi.io/user/register)
- [API 문서 보기](https://www.genderapi.io/ko/api-documentation)