⚡ 통합 API v2.0 고급 기능

API 문서

대량 요청에도 거뜬한 고성능 통합 API를 경험해 봐. 여러 이름을 한 번에 조회하고, 번개처럼 빠른 응답 속도를 누려봐.

search
code 모든 엔드포인트 person 이름 조회 email 이메일 조회 public 국가 데이터 bar_chart 통계
send POST

이름으로 조회

/v2/gender

이름에서 성별을 판단하고, 선택적인 국가 설정으로 정확도를 높이세요.

  • check_circle 대량 처리
  • check_circle 국가별 로컬라이제이션
  • check_circle 높은 정확도
자세히 보기 arrow_forward
send POST

전체 이름으로 조회

/v2/split

전체 이름을 자동으로 분리하고, 한 번의 효율적인 API 호출로 성별을 판별하세요.

  • check_circle 자동 이름 분리
  • check_circle 여러 이름
  • check_circle 스마트 감지
자세히 보기 arrow_forward
send POST

이메일 주소로 조회

/v2/email

이메일 주소에서 이름을 추출하고, 고급 파싱 알고리즘으로 성별을 판별해 보세요.

  • check_circle 이메일 파싱
  • check_circle 이름 추출
  • check_circle 대량 처리
자세히 보기 arrow_forward
send POST

출신 국가 확인

/v2/country

이름을 기반으로 추정되는 출신 국가와 인종적 배경을 알아보세요.

  • check_circle 국가 감지
  • check_circle 민족성 데이터
  • check_circle 이름 의미
자세히 보기 arrow_forward
download GET

통계 확인

/v2/stats

내 계정의 상세 사용 통계와 남은 요청 크레딧을 확인하세요.

  • check_circle 사용량 추적
  • check_circle 크레딧 잔액
  • check_circle 실시간 데이터
자세히 보기 arrow_forward
info INFO

오류 코드

