Visovra API
ドキュメント
GEO 分析をプログラムから実行し、リアルタイムの GEO スコアを取得。Visovra の AI Engineering Intelligence を、自社のツール・ダッシュボード・CI パイプライン・代理店向けワークフローに統合できます。
認証
すべての API リクエストには、Authorization ヘッダーに Bearer トークン形式で API キーを含める必要があります。API キーは アカウント設定から確認できます。
Authorization: Bearer rs_live_xxxxxxxxxxxxxxxxxxxxxxxx
レート制限とプラン別上限
API アクセスはプランごとに制限されます。レート制限は API キーごと、24時間のローリングウィンドウで適用されます。
| プラン | API レート制限 | 監査あたりのページ数 | 監査レポート | APIアクセス |
|---|---|---|---|---|
| Free | 10 req/日 | 15 | 3/月 | — |
| Pro | 500 req/日 | 50 | 無制限 | ✓ |
| Agency | 2,000 req/日 | 200 | 無制限 | ✓ |
| Enterprise | 無制限 | 500 | 無制限 | ✓ |
エンドポイント
すべてのエンドポイントは JSON を受け取り、JSON を返します。エラーは HTTP ステータスコードと、エラーメッセージを含む JSON ボディで返されます。
/api/audit/start新しい GEO 分析を開始
指定した URL に対する GEO 分析をキューに登録します — ChatGPT、Gemini、Perplexity、Claude、Copilot にまたがるライブの引用チェックに加え、技術チェックと GPT-4o による修正プラン生成も行います。結果をポーリングするための分析 ID を返します。
リクエストボディ
{ "url": "https://example.com" }レスポンス
{ "auditId": "cuid", "status": "pending" }cURL の例
curl -X POST https://visovra.com/api/audit/start \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}'/api/audit/:idGEO 分析結果を取得
GEO スコア（0〜100）、プラットフォームごとの引用データ、競合比較、GPT-4o による GEO 改善提案を含む、分析結果の全体を返します。分析が実行中の場合、status は "running" になります。
レスポンス
{ "id": "...", "status": "completed", "overallScore": 78, "geoScore": 64, "findings": [...] }cURL の例
curl https://visovra.com/api/audit/AUDIT_ID \ -H "Authorization: Bearer YOUR_API_KEY"
/api/audit/listすべての GEO 分析を一覧取得
アカウントに紐づくすべての GEO 分析を新しい順で返します。?page=1&limit=20 のクエリパラメータでページネーションに対応しています。
レスポンス
{ "audits": [{ "id": "...", "url": "...", "status": "completed", "overallScore": 78, "geoScore": 64 }] }cURL の例
curl https://visovra.com/api/audit/list \ -H "Authorization: Bearer YOUR_API_KEY"
/api/audit/:id監査を削除
監査と関連するすべての結果を完全に削除します。この操作は取り消せません。
レスポンス
{ "success": true }cURL の例
curl -X DELETE https://visovra.com/api/audit/AUDIT_ID \ -H "Authorization: Bearer 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 フルアクセスが含まれます。