여러 이름 성별 예측 API

다중 요청 개요

최대 100개 이름 처리

data 배열을 보내면 레코드마다 결과 하나를 받습니다. 시스템의 id를 추가해 각 예측을 원본 레코드와 연결하세요.

방식POST

최대이름 100개

인증Bearer 토큰

AI 보완지원하지 않음

다중 요청은 AI 추론을 사용하지 않습니다.

askToAI와 forceToGenderize는 사용할 수 없습니다. AI 보완이 필요한 입력은 단일 이름 엔드포인트를 사용하세요.

HDR

필수 HTTP 헤더

다중 요청 인증하기

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON 요청 본문

매개변수

필드	유형	필수 여부	설명
`data`	object[]	필수	1~100개의 이름 레코드 목록입니다.
`data[].name`	string	필수	분석할 이름입니다.
`data[].country`	string	선택	ISO 3166-1 alpha-2 국가 코드입니다. 국가별 결과가 없으면 전 세계 결과를 사용합니다.
`data[].id`	string \| integer	선택	원본 레코드와 결과를 연결할 수 있도록 변경 없이 반환되는 레코드 ID입니다.

국가별 맥락 보완

선택한 국가에서 결과가 없으면 전 세계 이름 결과를 반환합니다. KR, JP, US 같은 코드를 사용하세요.

요청 페이로드

data 배열 구성하기

JSON

{
  "data": [
    { "name": "Jiwon", "country": "KR", "id": "123" },
    { "name": "Haruto", "country": "JP", "id": "456" }
  ]
}

코드 예제

다중 이름 요청 보내기

cURL

curl -X POST "https://api.genderapi.io/api/name/multi/country" \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer YOUR_API_KEY" \
 -d '{"data":[{"name":"Jiwon","country":"KR","id":"123"}]}'

JavaScript

const data = [{ name: "Jiwon", country: "KR", id: "123" }];
await fetch("https://api.genderapi.io/api/name/multi/country", {
 method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" }, body: JSON.stringify({ data })
});

200 응답

결과를 원본 레코드에 연결하기

JSON

{ "status": true, "used_credits": 2, "remaining_credits": 4998, "expires": 1743659200,
 "names": [{ "name": "jiwon", "q": "Jiwon", "gender": "female", "country": "KR", "total_names": 10234, "probability": 98, "id": "123" }], "duration": "5ms" }

응답 필드

필드	유형	설명
`status`	boolean	전체 요청이 오류 없이 처리되었는지 나타냅니다.
`used_credits`	integer	전송한 모든 이름에 사용된 크레딧입니다.
`remaining_credits`	integer	요청 후 남은 크레딧입니다.
`expires`	integer	요금제 만료 UNIX 타임스탬프입니다.
`names`	object[]	이름 예측 결과 목록입니다.
`names[].name`	string	예측에 사용된 정규화된 이름입니다.
`names[].q`	string	전송한 원래 이름입니다.
`names[].gender`	string \| null	male, female 또는 null입니다.
`names[].country`	string	결과에 사용된 국가 코드입니다.
`names[].total_names`	integer	결과의 근거가 된 이름 레코드 수입니다.
`names[].probability`	integer	예측 신뢰도 백분율입니다.
`names[].id`	string \| integer	레코드 연결을 위해 반환되는 입력 ID입니다.
`duration`	string	전체 서버 처리 시간입니다.

요청당 최대 100개 레코드로 제한

전송 전에 배열을 검증하고 고유한 id로 레코드를 연결하세요. 큰 데이터셋은 최대 100개 단위로 나누세요.

다음 가이드

이메일 주소로 성별 예측하기

단일 이메일 요청이메일에서 이름을 추출하고 분석하기 →단일 이름 요청이름 하나에 AI 보완 기능 사용 →