Visovra API
ドキュメント
GEO 分析をプログラムから実行し、リアルタイムの GEO スコアを取得。Visovra の AI Engineering Intelligence を、自社のツール・ダッシュボード・CI パイプライン・代理店向けワークフローに統合できます。
認証
すべての API リクエストには、Authorization ヘッダーに Bearer トークン形式で API キーを含める必要があります。API キーは アカウント設定から確認できます。
Authorization: Bearer viso_xxxxxxxxxxxxxxxxxxxxxxxx
レート制限とプラン別上限
API アクセスはプランごとに制限されます。レート制限は API キーごと、24時間のローリングウィンドウで適用されます。
| プラン | API レート制限 | 監査あたりのページ数 | 監査レポート | APIアクセス |
|---|---|---|---|---|
| Trial / Standard | PDF + GEO | サイトクロール | Standard: 50/月 | — |
| Pro | 500 req/日 | 50+ | 無制限 | ✓ |
| Agency | 2,000 req/日 | 200 | 無制限 | ✓ |
| Enterprise | 無制限 | 500+ | 無制限 | ✓ |
エンドポイント
すべてのエンドポイントは JSON を受け取り、JSON を返します。エラーは HTTP ステータスコードと、エラーメッセージを含む JSON ボディで返されます。
/api/v1/audits新しい GEO 分析を開始
GEO 分析をキューに登録します — ChatGPT、Gemini、Perplexity、Claude、Copilot、DeepSeek、Google AI Overviews へのライブ引用チェックと 101 項目の技術監査。ポーリング用の分析 ID を返します。エイリアス: POST /api/audit/start。
リクエストボディ
{ "url": "https://example.com" }レスポンス
{ "auditId": "cuid", "status": "pending", "pollUrl": "https://visovra.com/api/v1/audits/cuid" }cURL の例
curl -X POST https://visovra.com/api/v1/audits \
-H "Authorization: Bearer viso_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}'/api/v1/audits/:idGEO 分析結果を取得
GEO スコア（0〜100）、プラットフォームごとの引用データ、技術スコアを返します。エイリアス: GET /api/audit/:id。
レスポンス
{ "auditId": "...", "status": "completed", "scores": { "overall": 78, "geo": 64 } }cURL の例
curl https://visovra.com/api/v1/audits/AUDIT_ID \ -H "Authorization: Bearer viso_YOUR_API_KEY"
/api/v1/auditsすべての GEO 分析を一覧取得
組織のサイトに紐づく分析を新しい順で返します。?page=1&limit=20 でページネーション。エイリアス: GET /api/audit/list。
レスポンス
{ "audits": [{ "id": "...", "url": "...", "status": "completed", "overallScore": 78, "geoScore": 64 }], "page": 1, "limit": 20, "total": 1 }cURL の例
curl "https://visovra.com/api/v1/audits?page=1&limit=20" \ -H "Authorization: Bearer viso_YOUR_API_KEY"
/api/v1/audits/:id監査を削除
監査と関連する結果を完全に削除します。エイリアス: DELETE /api/audit/:id。
レスポンス
{ "success": true }cURL の例
curl -X DELETE https://visovra.com/api/v1/audits/AUDIT_ID \ -H "Authorization: Bearer viso_YOUR_API_KEY"
エラーコード
Visovra は標準的な HTTP ステータスコードを使用します。すべてのエラーには error キーを含む JSON ボディが付きます。
| ステータス | 意味 | 説明 |
|---|---|---|
| 200 | OK | リクエストが成功しました。 |
| 400 | Bad Request | パラメータが不正、または必須項目が不足しています。 |
| 401 | Unauthorized | API キーが未指定または無効です。 |
| 403 | Forbidden | ご利用のプランには API アクセスが含まれていません。 |
| 404 | Not Found | 指定されたリソースが見つかりません。 |
| 429 | Too Many Requests | レート制限を超えました。ウィンドウのリセット後に再試行してください。 |
| 500 | Server Error | 当方の問題が発生しました。解消しない場合はサポートまでご連絡ください。 |
連携を始めましょう
設定ページから API キーを取得してください。Pro・Agency・Enterprise プランでは、GEO 分析・スコア・Webhook・AI Engineering Intelligence データへの REST API フルアクセスが含まれます。