/v2/*

디버깅을 위한 모든 API 오류 코드와 상태 응답에 대한 전체 참고 자료.

  • check_circle 오류 참고서
  • check_circle 상태 코드
  • check_circle 디버깅 도움말
자세히 보기 arrow_forward

API v1.0 SIMPLE

통합하기 더 쉬운 엔드포인트를 제공하는 다른 API 버전도 있어. API 구현이 처음이라면 v1.0 엔드포인트를 사용해 봐.

swap_horiz API v1.0 보기

🚀 API 도구

업계 표준 도구로 우리의 API를 탐색해 봐

이름으로 조회하기

이름으로 성별을 조회하는 가장 간단한 방법입니다. 각 응답은 JSON 형식으로 인코딩됩니다:

POST https://gender-api.com/v2/gender

info Required Requests: 1
http Headers
Content-Type: application/json
Authorization: Bearer <your authorization token>
link
data_object JSON Payload
필드 유형 필수 여부 설명
first_name string 예 조회할 이름
country string 아니요 ISO 3166 ALPHA-2 Country Code
link
locale string 아니요 브라우저 로케일
ip string 아니요 유효한 IPv4 또는 IPv6 주소
id string 아니요 최대 50자. 이 ID는 네가 원하는 아무 알파벳·숫자 값으로 설정할 수 있어. 예를 들어, 이 ID를 데이터베이스에 있는 해당 데이터셋의 내부 ID로 지정할 수 있어. 비동기 환경에서는 이전 요청과 응답을 더 쉽게 연결하는 데 도움이 돼

code 요청 예시

arrow_forward 이름만으로 조회
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "first_name": "Sandra"
}
arrow_forward 이름과 국가 코드를 함께 조회
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "first_name": "Sandra",
    "country": "US"
}
arrow_forward 이름과 브라우저 로케일로 조회하기
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "first_name": "Sandra",
    "locale": "en_US"
}
arrow_forward 이름과 IP 주소를 사용해 지역 기반 조회
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "first_name": "Sandra",
    "ip": "54.201.16.177"
}
arrow_forward 한 번의 요청으로 여러 이름 조회
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
[
    {
        "first_name": "Sandra",
        "country": "US"
    },
    {
        "first_name": "Jason",
        "country": "US"
    }
]

check_circle 응답 

{
    "input": {
        "first_name": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "first_name_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "first_name": "Sandra",
    "probability": 0.85,
    "gender": "female"
}

list 응답 필드

필드 유형 설명
input object 전송된 페이로드
details.credits_used int 이 요청으로 사용된 요청 수
details.samples int 너의 요청과 일치하는 레코드가 우리 데이터베이스에서 몇 개 발견되었는지
details.country string 우리가 찾은 국가
details.first_name_sanitized string 정규화기를 적용한 후의 이름
details.duration string 서버가 요청을 처리하는 데 걸린 시간
result_found bool 주어진 이름에 대해 성별 정보를 조회하는 데 성공했다면 true
first_name string 성별 판단에 사용한 이름
probability float 이 값(0과 1 사이)은 우리 데이터베이스 신뢰도를 나타내. 값이 1이면, 네 성별 요청 결과가 100%% 정확하다는 뜻이야.
gender string 가능한 값: male, female, unknown

전체 이름으로 조회 - 이름과 성 분리

페이지에서 이름과 성을 하나의 필드로 사용 중이라면, 이 API를 사용해 각 부분을 추출하세요

POST https://gender-api.com/v2/gender

info Required Requests: 1
http Headers
Content-Type: application/json
Authorization: Bearer <your authorization token>
link
data_object JSON Payload
필드 유형 필수 여부 설명
full_name string 예 조회할 이름
country string 아니요 ISO 3166 ALPHA-2 Country Code
link
locale string 아니요 브라우저 로케일
ip string 아니요 유효한 IPv4 또는 IPv6 주소
id string 아니요 최대 50자. 이 ID는 네가 원하는 아무 알파벳·숫자 값으로 설정할 수 있어. 예를 들어, 이 ID를 데이터베이스에 있는 해당 데이터셋의 내부 ID로 지정할 수 있어. 비동기 환경에서는 이전 요청과 응답을 더 쉽게 연결하는 데 도움이 돼

code 요청 예시

arrow_forward 전체 이름으로만 조회
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "full_name": "Theresa Miller"
}
arrow_forward 전체 이름과 국가 코드로 조회
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "full_name": "Theresa Miller",
    "country": "US"
}
arrow_forward 전체 이름과 브라우저 로케일로 조회
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "full_name": "Thomas Johnson",
    "locale": "en_US"
}
arrow_forward 전체 이름과 IP 주소를 사용해 지역 정보로 조회
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "full_name": "Markus Stefan NonExistingLastName",
    "ip": "54.201.16.177"
}
arrow_forward 한 번의 요청으로 여러 이름 조회
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
[
    {
        "full_name": "Theresa Miller"
    },
    {
        "full_name": "Thomas Johnson",
        "country": "US"
    }
]

check_circle 응답 

{
    "input": {
        "full_name": "Theresa Miller"
    },
    "details": {
    "credits_used": 1,
        "duration": "33ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

list 응답 필드

필드 유형 설명
input object 전송된 페이로드
details.credits_used int 이 요청으로 사용된 요청 수
details.samples int 너의 요청과 일치하는 레코드가 우리 데이터베이스에서 몇 개 발견되었는지
details.country string 우리가 찾은 국가
details.full_name_sanitized int 정규화기를 적용한 후의 이름
details.duration string 서버가 요청을 처리하는 데 걸린 시간
result_found bool 주어진 이름에 대해 성별 정보를 조회하는 데 성공했다면 true
full_name string 성별 판단에 사용한 전체 이름
probability float 이 값(0과 1 사이)은 우리 데이터베이스 신뢰도를 나타내. 값이 1이면, 네 성별 요청 결과가 100%% 정확하다는 뜻이야.
gender string 가능한 값: male, female, unknown

이메일 주소로 조회하기

이메일 주소가 포함된 이메일 주소로도 성별을 조회할 수 있어

POST https://gender-api.com/v2/gender

info Required Requests: 1
http Headers
Content-Type: application/json
Authorization: Bearer <your authorization token>
link
data_object JSON Payload
필드 유형 필수 여부 설명
email string 예 조회할 이메일 주소
country string 아니요 ISO 3166 ALPHA-2 Country Code
link
locale string 아니요 브라우저 로케일
ip string 아니요 유효한 IPv4 또는 IPv6 주소
id string 아니요 최대 50자. 이 ID는 네가 원하는 아무 알파벳·숫자 값으로 설정할 수 있어. 예를 들어, 이 ID를 데이터베이스에 있는 해당 데이터셋의 내부 ID로 지정할 수 있어. 비동기 환경에서는 이전 요청과 응답을 더 쉽게 연결하는 데 도움이 돼

code 요청 예시

arrow_forward 이메일 주소만으로 조회하기
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "email": "theresa.miller14@gmail.com"
}
arrow_forward 이메일 주소와 국가 코드를 이용해 조회하기
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "email": "thomas.clarks@hotmail.com",
    "country": "US"
}
arrow_forward 이메일 주소와 브라우저 로케일로 조회하기
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "email": "Thomas.j32@live.com",
    "locale": "en_US"
}
arrow_forward 이메일 주소와 IP 주소를 사용해 위치 기반으로 조회하기
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "email": "thomasfromnewyork@gmail.com",
    "ip": "54.201.16.177"
}
arrow_forward 한 번의 요청으로 여러 이름 조회
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
[
    {
        "email": "thomas.clarks@hotmail.com",
        "country": "US"
    },
    {
        "email": "theresa.miller14@gmail.com"
    }
]

check_circle 응답 

{
    "input": {
        "email": "theresa.miller14@gmail.com"
    },
    "details": {
        "credits_used": 1,
        "duration": "12ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

list 응답 필드

필드 유형 설명
input object 전송된 페이로드
details.credits_used int 이 요청으로 사용된 요청 수
details.samples int 너의 요청과 일치하는 레코드가 우리 데이터베이스에서 몇 개 발견되었는지
details.country string 우리가 찾은 국가
details.email_sanitized int 정규화기를 적용한 후의 이름
details.duration string 서버가 요청을 처리하는 데 걸린 시간
result_found bool 주어진 이름에 대해 성별 정보를 조회하는 데 성공했다면 true
email string 성별 판별에 사용한 이메일 주소
probability float 이 값(0과 1 사이)은 우리 데이터베이스 신뢰도를 나타내. 값이 1이면, 네 성별 요청 결과가 100%% 정확하다는 뜻이야.
gender string 가능한 값: male, female, unknown

출신 국가 확인

이름의 출신 국가 알아보기:

POST https://gender-api.com/v2/country-of-origin

info Required Requests: 2
http Headers
Content-Type: application/json
Authorization: Bearer <your authorization token>
link
data_object JSON Payload
필드 유형 필수 여부 설명
first_name string 예 조회할 이름
full_name string 아니요 조회할 전체 이름입니다. first_name 필드 대신 사용할 수 있습니다
email string 아니요 조회할 이메일 주소입니다. first_name 필드 대신 사용할 수 있습니다
id string 아니요 최대 50자. 이 ID는 네가 원하는 아무 알파벳·숫자 값으로 설정할 수 있어. 예를 들어, 이 ID를 데이터베이스에 있는 해당 데이터셋의 내부 ID로 지정할 수 있어. 비동기 환경에서는 이전 요청과 응답을 더 쉽게 연결하는 데 도움이 돼

code 요청 예시

arrow_forward 이름으로 조회하기
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "first_name": "Johann"
}
arrow_forward 전체 이름으로 조회
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "full_name": "Theresa Miller"
}
arrow_forward 이메일 주소로 조회하기
play_arrow Codepen.io에서 실시간으로 테스트해 보기 
{
    "full_name": "sophia5342@gmail.com"
}

check_circle 응답 

{
    "input": {
        "first_name": "Johann",
        "id": 12
    },
    "details": {
        "credits_used": 2,
        "duration": "414ms",
        "samples": 890,
        "country": null,
        "first_name_sanitized": "johann"
    },
    "result_found": true,
    "country_of_origin": [
        {
            "country_name": "Germany",
            "country": "DE",
            "probability": 0.52,
            "continental_region": "Europe",
            "statistical_region": "Western Europe"
        },
        {
            "country_name": "Austria",
            "country": "AT",
            "probability": 0.48,
            "continental_region": "Europe",
            "statistical_region": "Western Europe"
        }
    ],
    "first_name": "Johann",
    "probability": 0.9,
    "gender": "male",
    "language_of_origin": "Germanic",
    "meaning": "Johann is the German variation of the name John, which means 'God is gracious'. It was frequently used in the Middle Ages across Europe, particularly as a name for religious figures.",
    "ethnicity": {
        "id": "GERMANIC",
        "name": "Germanic (German, Austrian, Swiss)",
        "distribution": [
            {
                "id": "GERMANIC",
                "name": "Germanic (German, Austrian, Swiss)",
                "percentage": 90
            },
            {
                "id": "DUTCH",
                "name": "Dutch",
                "percentage": 5
            },
            {
                "id": "FRENCH",
                "name": "French",
                "percentage": 5
            }
        ]
    }
 }

list 응답 필드

필드 유형 설명
input object 전송된 페이로드
details.credits_used int 이 요청으로 사용된 요청 수
details.samples int 너의 요청과 일치하는 레코드가 우리 데이터베이스에서 몇 개 발견되었는지
details.country string 우리가 찾은 국가
details.first_name_sanitized string 정규화기를 적용한 후의 이름
details.duration string 서버가 요청을 처리하는 데 걸린 시간
result_found bool 주어진 이름에 대해 성별 정보를 조회하는 데 성공했다면 true
country_of_origin_map_url string 이 이름에 대한 인터랙티브 지도 URL
first_name string 성별 판단에 사용한 이름
probability float 이 값(0과 1 사이)은 저희 데이터베이스의 신뢰도를 나타내. 값이 1이면 요청한 gender 결과가 100%% 정확하다는 의미야
gender string 가능한 값: male, female, unknown
country_of_origin object 상위 25개 출신 국가. 지원되는 국가 목록은 "Complete List Of Possible Countries"를 참고해 줘. 각 레코드에는 country_name, country, probability, continental_region, statistical_region 필드가 포함돼
language_of_origin string 이 이름의 원어(출신 언어)입니다
meaning string 이 이름의 의미에 대한 짧은 설명입니다
ethnicity object ethnicity 필드는 이름과 주로 연관된 주요 민족 집단에 대한 정보와, 이 이름이 여러 민족 집단에 어떻게 분포되어 있는지를 제공합니다
ethnicity.id string id 필드에는 결정된 주요 민족 그룹을 나타내는 식별자가 들어 있어. 가능한 모든 민족 그룹 목록은 "Complete List Of Possible Ethnic Groups"를 참고해 줘
ethnicity.name string name 필드에는 판단된 주요 민족 집단의 이름이 들어 있습니다. 가능한 모든 민족 집단의 전체 목록은 "Complete List Of Possible Ethnic Groups"에서 확인할 수 있습니다
ethnicity.distribution array Distribution 필드에는 서로 다른 민족 그룹 내에서 이 이름이 차지하는 비율 정보가 들어 있어. 각 배열 항목에는 id (string), name (string), percentage (float) 필드가 포함돼. 가능한 값들의 전체 목록은 "Complete List Of Possible Ethnic Groups"에서 확인할 수 있어
스크린샷 인터랙티브 지도
가능한 국가의 전체 목록
국가 코드 국가 이름 통계 지역 대륙 지역
CN China Eastern Asia Asia
IN India Southern Asia Asia
US United States Northern America Americas
ID Indonesia South-eastern Asia Asia
BR Brazil South America Americas
PK Pakistan Southern Asia Asia
NG Nigeria Western Africa Africa
BD Bangladesh Southern Asia Asia
RU Russia Eastern Europe Europe
MX Mexico Central America Americas
JP Japan Eastern Asia Asia
ET Ethiopia Eastern Africa Africa
PH Philippines South-eastern Asia Asia
EG Egypt Northern Africa Africa
VN Vietnam South-eastern Asia Asia
DE Germany Western Europe Europe
CD Democratic Republic of the Congo Middle Africa Africa
IR Iran Southern Asia Asia
TR Turkey Western Asia Asia
TH Thailand South-eastern Asia Asia
GB United Kingdom Northern Europe Europe
FR France Western Europe Europe
IT Italy Southern Europe Europe
TZ Tanzania Eastern Africa Africa
ZA South Africa Southern Africa Africa
MM Myanmar South-eastern Asia Asia
KR South Korea Eastern Asia Asia
CO Colombia South America Americas
KE Kenya Eastern Africa Africa
ES Spain Southern Europe Europe
AR Argentina South America Americas
UA Ukraine Eastern Europe Europe
UG Uganda Eastern Africa Africa
DZ Algeria Northern Africa Africa
SD Sudan Northern Africa Africa
IQ Iraq Western Asia Asia
PL Poland Eastern Europe Europe
CA Canada Northern America Americas
MA Morocco Northern Africa Africa
AF Afghanistan Southern Asia Asia
SA Saudi Arabia Western Asia Asia
PE Peru South America Americas
VE Venezuela South America Americas
UZ Uzbekistan Central Asia Asia
MY Malaysia South-eastern Asia Asia
AO Angola Middle Africa Africa
MZ Mozambique Eastern Africa Africa
NP Nepal Southern Asia Asia
GH Ghana Western Africa Africa
YE Yemen Western Asia Asia
MG Madagascar Eastern Africa Africa
KP North Korea Eastern Asia Asia
AU Australia AustraliaandNew Zealand Oceania
CI Ivory Coast Western Africa Africa
CM Cameroon Middle Africa Africa
TW Taiwan Eastern Asia Asia
NE Niger Western Africa Africa
LK Sri Lanka Southern Asia Asia
RO Romania Eastern Europe Europe
BF Burkina Faso Western Africa Africa
MW Malawi Eastern Africa Africa
ML Mali Western Africa Africa
SY Syria Western Asia Asia
KZ Kazakhstan Central Asia Asia
CL Chile South America Americas
ZM Zambia Eastern Africa Africa
NL Netherlands Western Europe Europe
GT Guatemala Central America Americas
EC Ecuador South America Americas
ZW Zimbabwe Eastern Africa Africa
KH Cambodia South-eastern Asia Asia
SN Senegal Western Africa Africa
TD Chad Middle Africa Africa
SO Somalia Eastern Africa Africa
GN Guinea Western Africa Africa
SD Sudan Northern Africa Africa
RW Rwanda Eastern Africa Africa
TN Tunisia Northern Africa Africa
CU Cuba Caribbean Americas
BE Belgium Western Europe Europe
BJ Benin Western Africa Africa
GR Greece Southern Europe Europe
BO Bolivia South America Americas
HT Haiti Caribbean Americas
BI Burundi Eastern Africa Africa
DO Dominican Republic Caribbean Americas
CZ Czech Republic Eastern Europe Europe
PT Portugal Southern Europe Europe
SE Sweden Northern Europe Europe
AZ Azerbaijan Western Asia Asia
HU Hungary Eastern Europe Europe
JO Jordan Western Asia Asia
BY Belarus Eastern Europe Europe
AE United Arab Emirates Western Asia Asia
HN Honduras Central America Americas
TJ Tajikistan Central Asia Asia
RS Serbia Southern Europe Europe
AT Austria Western Europe Europe
CH Switzerland Western Europe Europe
IL Israel Western Asia Asia
PG Papua New Guinea Melanesia Oceania
TG Togo Western Africa Africa
SL Sierra Leone Western Africa Africa
HK Hong Kong Eastern Asia Asia
BG Bulgaria Eastern Europe Europe
LA Laos South-eastern Asia Asia
PY Paraguay South America Americas
SV El Salvador Central America Americas
LY Libya Northern Africa Africa
NI Nicaragua Central America Americas
LB Lebanon Western Asia Asia
KG Kyrgyzstan Central Asia Asia
TM Turkmenistan Central Asia Asia
DK Denmark Northern Europe Europe
SG Singapore South-eastern Asia Asia
FI Finland Northern Europe Europe
SK Slovakia Eastern Europe Europe
NO Norway Northern Europe Europe
CG Congo Middle Africa Africa
ER Eritrea Eastern Africa Africa
PS Palestine Western Asia Asia
CR Costa Rica Central America Americas
IE Ireland Northern Europe Europe
LR Liberia Western Africa Africa
NZ New Zealand AustraliaandNew Zealand Oceania
CF Central African Republic Middle Africa Africa
OM Oman Western Asia Asia
MR Mauritania Western Africa Africa
HR Croatia Southern Europe Europe
KW Kuwait Western Asia Asia
PA Panama Central America Americas
MD Moldova Eastern Europe Europe
GE Georgia Western Asia Asia
PR Puerto Rico Caribbean Americas
BA Bosnia and Herzegovina Southern Europe Europe
UY Uruguay South America Americas
MN Mongolia Eastern Asia Asia
AM Armenia Western Asia Asia
AL Albania Southern Europe Europe
JM Jamaica Caribbean Americas
LT Lithuania Northern Europe Europe
QA Qatar Western Asia Asia
NA Namibia Southern Africa Africa
BW Botswana Southern Africa Africa
LS Lesotho Southern Africa Africa
GM The Gambia Western Africa Africa
MK Republic of Macedonia Southern Europe Europe
SI Slovenia Southern Europe Europe
GA Gabon Middle Africa Africa
LV Latvia Northern Europe Europe
GW Guinea-Bissau Western Africa Africa
BH Bahrain Western Asia Asia
TT Trinidad and Tobago Caribbean Americas
SZ Swaziland Southern Africa Africa
EE Estonia Northern Europe Europe
TL East Timor South-eastern Asia Asia
GQ Equatorial Guinea Middle Africa Africa
MU Mauritius Eastern Africa Africa
CY Cyprus Western Asia Asia
DJ Djibouti Eastern Africa Africa
FJ Fiji Melanesia Oceania
RE Réunion Eastern Africa Africa
KM Comoros Eastern Africa Africa
BT Bhutan Southern Asia Asia
GY Guyana South America Americas
ME Montenegro Southern Europe Europe
MO Macau Eastern Asia Asia
SB Solomon Islands Melanesia Oceania
LU Luxembourg Western Europe Europe
SR Suriname South America Americas
EH Western Sahara Northern Africa Africa
CV Cape Verde Western Africa Africa
GP Guadeloupe Caribbean Americas
MV Maldives Southern Asia Asia
MT Malta Southern Europe Europe
BN Brunei South-eastern Asia Asia
BS Bahamas Caribbean Americas
MQ Martinique Caribbean Americas
BZ Belize Central America Americas
IS Iceland Northern Europe Europe
BB Barbados Caribbean Americas
PF French Polynesia Polynesia Oceania
GF French Guiana South America Americas
NC New Caledonia Melanesia Oceania
VU Vanuatu Melanesia Oceania
YT Mayotte Eastern Africa Africa
ST Sao Tome and Principe Middle Africa Africa
WS Samoa Polynesia Oceania
LC Saint Lucia Caribbean Americas
JE Guernsey and Jersey Northern Europe Europe
GU Guam Micronesia Oceania
CW Curaçao Caribbean Americas
KI Kiribati Micronesia Oceania
VC Saint Vincent and the Grenadines Caribbean Americas
TO Tonga Polynesia Oceania
GD Grenada Caribbean Americas
FM Federated States of Micronesia Micronesia Oceania
AW Aruba Caribbean Americas
VI United States Virgin Islands Caribbean Americas
AG Antigua and Barbuda Caribbean Americas
SC Seychelles Eastern Africa Africa
IM Isle of Man Northern Europe Europe
AD Andorra Southern Europe Europe
DM Dominica Caribbean Americas
KY Cayman Islands Caribbean Americas
BM Bermuda Northern America Americas
GL Greenland Northern America Americas
AS American Samoa Polynesia Oceania
KN Saint Kitts and Nevis Caribbean Americas
MP Northern Mariana Islands Micronesia Oceania
MH Marshall Islands Micronesia Oceania
FO Faroe Islands Northern Europe Europe
SX Sint Maarten Caribbean Americas
MC Monaco Western Europe Europe
LI Liechtenstein Western Europe Europe
TC Turks and Caicos Islands Caribbean Americas
GI Gibraltar Southern Europe Europe
SM San Marino Southern Europe Europe
VG British Virgin Islands Caribbean Americas
BQ Caribbean Netherlands Caribbean Americas
PW Palau Micronesia Oceania
CK Cook Islands Polynesia Oceania
AI Anguilla Caribbean Americas
WF Wallis and Futuna Polynesia Oceania
NR Nauru Micronesia Oceania
TV Tuvalu Polynesia Oceania
PM Saint Pierre and Miquelon Northern America Americas
MS Montserrat Caribbean Americas
SH Saint Helena Ascension and Tristan da Cunha Western Africa Africa
FK Falkland Islands South America Americas
NU Niue Polynesia Oceania
TK Tokelau Polynesia Oceania
VA Vatican City Southern Europe Europe
가능한 민족 그룹 전체 목록
ID 이름
GERMANIC Germanic (German, Austrian, Swiss)
SCANDINAVIAN Scandinavian (Swedish, Norwegian, Danish, Finnish)
ENGLISH English
DUTCH Dutch
HUNGARIAN Hungarian
ESTONIAN Estonian
LATVIAN Latvian
LITHUANIAN Lithuanian
SLOVENIAN Slovenian
CROATIAN Croatian
SERBIAN Serbian
BOSNIAN Bosnian
MACEDONIAN Macedonian
BULGARIAN Bulgarian
ROMANIAN Romanian
POLISH Polish
SLOVAK Slovak
CZECH Czech
RUSSIAN Russian
UKRAINIAN Ukrainian
BELARUSIAN Belarusian
ICELANDIC Icelandic
FAROESE Faroese
SCOTTISH Scottish
IRISH Irish
WELSH Welsh
ITALIAN Italian
SPANISH Spanish
PORTUGUESE Portuguese
FRENCH French
GREEK Greek
TURKISH Turkish
ARMENIAN Armenian
GEORGIAN Georgian
ALBANIAN Albanian
KURDISH Kurdish
PERSIAN Persian
ARAB Arab (Various Arabic-speaking countries)
HEBREW Hebrew
INDIAN Indian
PAKISTANI Pakistani
BANGLADESHI Bangladeshi
SRI_LANKAN Sri Lankan
NEPALI Nepali
BHUTANESE Bhutanese
TIBETAN Tibetan
CHINESE Chinese
JAPANESE Japanese
KOREAN Korean
VIETNAMESE Vietnamese
THAI Thai
MALAYSIAN Malaysian
INDONESIAN Indonesian
FILIPINO Filipino
AUSTRALIAN_ABORIGINAL Australian Aboriginal
MAORI Maori (New Zealand)
NATIVE_AMERICAN Native American (various tribes in North and South America)
INUIT Inuit (Arctic regions)
AFRICAN African ethnic groups (various countries and tribes)
PACIFIC_ISLANDER Pacific Islander (various islands and cultures)

통계 가져오기

이 호출로 너의 계정에 대한 다양한 통계를 확인할 수 있어:

GET https://gender-api.com/v2/statistic

http Headers
Content-Type: application/json
Authorization: Bearer <your authorization token>
link

check_circle 응답 

{
    "is_limit_reached": false,
    "remaining_credits": 24999,
    "details": {
        "credits_used": 0,
        "duration": "83ms"
    },
    "usage_last_month": {
        "date": "2018-03",
        "credits_used": 25
    }
}

list 응답 필드

필드 유형 설명
is_limit_reached bool 더 이상 남은 요청이 없다면 true를 반환해
remaining_credits int 남은 요청 수
details.credits_used int 이 요청으로 사용된 요청 수
details.duration string 서버가 요청을 처리하는 데 걸린 시간
usage_last_month.date string 지난달 날짜
usage_last_month.credits_used int 지난 한 달 동안 사용한 요청 수

오류 코드

endpoint-not-found
Status endpoint-not-found
HTTP Status Code 404
Description API endpoint not found
limit-exceeded
Status limit-exceeded
HTTP Status Code 401
Description Limit exceeded. Thank you for using our service. Please consider to buy more requests.
parameter-first-name-invalid
Status parameter-first-name-invalid
HTTP Status Code 400
Description The "first_name" parameter is invalid. The parameter can only be a string with a length from 1 to 50 chars.
parameter-full-name-invalid
Status parameter-full-name-invalid
HTTP Status Code 400
Description The "full_name" parameter is invalid. The parameter can only be a string with a length from 1 to 100 chars.
parameter-email-invalid
Status parameter-email-invalid
HTTP Status Code 400
Description The "email" parameter is invalid. The parameter can only be a string with a length from 3 to 100 chars and must be a valid email address.
key-parameter-missing
Status key-parameter-missing
HTTP Status Code 400
Description The "key" parameter is not set. Please create an account to fetch an API key.
invalid-key
Status invalid-key
HTTP Status Code 400
Description Invalid API key. You can find your personal API key in your account.
invalid-country-code
Status invalid-country-code
HTTP Status Code 400
Description The given country code is not valid. You can find a list of valid country codes in our API docs.
invalid-ip-address
Status invalid-ip-address
HTTP Status Code 400
Description The given ip address is not valid. Please provide either a valid IPv4 or an IPv6 address.
generic-error
Status generic-error
HTTP Status Code 400
Description
invalid-json
Status invalid-json
HTTP Status Code 400
Description
invalid-locale
Status invalid-locale
HTTP Status Code 400
Description The given locale is not valid. You can find a list of valid country codes in our API docs.
invalid-id
Status invalid-id
HTTP Status Code 400
Description The given id is not valid. An id can be either an integer or a string with 50 chars at max.
mandatory-parameter-missing
Status mandatory-parameter-missing
HTTP Status Code 400
Description Mandatory parameter missing. Either first_name, full_name or email must be set.
content-type-missing
Status content-type-missing
HTTP Status Code 400
Description Content-Type missing. Please add a "Content-Type: application/json" to your API call.
missing-json
Status missing-json
HTTP Status Code 400
Description We weren't able to find a json body in your API call. Please make sure the body is sent with a POST request to our API endpoint.
too-many-queries
Status too-many-queries
HTTP Status Code 400
Description Too many queries in a single API call.
too-many-queries-api-key
Status too-many-queries-api-key
HTTP Status Code 400
Description Too many queries in a single API call. Your API key is limited to 3 lookups per request.
authorization-header-missing
Status authorization-header-missing
HTTP Status Code 400
Description Your query misses the "Authorization" header with the bearer token.
invalid-auth-token
Status invalid-auth-token
HTTP Status Code 400
Description Invalid authentication token provided. Please log in to your account to find a list of valid tokens or to create a new one.
email-invalid
Status email-invalid
HTTP Status Code 400
Description Invalid or empty email address given.
password-invalid
Status password-invalid
HTTP Status Code 400
Description Invalid credentials. Login failed. Please also check your account that third-party app access is not restricted.: https://gender-api.com/de/account/password
label-invalid
Status label-invalid
HTTP Status Code 400
Description Invalid label given. A label must be a string between 2 and 30 chars.
email-account-not-found
Status email-account-not-found
HTTP Status Code 400
Description No Gender-API.com account found. Please create a free account first, to sign-in with Google or try to login with an existing username or password.
invalid-list-of-names
Status invalid-list-of-names
HTTP Status Code 400
Description Invalid list of names. Expected array of strings.
이 제품에는 MaxMind가 제작한 GeoLite2 데이터가 포함되어 있으며, 다음에서 이용할 수 있습니다: http://www.maxmind.com.
채팅