⚡ 統合API v2.0 上級者向け

APIドキュメント

大量リクエストにも対応した高性能な統合 API を体験しよう。複数の名前を 1 回のリクエストで問い合わせて、驚くほど高速なレスポンスを受け取れるよ。

出身国を取得

名前の出身国を取得:

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

info 必要なリクエスト数: 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 をそのまま設定することも可能。 非同期環境では、この値を使うことで、レスポンスと以前のリクエストをより正確に結びつけられるよ

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の場合、この名前の性別判定結果は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)
Chat