世界の電話番号データ
1つの番号を統一された複数形式へ
国内形式、国際形式、表記が不揃いな番号を送信すると、242の国と地域に対応した標準形式と検証メタデータを取得できます。
元の入力
→+1 212 867 5309E.164出力
+12128675309検証
isValid 与 isPossibleフォーマット国内、国際、E.164
分類携帯電話、固定電話、VoIPなど
位置情報地域、市外局番、所在地
入力パラメータ
番号と地域情報
| パラメータ | 要否 | 説明 |
|---|---|---|
number | 必須 | 国内形式、国際形式、E.164形式の電話番号。 |
address | 条件付き必須 | 国内番号の解析に使用するISO国コード、国名、都市名、地域名。 |
addressが必須となる場合
number が + と国番号で始まらない場合は、JP、Japan、Tokyo などの地域情報を指定してください。
JPJapanTokyoOsakaSingaporeGET
クエリ文字列による認証
基本的なGETリクエスト
cURL
curl "https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=%2B12128675309&address=US"URLエンコード：
+ は %2B、空白は %20 にエンコードします。文字列を手作業で連結せず、言語が提供するURL/URLSearchParamsツールを使用してください。POST
Bearer 身份検証
サーバー側POSTリクエスト
番号と任意の address をJSONで送信し、Authorization ヘッダーへAPIキーを渡します。
cURL
curl -X POST "https://api.genderapi.io/api/phone" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"number":"+12128675309","address":"US"}'JavaScript
const response = await fetch("https://api.genderapi.io/api/phone", {
method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
body: JSON.stringify({ number: "+12128675309", address: "United States" })
});APIレスポンス
検証、フォーマット与元数据
JSON
{
"status": true, "remaining_credits": 15709, "expires": 0, "duration": "18ms",
"regionCode": "US", "countryCode": 1, "country": "United States",
"national": "(212) 867-5309", "international": "+1 212-867-5309", "e164": "+12128675309",
"isValid": true, "isPossible": true, "numberType": "FIXED_LINE_OR_MOBILE",
"nationalSignificantNumber": "2128675309", "rawInput": "+1 212 867 5309",
"isGeographical": true, "areaCode": "212", "location": "New York City (Manhattan)"
}レスポンスフィールド
| フィールド | 型 | 説明 |
|---|---|---|
status | boolean | リクエストが正常に完了したかどうか。 |
remaining_credits | integer | リクエスト完了後の残りクレジット数。 |
expires | integer | クレジットの有効期限を示すUNIXタイムスタンプ。 |
duration | string | サーバー処理時間。 |
regionCode | string | 検出されたISO 3166-1 alpha-2地域コード。 |
countryCode | integer | 国際電話の国番号。 |
country | string | 読みやすい国・地域名。 |
national | string | 国内表記に整形された番号。 |
international | string | 国際表記に整形された番号。 |
e164 | string | 正規化されたE.164形式。 |
isValid | boolean | 番号が地域の検証ルールに適合するかどうか。 |
isPossible | boolean | 番号構造として存在し得るかどうか。 |
numberType | string | 検出された番号種別。 |
nationalSignificantNumber | string | 国番号を除いた国内番号。 |
rawInput | string | リクエストで送信した元の番号。 |
isGeographical | boolean | 番号を地理的地域に関連付けられるかどうか。 |
areaCode | string | 検出された市外局番部分。 |
location | string | 市外局番に関連する地域。 |
番号種別リファレンス
番号種別の値
FIXED_LINE地理的地域に関連する固定電話。
MOBILE携帯電話番号。
FIXED_LINE_OR_MOBILE番号計画上、固定電話と携帯電話を区別できない番号。
TOLL_FREE着信側が料金を負担するフリーダイヤル番号。
PREMIUM_RATE高額課金サービス番号。
SHARED_COST発信者と着信者が通話料金を分担する番号。
VOIPIP音声通話の電話番号。
PERSONAL_NUMBER別回線へ転送できる個人番号。
PAGERページャー通知番号。
UAN企業の共通窓口で使用するユニバーサルアクセス番号。
VOICEMAIL専用ボイスメールアクセス番号。
UNKNOWN番号種別を判定できません。
よくある質問
電話番号APIに関するよくある質問
電話番号検証APIは何を行いますか？
電話番号を検証・正規化し、国内形式、国際形式、E.164形式を返します。利用可能な場合は地域、番号種別、位置情報も識別します。
isValidとisPossibleの違いは何ですか？
isValidは地域の番号規則に照らして検証します。isPossibleは、有効性を確定できなくても電話番号として成立し得る構造かを示します。
addressはいつ必須ですか？
番号がプラス記号と国番号で始まらない場合はaddressを指定します。ISO国コード、国名、都市名、地域名を使用できます。
特殊文字はどのように送信しますか？
GETクエリでは空白、プラス記号、その他の特殊文字をURLエンコードします。POSTのJSON本文はHTTPクライアントがエンコードします。
次のリファレンス