Skip to main content
FaceSearch REST API

あらゆる言語から顔検索を実行

FaceSearch REST API は、開発者に小さく安定した逆顔画像検索のインターフェースを提供します。写真を送信し、完了をポーリングし、結果を受け取るだけ。Bearer トークン認証、冪等リトライ、公開 OpenAPI 仕様を備えています。

エンドポイントは 1 つ • 検索ごとに 3 クレジット • すべて JSON

世界中の数千人から信頼されています

15,000+ 件の検索
50+ か国
256ビット暗号化
99.7% の精度

REST API の仕組み

空のターミナルから最初の検索結果までわずか 3 ステップ。

API キーを作成
1

API キーを作成

ダッシュボードにログインしてキーを発行します。平文は 1 度だけ表示されます。シークレットマネージャーに保存し、ソースコードには決してコミットしないでください。

画像を POST
2

画像を POST

Bearer ヘッダーを付けて curl -F [email protected] https://facesearch.net/api/v1/search を実行します。エンドポイントは 1 秒以内に jobId を返します。

完了までポーリング
3

完了までポーリング

3〜5 秒ごとに GET /api/v1/search/{jobId} を呼び出します。ステータスが completed になると、一致したソース URL、サムネイル、信頼度スコアがレスポンスに含まれます。

REST API の機能

本番バックエンドに顔検索を組み込むために必要なすべて。

REST API face search features visualization

OpenAPI 3.1 仕様

/api/v1/openapi.json に手書きの OpenAPI ドキュメントを用意しており、Postman へのインポートから 20 以上の言語向けに生成されるクライアントまで、あらゆる型安全 SDK を支えます。

冪等リトライ

RFC 9110 準拠の Idempotency-Key ヘッダーを送信すれば、重複する送信に対して同じ jobId が返ります。ヘッダーを省略した場合でも、サーバーが自動でコンテンツハッシュを算出するため、素朴なリトライでも常に安全です。

キー単位のクォータ

各 API キーには日次・月次の上限を任意に設定できます。漏洩したキーで残高全体を使い切られることはなく、クォータは Redis の速度で、Postgres のフォールバックとともに適用されます。

細粒度のレート制限

すべてのレスポンスに X-RateLimit-Remaining と X-RateLimit-Reset ヘッダーを含みます。429 レスポンスには Retry-After が付くので、いつ再試行すべきかが一目で分かります。

共有クレジットプール

API 利用は Web UI と同じクレジット残高から消費されます。ダッシュボードで 1 度チャージすれば両面で使え、新たな課金 SKU を管理する必要はありません。

予測可能なエラー

すべてのエラーレスポンスは code、message、status の安定したエンベロープ形式です。INSUFFICIENT_CREDITS や RATE_LIMITED といったコードは変わらないので、エラー処理はシンプルなまま長く使えます。

コピー。ペースト。出荷。

FaceSearch の API 呼び出しはすべて 1 つの HTTP リクエストです。同じ「顔検索を送信する」フローを 5 つの言語で示します。

ターミナルのワンライナー
# 1. Submit a face image for search
curl -X POST https://facesearch.net/api/v1/search \
  -H "Authorization: Bearer fs_live_YOUR_KEY" \
  -H "Idempotency-Key: submit-$(date +%s)" \
  -F "image=@/path/to/face.jpg" \
  -F "consent=true"

# 2. Poll for completion
curl https://facesearch.net/api/v1/search/JOB_ID \
  -H "Authorization: Bearer fs_live_YOUR_KEY"

# 3. Check your credit balance
curl https://facesearch.net/api/v1/credits \
  -H "Authorization: Bearer fs_live_YOUR_KEY"

REST API の上で構築しているのは誰か

バックグラウンド調査から安全ツールまで、大規模な顔検索を必要とするチームを支えています。

FaceSearch API を組み込むバックエンドエンジニア
フィンテック

本人確認パイプライン

KYC やオンボーディングのサービスは、本人確認ワークフローから API を呼び出し、提出された ID の写真が公開 Web 上の他の写真と同一人物かを確認します。

自動化された顔チェックを運用する信頼と安全のアナリスト
安全

自動モデレーション

信頼と安全チームは API をインシデント対応パイプラインに接続し、エスカレーションされたユーザー通報を数時間ではなく数秒で文脈補完します。

ノートブックから一括顔検索を実行するリサーチャー
リサーチ

調査報道・リサーチ

調査報道記者や OSINT リサーチャーは Jupyter ノートブックから一括顔検索をスクリプト化し、冪等キーヘッダーで夜間バッチの重複を排除します。

信頼される顔検索プラットフォーム

1000万+
完了した検索
世界中で信頼できる結果
95%
一致精度
高度なAIで駆動
5万+
アクティブユーザー
成長するコミュニティ
1億+
スキャンされたソース
包括的なカバレッジ

開発者が API について語ること

FaceSearch を本番ワークフローに組み込んだチームからの実際のフィードバック。

"ハイブリッドな冪等キーの仕様は、私が見てきた API の中で一番良くできています。素朴なリトライはそのまま動きますし、新しい検索が必要なときは明示的なキーで完全にコントロールできます。"
Priya R.
スタッフエンジニア、フィンテックスタートアップ
"FaceSearch を午後だけでモデレーションパイプラインに組み込みました。キー単位のクォータのおかげで、誰かが誤って残高を使い切る心配なしに各チームへ専用キーを渡せます。"
Marcus T.
信頼と安全リード
"OpenAPI 仕様のおかげで、1 コマンドで型付きの Python クライアントを生成できました。エラーコードが変わらないので、パイプラインは良い意味で何か月も退屈なままです。"
Yuki H.
リサーチエンジニア

シンプルで透明な価格設定

ニーズに合ったプランを選択してください。隠れた料金はなく、いつでもキャンセルできます。

FREE

$0/月

開始に最適

  • Face Search
無料で開始
最も人気

PRO

$29/月

プロフェッショナルおよびパワーユーザー向け

  • 100 Credits per month ($0.29 per credit)
  • Face Search
  • Search History
  • Can Export Profile to PDF
従量課金

またはクレジットパックを購入

Starter

3クレジット

$6

$2.00/credit

節約 20%

Basic

30クレジット

$24

$0.80/credit

節約 31%

Standard

100クレジット

$69

$0.69/credit

節約 34%

Pro

300クレジット

$199

$0.66/credit

節約 40%

Enterprise

1000クレジット

$599

$0.60/credit

REST API のよくある質問

最初のリクエストを書く前に開発者が必ず聞くこと。

REST API で開発を始める

無料の API キーを作成し、curl のワンライナーを貼り付ければ、10 分以内に初回の検索を実行できます。

API キーを作成

No credit card required