APIドキュメント

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

code リクエスト例

{
    "first_name": "Sandra"
}

{
    "first_name": "Sandra",
    "country": "US"
}

{
    "first_name": "Sandra",
    "locale": "en_US"
}

{
    "first_name": "Sandra",
    "ip": "54.201.16.177"
}

[
    {
        "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 レスポンスフィールド

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

code リクエスト例

{
    "full_name": "Theresa Miller"
}

{
    "full_name": "Theresa Miller",
    "country": "US"
}

{
    "full_name": "Thomas Johnson",
    "locale": "en_US"
}

{
    "full_name": "Markus Stefan NonExistingLastName",
    "ip": "54.201.16.177"
}

[
    {
        "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 レスポンスフィールド

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

code リクエスト例

{
    "email": "theresa.miller14@gmail.com"
}

{
    "email": "thomas.clarks@hotmail.com",
    "country": "US"
}

{
    "email": "Thomas.j32@live.com",
    "locale": "en_US"
}

{
    "email": "thomasfromnewyork@gmail.com",
    "ip": "54.201.16.177"
}

[
    {
        "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 レスポンスフィールド

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

code リクエスト例

{
    "first_name": "Johann"
}

{
    "full_name": "Theresa Miller"
}

{
    "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 レスポンスフィールド

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

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 レスポンスフィールド