# GenderAPI.io V2 문서

> 첫 요청을 보내고 애플리케이션을 연결한 다음 결과를 해석하는 방법을 알아보세요. 이름, 이메일 주소 또는 사용자 이름으로 시작할 수 있습니다.

Canonical HTML: https://www.genderapi.io/ko/api-documentation

Last reviewed: 2026-09-29

## 첫 요청 보내기

이름, 이메일 주소 또는 사용자 이름을 보내면 JSON 형식의 성별 추정 결과를 받을 수 있습니다. 먼저 API 키 없이 브라우저에서 아래 URL을 열어 본 다음, 가이드를 선택해 애플리케이션을 연결하세요.

무료 IP 체험은 IP 주소당 24시간마다 10크레딧을 제공하며 V1과 공유됩니다. 이 데이터셋 전용 예시는 페이지를 새로 고칠 때를 포함해 요청마다 1크레딧이 차감됩니다. 기존 API 키를 연결하면 V1과 V2는 같은 계정 잔액을 사용합니다.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Minseo&country=KR&ai_mode=off
```

- [GET 예시 열기(IP 체험 1크레딧 사용)](https://api.genderapi.io/api/v2/gender?type=name&value=Minseo&country=KR&ai_mode=off)
- [API 키 설정하기](https://www.genderapi.io/ko/docs/v2/authentication#environment-setup)
- [JSON 응답 이해하기](https://www.genderapi.io/ko/docs/v2/responses)

## 어떤 작업을 하시겠어요?

입력 유형을 선택하면 cURL, JavaScript, Python, PHP, Java, C#, Go로 바로 실행할 수 있는 예시를 볼 수 있습니다. 실제 응답을 처리할 준비가 되면 결과 및 과금 가이드를 참고하세요.

- [API 키와 무료 IP 체험](https://www.genderapi.io/ko/docs/v2/authentication): API 키를 연결하거나 API를 무료로 사용해 보세요.
- [요청 매개변수](https://www.genderapi.io/ko/docs/v2/request-parameters): 입력 필드, 국가 컨텍스트와 요청 옵션을 선택하세요.
- [공식 SDK](https://www.genderapi.io/ko/docs/v2/sdks): 사용하는 프로그래밍 언어에 맞는 공식 클라이언트를 설치하세요.
- [이름으로 성별 추정](https://www.genderapi.io/ko/docs/v2/gender-from-name): 이름이나 전체 이름을 조회하세요.
- [이메일로 성별 추정](https://www.genderapi.io/ko/docs/v2/gender-from-email): 이메일 주소에서 이름 신호를 찾으세요.
- [사용자 이름으로 성별 추정](https://www.genderapi.io/ko/docs/v2/gender-from-username): 사용자 이름이나 별명을 입력으로 사용하세요.
- [일괄 조회(batch)](https://www.genderapi.io/ko/docs/v2/batch): 이름, 이메일 주소 또는 사용자 이름을 한 번에 최대 50개까지 처리하세요.
- [전화번호 검증](https://www.genderapi.io/ko/docs/v2/phone-validation): 전화번호를 검증하고 형식을 맞추세요.
- [응답 읽기](https://www.genderapi.io/ko/docs/v2/responses): 추정 결과, 신뢰도 점수와 알 수 없는 결과를 해석하세요.
- [AI와 별명](https://www.genderapi.io/ko/docs/v2/ai-options): AI를 언제 사용할지, 별명을 어떻게 처리할지 선택하세요.
- [크레딧과 잔액](https://www.genderapi.io/ko/docs/v2/credits-and-usage): 잔액과 요청별 비용을 확인하세요.
- [오류와 재시도](https://www.genderapi.io/ko/docs/v2/errors-and-retries): 오류를 해결하고 재시도할 시점을 판단하세요.
- [V1에서 V2로 이전](https://www.genderapi.io/ko/docs/v2/migration): 같은 API 키로 기존 연동을 업데이트하세요.

## 엔드포인트 참조

https://api.genderapi.io 뒤에 이 표의 절대 경로를 붙여 사용합니다. 예: https://api.genderapi.io/api/v2/gender. 쿼리 매개변수는 GET /gender에서만 지원됩니다. POST 경로에는 JSON 본문을 사용하고, V2 요청에 name, email, username, askToAI 같은 V1 필드를 보내지 마세요.

| 메서드 | 경로 | 용도 |
| --- | --- | --- |
| GET | /api/v2 | 공개 기능과 현재 한도, 무료. |
| GET | /api/v2/openapi.json | 기준이 되는 OpenAPI 명세, 무료. |
| GET | /api/v2/errors | 기계가 읽을 수 있는 오류 카탈로그, 무료. |
| GET | /api/v2/usage | 현재 계정 또는 IP 체험 잔액, 무료. |
| GET / POST | /api/v2/gender | 이름, 이메일 주소 또는 사용자 이름 하나. |
| POST | /api/v2/gender/batch | 이름, 이메일 주소, 사용자 이름을 한 종류만 또는 섞어서 순서대로 담은 일괄 요청. |
| POST | /api/v2/phone/validate | 전화번호를 검증하고 형식을 맞춥니다. |