Searvia
ヘルプセンター · AI、API、MCP

Searvia REST APIを使う

順位、AI可視性、サイトヘルス、レビュー、市場データを、MCPと同じキーと上限で、独自のスクリプトやダッシュボードから取得できます。

約4分

必要なもの

  • 設定 › API & MCP で発行したAPIキー
  • 全プラン対応:Freeは月100回のAPI・MCP呼び出し、Indieは1,000回、Starter以上は無制限
  1. 1

    キーを作成

    アカウント › API & MCP

    APIを呼び出すスクリプトまたはサーバー用にキーを作成します。キーは作成時にいるアカウントでのみ使えます。

  2. 2

    Bearerトークンとして送信

    ヘッダー Authorization: Bearer の後にキーを付けて https://searvia.com/api/v1 を呼び出します。まずは GET /projects でプロジェクトIDを確認しましょう。

  3. 3

    リファレンスからエンドポイントを選ぶ

    開発者ページにすべてのエンドポイントを掲載しています。/api/v1/openapi.json のOpenAPIファイルには全フィールドが含まれ、Postman、Insomnia、コードジェネレーターで使えます。

  4. 4

    ページ、上限、エラーの扱い

    一覧は page と per_page を受け付けます。X-RateLimit-Remaining を確認し、429が返ったら Retry-After の時間だけ待ってください。エラーは常に error.status、error.code、error.message で返されます。

利用できる内容

管理画面からコピーしなくても、データが独自のツールに流れ込みます。

  • クレジットを使う呼び出しはプレビューなしで実行され、残高が足りない場合は402を返します。キーで行ったすべての変更は、キー名とともに監査ログに記録されます。
  • 日別のフラットな行(1日1キーワード、AI回答1件、監査1件)が必要な場合は、/projects/{id}/reports 配下のレポートエンドポイントを使います。

トラブルシューティングとよくある質問

MCPと同じですか?
はい。各エンドポイントはMCPサーバーと同じツールを実行するため、結果、プランの上限、クレジットも一致します。MCPはAIアシスタント向け、REST APIはコード向けです。
読み取り専用の接続でデータを変更できますか?
できません。読み取り専用で接続したアプリは、変更や消費を伴うエンドポイントで403になります。

MCPでも利用可能:list_projectsget_keyword_rankings

APIリファレンスを開く