統合 API(v2.0) 上級者向け
高度なユーザーでリクエスト数が多い場合は、新しい API V2.0 エンドポイントにも切り替えられるよ。 この統合 API は、1回のリクエストで複数の名前を問い合わせるときに、はるかに高速で、より強力なインターフェースを提供する一方で、実装は少しだけ複雑になる。
統合 API v2.0 を表示シンプルな使い方
これは性別判定をリクエストする一番かんたんな方法だよ。すべてのレスポンスは JSON 形式で返される:
必要なリクエスト数: 1
リクエスト
名
GET https://gender-api.com/get?name=Elizabeth&key=<あなたのAPIキー>
リクエストパラメータ
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 照会する名前 |
key |
String | あなたの API キー |
レスポンス
{"name":"diana","name_sanitized":"Diana","gender":"female","samples":523,"accuracy":93,"duration":"41ms","credits_used":1}
レスポンスフィールド
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 小文字に変換された送信名 |
name_sanitized |
String | 当社の正規化処理を適用したあとの名前 |
gender |
String | 取り得る値: male, female, unknown |
samples |
Integer | あなたのリクエストに一致して、当社データベース内で見つかったレコード数 |
accuracy |
Integer | この値はデータベースの信頼性を示します。値が 100 の場合、その性別判定結果は 100%% 正確であることを意味します |
duration |
String | リクエストを処理するためにサーバーが必要とした時間 |
credits_used |
Integer | このクエリで消費されたリクエスト数 |
ローカライズ
リクエストをローカライズして、結果の精度をさらに高めよう:
必要なリクエスト数: 1
リクエスト
イタリアの例
GET https://gender-api.com/get?name=Andrea&country=IT&key=<あなたのAPIキー>
リクエスト
ドイツの例
GET https://gender-api.com/get?name=Andrea&country=DE&key=<あなたのAPIキー>
リクエストパラメータ
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 照会する名前 |
country |
String | ISO 3166 ALPHA-2 国コード |
key |
String | あなたの API キー |
レスポンス
イタリアの例
//In Italy, Andrea is male.
{"name":"andrea","name_sanitized":"Andrea","country":"IT","gender":"male","samples":1068,"accuracy":95,"duration":"15ms","credits_used":1}
レスポンス
ドイツの例
//In Germany, Andrea is female.
{"name":"andrea","name_sanitized":"Andrea","country":"DE","gender":"female","samples":4089,"accuracy":85,"duration":"33ms","credits_used":1}
レスポンスフィールド
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 小文字に変換された送信名 |
name_sanitized |
String | 当社の正規化処理を適用したあとの名前 |
country |
String | 送信された国コード |
gender |
String | 取り得る値: male, female, unknown |
samples |
Integer | あなたのリクエストに一致して、当社データベース内で見つかったレコード数 |
accuracy |
Integer | この値はデータベースの信頼性を示します。値が 100 の場合、その性別判定結果は 100%% 正確であることを意味します |
duration |
String | リクエストを処理するためにサーバーが必要とした時間 |
credits_used |
Integer | このクエリで消費されたリクエスト数 |
有効な国コード:
AD
Andorra
AE
United Arab Emirates
AF
Afghanistan
AL
Albania
AM
Armenia
AO
Angola
AR
Argentina
AT
Austria
AU
Australia
AZ
Azerbaijan
BA
Bosnia and Herzegovina
BB
Barbados
BD
Bangladesh
BE
Belgium
BF
Burkina Faso
BG
Bulgaria
BH
Bahrain
BI
Burundi
BJ
Benin
BN
Brunei
BO
Bolivia
BR
Brazil
BS
Bahamas
BW
Botswana
BY
Belarus
BZ
Belize
CA
Canada
CD
Congo - Kinshasa
CG
Congo - Brazzaville
CH
Switzerland
CI
Côte d’Ivoire
CL
Chile
CM
Cameroon
CN
China
CO
Colombia
CR
Costa Rica
CU
Cuba
CV
Cape Verde
CY
Cyprus
CZ
Czech Republic
DE
Germany
DJ
Djibouti
DK
Denmark
DO
Dominican Republic
DZ
Algeria
EC
Ecuador
EE
Estonia
EG
Egypt
EH
Western Sahara
ES
Spain
ET
Ethiopia
FI
Finland
FJ
Fiji
FM
Micronesia
FR
France
GA
Gabon
GB
United Kingdom
GE
Georgia
GF
French Guiana
GH
Ghana
GI
Gibraltar
GL
Greenland
GM
Gambia
GN
Guinea
GP
Guadeloupe
GQ
Equatorial Guinea
GR
Greece
GT
Guatemala
GU
Guam
GY
Guyana
HK
Hong Kong SAR China
HN
Honduras
HR
Croatia
HT
Haiti
HU
Hungary
ID
Indonesia
IE
Ireland
IL
Israel
IN
India
IQ
Iraq
IR
Iran
IS
Iceland
IT
Italy
JE
Jersey
JM
Jamaica
JO
Jordan
JP
Japan
KE
Kenya
KG
Kyrgyzstan
KH
Cambodia
KM
Comoros
KR
South Korea
KW
Kuwait
KZ
Kazakhstan
LA
Laos
LB
Lebanon
LC
Saint Lucia
LI
Liechtenstein
LK
Sri Lanka
LR
Liberia
LS
Lesotho
LT
Lithuania
LU
Luxembourg
LV
Latvia
LY
Libya
MA
Morocco
MC
Monaco
MD
Moldova
ME
Montenegro
MG
Madagascar
MK
Macedonia
ML
Mali
MM
Myanmar [Burma]
MN
Mongolia
MQ
Martinique
MR
Mauritania
MT
Malta
MU
Mauritius
MV
Maldives
MW
Malawi
MX
Mexico
MY
Malaysia
MZ
Mozambique
NA
Namibia
NC
New Caledonia
NE
Niger
NG
Nigeria
NI
Nicaragua
NL
Netherlands
NO
Norway
NP
Nepal
NZ
New Zealand
OM
Oman
PA
Panama
PE
Peru
PF
French Polynesia
PG
Papua New Guinea
PH
Philippines
PK
Pakistan
PL
Poland
PR
Puerto Rico
PS
Palestinian Territories
PT
Portugal
PY
Paraguay
QA
Qatar
RE
Réunion
RO
Romania
RS
Serbia
RU
Russia
RW
Rwanda
SA
Saudi Arabia
SC
Seychelles
SD
Sudan
SE
Sweden
SG
Singapore
SH
Saint Helena
SI
Slovenia
SK
Slovakia
SL
Sierra Leone
SM
San Marino
SN
Senegal
SO
Somalia
SR
Suriname
ST
São Tomé and Príncipe
SV
El Salvador
SY
Syria
SZ
Swaziland
TD
Chad
TG
Togo
TH
Thailand
TJ
Tajikistan
TL
Timor-Leste
TM
Turkmenistan
TN
Tunisia
TR
Turkey
TT
Trinidad and Tobago
TW
Taiwan
TZ
Tanzania
UA
Ukraine
UG
Uganda
US
United States
UY
Uruguay
UZ
Uzbekistan
VE
Venezuela
VI
U.S. Virgin Islands
VN
Vietnam
YE
Yemen
YT
Mayotte
ZA
South Africa
ZM
Zambia
ZW
Zimbabwe
IPによるローカライズ - 国判定
顧客の IP アドレスに基づいて、その国を選択しよう
必要なリクエスト数: 1
リクエスト
米国の IP アドレスを使った例
GET https://gender-api.com/get?name=john&ip=54.201.16.177&key=<あなたのAPIキー>
リクエスト
ドイツの IP アドレスを使った例
GET https://gender-api.com/get?name=tanja&ip=178.27.177.23&key=<あなたのAPIキー>
リクエストパラメータ
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 照会する名前 |
ip |
String | 有効なIPアドレス |
key |
String | あなたの API キー |
レスポンス
米国の IP アドレスを使った例
{"name":"john","name_sanitized":"John","country":"US","gender":"male","samples":9991,"accuracy":99,"duration":"44ms","credits_used":1}
レスポンス
ドイツの IP アドレスを使った例
{"name":"tanja","name_sanitized":"Tanja","country":"DE","gender":"female","samples":143,"accuracy":97,"duration":"508ms","credits_used":1}
レスポンスフィールド
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 小文字に変換された送信名 |
name_sanitized |
String | 当社の正規化処理を適用したあとの名前 |
country |
String | 送信された国コード |
gender |
String | 取り得る値: male, female, unknown |
samples |
Integer | あなたのリクエストに一致して、当社データベース内で見つかったレコード数 |
accuracy |
Integer | この値はデータベースの信頼性を示します。値が 100 の場合、その性別判定結果は 100%% 正確であることを意味します |
duration |
String | リクエストを処理するためにサーバーが必要とした時間 |
credits_used |
Integer | このクエリで消費されたリクエスト数 |
Gender-API.com には、MaxMindが作成し提供している GeoLite2 データが含まれています http://www.maxmind.com.
ブラウザーの言語 / ロケールによる国情報のローカライズ
ブラウザーのロケールに基づいて、お客様の国を自動で判定しよう:
必要なリクエスト数: 1
リクエスト
USロケールの例
GET https://gender-api.com/get?name=john&locale=en_US&key=<あなたのAPIキー>
リクエスト
ドイツ語ロケールを使った例
GET https://gender-api.com/get?name=tanja&locale=de_DE&key=<あなたのAPIキー>
リクエストパラメータ
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 照会する名前 |
locale |
String | Browser locale |
key |
String | あなたの API キー |
レスポンス
USロケールの例
{"name":"john","name_sanitized":"John","country":"US","gender":"male","samples":991,"accuracy":99,"duration":"47ms","credits_used":1}
レスポンス
ドイツ語ロケールを使った例
{"name":"tanja","name_sanitized":"Tanja","country":"DE","gender":"female","samples":143,"accuracy":97,"duration":"99ms","credits_used":1}
レスポンスフィールド
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 小文字に変換された送信名 |
name_sanitized |
String | 当社の正規化処理を適用したあとの名前 |
country |
String | 送信された国コード |
gender |
String | 取り得る値: male, female, unknown |
samples |
Integer | あなたのリクエストに一致して、当社データベース内で見つかったレコード数 |
accuracy |
Integer | この値はデータベースの信頼性を示します。値が 100 の場合、その性別判定結果は 100%% 正確であることを意味します |
duration |
String | リクエストを処理するためにサーバーが必要とした時間 |
credits_used |
Integer | このクエリで消費されたリクエスト数 |
複数の名前を問い合わせる
1回のクエリで複数の名前を取得したい場合があるよね。そんなときに使おう
必要なリクエスト数: 名前1件ごとに1クレジット
リクエスト
国コードなし
GET https://gender-api.com/get?name=lisa;jess;thomas&multi=true&key=<あなたのAPIキー>
リクエスト
国コードあり
GET https://gender-api.com/get?name=anna;jack;stephen&country=DE;US;CA&multi=true&key=<あなたのAPIキー>
リクエストパラメータ
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 照会したい名前をセミコロンで区切ったリスト |
country |
String | 国コードをセミコロンで区切ったリスト。国コードは名前と同じ順番で指定してね。国コードが1つだけの場合、そのコードがすべての名前に適用される。 |
multi |
Boolean (true|false) | 結果を配列として返すように API に指示する |
key |
String | あなたの API キー |
レスポンス
国コードなし
{"name":"lisa;jess;thomas","result":[
{"name":"lisa","name_sanitized":"Lisa","country":"","gender":"female","samples":806,"accuracy":98},
{"name":"jess","name_sanitized":"Jess","country":"","gender":"female","samples":28,"accuracy":75},
{"name":"thomas","name_sanitized":"Thomas","country":"","gender":"male","samples":2239,"accuracy":99}],
"country":"","duration":"425ms","credits_used":3}
レスポンス
国コードあり
{"name":"anna;jack;stephen","result":[
{"name":"anna","name_sanitized":"Anna","country":"DE","gender":"female","samples":1245,"accuracy":98},
{"name":"jack","name_sanitized":"Jack","country":"US","gender":"male","samples":667,"accuracy":90},
{"name":"stephen","name_sanitized":"Stephen","country":"CA","gender":"male","samples":77,"accuracy":82}],
"country":"DE;US;CA","duration":"668ms","credits_used":3}
レスポンスフィールド
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 送信された名前を小文字に変換したもの。名前の最大件数は100件まで。 |
result |
Array | 「シンプルな使い方」のレスポンスを参照 |
country |
String | 送信された国コードのリスト |
duration |
String | リクエストを処理するためにサーバーが必要とした時間 |
credits_used |
Integer | このクエリで消費されたリクエスト数 |
メールアドレス
名前を含むメールアドレスを使って、性別を判定することもできるよ
必要なリクエスト数: 1
リクエスト
国コードなし
GET https://gender-api.com/get?email=markus.johnson@gmail.com&key=<あなたのAPIキー>
リクエスト
国コードあり
GET https://gender-api.com/get?email=jack.meyer@gmail.com&country=US&key=<あなたのAPIキー>
リクエストパラメータ
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 照会する名前 |
email |
String | Email address |
key |
String | あなたの API キー |
レスポンス
国コードなし
{"email":"markus.johnson@gmail.com","last_name":"Johnson","first_name":"Markus","mail_provider":"gmail","name":"markus","name_sanitized":"Markus","country":"","gender":"male","samples":150,"accuracy":99,"duration":"669ms","credits_used":1}
レスポンス
国コードあり
{"email":"jack.meyer@gmail.com","last_name":"Meyer","first_name":"Jack","mail_provider":"gmail","name":"jack","name_sanitized":"Jack","country":"US","gender":"male","samples":667,"accuracy":90,"duration":"1011ms","credits_used":1}
レスポンスフィールド
| フィールド | 種類 | 説明 |
|---|---|---|
email |
String | 送信されたメールアドレス |
last_name |
String | 見つかった名字 |
first_name |
String | 見つかった名前 |
mail_provider |
String | メールプロバイダーの名前 |
name |
String | 小文字に変換された見つかった名前 |
name_sanitized |
String | 当社の正規化処理を適用したあとの名前 |
country |
String | 送信された国コード |
gender |
String | 取り得る値: male, female, unknown |
samples |
Integer | あなたのリクエストに一致して、当社データベース内で見つかったレコード数 |
accuracy |
Integer | この値はデータベースの信頼性を示します。値が 100 の場合、その性別判定結果は 100%% 正確であることを意味します |
duration |
String | リクエストを処理するためにサーバーが必要とした時間 |
credits_used |
Integer | このクエリで消費されたリクエスト数 |
名と姓を分割
ページ上で名と姓を 1 つのフィールドにまとめている場合、この API を使ってそれぞれを抽出できるよ
必要なリクエスト数: 1
リクエスト
国コードなし
GET https://gender-api.com/get?split=theresa%20miller&key=<あなたのAPIキー>
リクエスト
国コードあり
GET https://gender-api.com/get?split=tim%20johnson&country=US&key=<あなたのAPIキー>
リクエスト
厳格モードオン
GET https://gender-api.com/get?split=markus%20stefan%20nonExistingLastName&strict=true&key=<あなたのAPIキー>
リクエストパラメータ
| フィールド | 種類 | 説明 |
|---|---|---|
split |
String | フルネーム |
country |
String | ISO 3166 ALPHA-2 国コード |
strict |
Boolean (true|false) | 厳格モードが有効な場合、last_name がデータベース内で見つからなければ、last_name フィールドには null を返すよ。 厳格モードが無効な場合は、データベースに存在しない場合でも、名字を抽出しようとする |
key |
String | あなたの API キー |
レスポンス
国コードなし
{"last_name":"Miller","first_name":"Theresa","strict":false,"name":"theresa","name_sanitized":"Theresa","country":"","gender":"female","samples":70,"accuracy":74,"duration":"56ms","credits_used":1}
レスポンス
国コードあり
{"last_name":"Johnson","first_name":"Tim","strict":false,"name":"tim","name_sanitized":"Tim","country":"US","gender":"male","samples":7,"accuracy":100,"duration":"58ms","credits_used":1}
レスポンス
厳格モードオン
{"last_name":"","first_name":"Markus Stefan","strict":true,"name":"markus","name_sanitized":"Markus","country":"","gender":"male","samples":150,"accuracy":99,"duration":"85ms","credits_used":1}
レスポンスフィールド
| フィールド | 種類 | 説明 |
|---|---|---|
last_name |
String | 見つかった名字 |
first_name |
String | 見つかった名前 |
strict |
Boolean | 厳格モードが有効なら true |
name |
String | 小文字に変換された見つかった名前 |
name_sanitized |
String | 当社の正規化処理を適用したあとの名前 |
country |
String | 送信された国コード |
gender |
String | 取り得る値: male, female, unknown |
samples |
Integer | あなたのリクエストに一致して、当社データベース内で見つかったレコード数 |
accuracy |
Integer | この値はデータベースの信頼性を示します。値が 100 の場合、その性別判定結果は 100%% 正確であることを意味します |
duration |
String | リクエストを処理するためにサーバーが必要とした時間 |
credits_used |
Integer | このクエリで消費されたリクエスト数 |
顧客には「名, 姓」の形式で名前を入力してもらってね。そうすることで、より正確な結果が返せる。
統計情報を取得
このコールで、自分のアカウントに関する各種統計情報を取得できるよ:
必要なリクエスト数: 0件のリクエスト
リクエスト
GET https://gender-api.com/get-stats?&key=<あなたのAPIキー>
リクエストパラメータ
| フィールド | 種類 | 説明 |
|---|---|---|
key |
String | あなたの API キー |
レスポンス
{"key":"yourkey","is_limit_reached":false,"remaining_requests":43566,"amount_month_start":90000,"amount_month_bought":100000,"duration":"37ms"}
レスポンスフィールド
| フィールド | 種類 | 説明 |
|---|---|---|
key |
String | あなたの API キー |
is_limit_reached |
Boolean | リクエストの残り回数がない場合に true を返します |
remaining_requests |
Integer | 残りのリクエスト数をカウント |
amount_month_start |
Integer | 月初の残りリクエスト数 |
amount_month_bought |
Integer | 今月購入したリクエスト数 |
duration |
String | リクエストを処理するためにサーバーが必要とした時間 |
出身国を取得
名前からその人の出身国を取得:
必要なリクエスト数: 2
リクエスト
名
GET https://gender-api.com/get-country-of-origin?name=Markus&key=<あなたのAPIキー>
リクエストパラメータ
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 照会する名前 |
key |
String | あなたの API キー |
レスポンス
{
"name": "markus",
"country_of_origin": [
{
"countryName": "Finland",
"country": "FI",
"probability": 0.74,
"continentalRegion": "Europe",
"statisticalRegion": "Northern Europe"
},
{
"countryName": "Sweden",
"country": "SE",
"probability": 0.22,
"continentalRegion": "Europe",
"statisticalRegion": "Northern Europe"
},
{
"countryName": "Other",
"country": "--",
"probability": 0.04
}
],
"name_sanitized": "Markus",
"gender": "male",
"samples": 150,
"accuracy": 99,
"country_of_origin_map_url": "https://gender-api.com/en/map/37/3da90b0fe64e5102"
"credits_used": 2,
"duration": "165ms"
}
レスポンスフィールド
| フィールド | 種類 | 説明 |
|---|---|---|
name |
String | 小文字に変換された送信名 |
name_sanitized |
String | 当社の正規化処理を適用したあとの名前 |
gender |
String | 取り得る値: male, female, unknown |
samples |
Integer | あなたのリクエストに一致して、当社データベース内で見つかったレコード数 |
accuracy |
Integer | この値はデータベースの信頼性を示します。値が 100 の場合、その性別判定結果は 100%% 正確であることを意味します |
country_of_origin |
Array | 出身国トップ25件。サポートされている国の一覧については「%sComplete List Of Possible Countries%s」を見てね |
country_of_origin_map_url |
String | レンダリングされた結果を表示する地図へのリンク。地図は10分間アクセス可能だよ。 たとえば、iframe を使ってこの地図を自分のプロダクトに埋め込むことができる。 |
duration |
String | リクエストを処理するためにサーバーが必要とした時間 |
credits_used |
Integer | このクエリで消費されたリクエスト数 |
スクリーンショット インタラクティブマップ
利用可能な国の一覧
| 国コード | 国名 | 統計地域 | 大陸地域 |
|---|---|---|---|
| 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 |
エラーコード
レスポンス
Error Example Message
{"errno":30,"errmsg":"limit reached"}
| errno(エラー番号) | errmsg(エラーメッセージ) | 説明 |
|---|---|---|
| 10 | invalid country code | 「有効な国コード」を参照 |
| 11 | number of country codes not equal to number of names | 名前の数が国コードの数と一致しません |
| 20 | name not set | サーバーで名前を受信できませんでした |
| 21 | too many names | 一度に指定できる名前は100件までです |
| 30 | limit reached | クエリの上限に達しました |
| 40 | invalid or missing key | あなたのサーバーキーは当社データベース内に見つかりませんでした |
| 500 | unknown error | サーバー内部エラー |