여러 사용자 이름 성별 예측 API

다중 요청 개요

최대 50개 사용자 이름 처리

data 배열을 보내면 GenderAPI가 각 핸들에서 이름 신호를 추출하고 선택적 레코드 id와 함께 결과를 반환합니다.

방식POST

최대사용자 이름 50개

인증Bearer token

AI 옵션지원하지 않음

다중 사용자 이름 결과는 신중히 검토해야 합니다.

핸들에는 브랜드, 판타지 용어 또는 무관한 단어가 포함될 수 있습니다. 다중 요청은 askToAI or forceToGenderize. 일반적이지 않은 입력을 더 신중하게 처리하려면 단일 요청.

HDR

필수 HTTP 헤더

다중 요청 인증하기

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON 요청 본문

매개변수

필드	유형	필수 여부	설명
`data`	object[]	필수	1~50개의 사용자 이름 레코드 배열입니다.
`data[].username`	string	필수	분석할 사용자 이름 또는 핸들입니다. 밑줄과 숫자도 지원합니다.
`data[].country`	string	선택	지역 맥락에 사용할 ISO 3166-1 alpha-2 국가 코드입니다.
`data[].id`	string \| integer	선택	관련 결과와 함께 변경 없이 반환되는 사용자 시스템의 ID입니다.

입력 가이드

라틴 문자 사용자 이름은 대체로 더 명확한 이름 신호를 제공합니다. 고유한 id 값을 사용하고 레코드를 갱신하기 전에 추출된 the extracted name and probability 를 평가하세요.

요청 페이로드

사용자 이름 배열 구성하기

JSON

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

코드 예제

다중 사용자 이름 요청 보내기

cURL

curl -X POST "https://api.genderapi.io/api/username/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"username":"anna_smith88","country":"US","id":"123"},{"username":"michael_bauer","country":"DE","id":"456"}]}'

JavaScript

const data = [
  { username: "anna_smith88", country: "US", id: "123" },
  { username: "michael_bauer", country: "DE", id: "456" }
];
const response = await fetch("https://api.genderapi.io/api/username/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

200 응답

추출된 이름과 성별 예측

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265, "expires": 1717069765,
  "names": [
    { "name": "Anna", "q": "anna_smith88", "gender": "female", "country": "US", "total_names": 1234, "probability": 92, "id": "123" },
    { "name": "Michael", "q": "michael_bauer", "gender": "male", "country": "DE", "total_names": 5678, "probability": 89, "id": "456" }
  ], "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	전체 서버 처리 시간입니다.

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

큰 입력은 여러 묶음으로 나누세요. 사용자 이름은 간접 신호이므로 결과를 적용하기 전에 추출된 이름을 확인하고 적절한 확률 기준을 정하세요.

다음 참고 문서

전화번호 검증 및 형식 지정

전화번호 검증검증 및 형식 지정 방법 확인 →단일 사용자 이름 요청하나의 핸들에 AI 옵션 사용 →