Quickstart

Get started with email checker API in 5 minutes. Free API key, code examples, and email verification integration guide.

わずか5分で BillionVerify API を使い始めましょう。このガイドでは、最初のメールアドレス検証までの手順を説明します。

前提条件

始める前に、以下が必要です：

BillionVerify アカウント（無料登録）
HTTP リクエストの基本知識、またはサポート対象言語のいずれかに精通していること

ステップ 1: アカウント作成

BillionVerify にアクセスし、Get Started をクリック
メールまたは Google/GitHub アカウントで登録
メールアドレスを確認

ステップ 2: API キーの取得

BillionVerify ダッシュボードにログイン
API Keys セクションに移動
Create New Key をクリック
キーにわかりやすい名前を付ける（例：「Development」、「Production」）
API キーをコピーして安全に保管

API キーをクライアントサイドのコードや公開リポジトリに公開しないでください。キーは環境変数を使用して安全に保存してください。

ステップ 3: 最初のメール検証

お好みの方法で最初の検証リクエストを送信してください：

curl -X POST https://api.billionverify.com/v1/verify/single \
  -H "BV-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

const response = await fetch('https://api.billionverify.com/v1/verify/single', {
  method: 'POST',
  headers: {
    'BV-API-KEY': process.env.BV_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'test@example.com',
  }),
});

const result = await response.json();
console.log(result);

import os
import requests

response = requests.post(
    'https://api.billionverify.com/v1/verify/single',
    headers={
        'BV-API-KEY': os.environ["BV_API_KEY"],
        'Content-Type': 'application/json',
    },
    json={'email': 'test@example.com'}
)

result = response.json()
print(result)

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    data := map[string]string{"email": "test@example.com"}
    body, _ := json.Marshal(data)

    req, _ := http.NewRequest("POST",
        "https://api.billionverify.com/v1/verify/single",
        bytes.NewBuffer(body))

    req.Header.Set("BV-API-KEY", os.Getenv("BV_API_KEY"))
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

<?php
$apiKey = getenv('BV_API_KEY');

$ch = curl_init('https://api.billionverify.com/v1/verify/single');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'BV-API-KEY: ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['email' => 'test@example.com']),
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

ステップ 4: レスポンスの理解

検証が成功すると、以下のようなレスポンスが返されます：

{
  "email": "test@example.com",
  "status": "valid",
  "result": {
    "deliverable": true,
    "valid_format": true,
    "valid_domain": true,
    "valid_mx": true,
    "disposable": false,
    "role": false,
    "catchall": false,
    "free": false,
    "smtp_valid": true
  },
  "score": 0.95,
  "credits_used": 1
}

主要なレスポンスフィールド

フィールド	型	説明
`status`	string	全体のステータス：`valid`、`invalid`、`unknown`、または `catchall`
`deliverable`	boolean	メールがメッセージを受信できるかどうか
`disposable`	boolean	一時的/使い捨てメールかどうか
`role`	boolean	役職ベースのアドレス（info@、support@）かどうか
`catchall`	boolean	ドメインがすべてのメールを受け入れるかどうか
`score`	number	0 から 1 の信頼スコア（高いほど良い）

ステータス値の説明

ステータス	意味	推奨アクション
`valid`	メールが存在し、メッセージを受信可能	送信しても安全
`invalid`	メールが存在しないか、メッセージを受信できない	リストから削除
`unknown`	ステータスを判定できなかった	後で再試行するか、注意して使用
`catchall`	ドメインがすべてのメールを受け入れる（キャッチオール）	バウンスを監視

ステップ 5: SDK の使用（推奨）

より簡単な統合のために、公式 SDK をインストールしてください：

npm install @billionverify/node

import { BillionVerify } from '@billionverify/node';

const client = new BillionVerify({
  apiKey: process.env.BV_API_KEY,
});

const result = await client.verify('test@example.com');
console.log(result.status); // 'valid'

pip install billionverify

from billionverify import Client
import os

client = Client(api_key=os.environ['BV_API_KEY'])
result = client.verify('test@example.com')
print(result.status)  # 'valid'

go get github.com/billionverify/go-sdk

import billionverify "github.com/billionverify/go-sdk"

client := billionverify.NewClient(os.Getenv("BV_API_KEY"))
result, err := client.Verify(ctx, "test@example.com")
fmt.Println(result.Status) // "valid"

composer require billionverify/php-sdk

use BillionVerify\Client;

$client = new Client(getenv('BV_API_KEY'));
$result = $client->verify('test@example.com');
echo $result->status; // 'valid'

<dependency>
    <groupId>com.billionverify</groupId>
    <artifactId>billionverify-java</artifactId>
    <version>1.0.0</version>
</dependency>

import com.billionverify.Client;

Client client = new Client(System.getenv("BV_API_KEY"));
VerificationResult result = client.verify("test@example.com");
System.out.println(result.getStatus()); // "valid"

次のステップ

最初のメール検証が完了したら、さらに多くの機能を探索しましょう：

API リファレンス

すべてのエンドポイントを含む完全な API ドキュメント

SDK ドキュメント

各 SDK の詳細ガイド

検証タイプ

さまざまな結果タイプを理解する

AI 統合

Claude、ChatGPT などとの連携

一般的なユースケース

フォームバリデーション

ユーザー登録時にリアルタイムでメールを検証：

const onEmailBlur = async (email) => {
  const result = await client.verify(email);

  if (result.status === 'invalid') {
    showError('Please enter a valid email');
  } else if (result.result.disposable) {
    showError('Disposable emails are not allowed');
  }
};

リストクリーニング

キャンペーン送信前にメールリストをクリーニング：

for email in email_list:
    result = client.verify(email)
    if result.status == 'valid':
        clean_list.append(email)
    else:
        remove_list.append(email)

リード評価

メール品質に基づいてリードをスコアリング：

const qualifyLead = (verificationResult) => {
  let score = verificationResult.score * 50; // Base score

  if (!verificationResult.result.free) score += 20;      // Business email
  if (!verificationResult.result.role) score += 15;      // Personal address
  if (!verificationResult.result.disposable) score += 15; // Permanent email

  return score;
};

サポートが必要ですか？

統合ガイドで実装例を確認
support@billionverify.com にお問い合わせ

Quickstart

API リファレンス

SDK ドキュメント

検証タイプ

AI 統合

On this page