REST API · v1 · ライブドキュメント

SEO API を、あなたのスタックに

あなたのSEO・AI可視性データを、クリーンなRESTエンドポイントで。

Google Search Console、順位、AI Trackerのデータを、あなたのプロダクト、ダッシュボード、データウェアハウスに直接取り込めます。ダッシュボードから発行したBearerキーで認証し、REST /v1を呼び出せば、型付きのJSONが返ります — SEOcrawl AI MCPを支えるのと同じ正規データレイヤーです。GA4、完全なサイト監査エクスポート、マルチテナントのパートナーOAuthも順次提供予定です。

APIキーを取得APIドキュメントを読むMCPを見る
Claude
Codex CLI
Cursor
SEOcrawl AI REST API — curl request and typed JSON response
SEOcrawl AI REST API examples in cURL, JavaScript and Python

一度認証すれば、あとはRESTを呼ぶだけ。

ダッシュボードからBearerトークンを発行し、Authorizationヘッダーに渡すだけ。同じキーがREST APIとMCPサーバーの両方で使えます。

ベースURL

https://api.seocrawl.ai/v1

Authorizationヘッダー

Authorization: Bearer sca_live_your_token_here
APIキーを取得Read the API docs

1つのデータレイヤー、2つのサーフェス

すべてのRESTエンドポイントは、MCPツールと同じ正規レイヤーから読み取ります — だからあなたのダッシュボードとAIエージェントは常に同じ数値を見ます。以下のグループはv1でライブ稼働中で、カバレッジは継続的に拡大しています。

プロパティ

アクセスできるSearch Consoleプロパティを一覧表示。各プロパティのidを、あらゆるデータエンドポイントのパスで使用します。

  • GET/v1/propertiesライブ

Google Search Console

クリック、表示回数、CTR、平均掲載順位を — クエリ別、ページ別、期間別、期間比較で。詳細はGoogle Search Console APIの専用ページで。

  • GET/v1/properties/{id}/gsc/summaryライブ
  • GET/v1/properties/{id}/gsc/compareライブ
  • GET/v1/properties/{id}/gsc/top-keywordsライブ
  • GET/v1/properties/{id}/gsc/top-pagesライブ
  • GET/v1/properties/{id}/gsc/keywords/detailライブ
  • GET/v1/properties/{id}/gsc/pages/detailライブ

AI Tracker

ChatGPT、Claude、Gemini、Perplexityにわたるブランド言及を監視しているプロンプトを読み取れます。

  • GET/v1/properties/{id}/ai-tracker/promptsライブ

タスク

SEOタスクの読み書き — あなたのタスクボードを、独自のプロジェクト管理スタックに連携できます。

  • GET/v1/properties/{id}/tasksライブ
  • POST/v1/properties/{id}/tasksライブ
  • GET/v1/properties/{id}/tasks/{ticketId}ライブ
  • PATCH/v1/properties/{id}/tasks/{ticketId}ライブ
  • POST/v1/properties/{id}/tasks/{ticketId}/commentsライブ

GA4 & インデックス

トラフィック、AIリファラー、インデックス状況。基盤は準備済みで、RESTエンドポイントは順次提供中です。

  • GET/v1/properties/{id}/ga4/summary近日
  • GET/v1/properties/{id}/indexation/summary近日

サイト監査

クロールのhealth、on-page、技術要素、問題リスト — 完全な監査データセットをRESTで公開します。

  • GET/v1/properties/{id}/audit/summary近日
  • GET/v1/properties/{id}/audit/issues近日

スクレイパーではなく、プロダクトのために

Bearer認証、スコープ、レート制限を備えた本物のREST API — MCPと1つの正規データレイヤーを共有するので、数値が食い違うことはありません。

クリーンなREST、型付きJSON

予測可能なリソース、標準的なHTTP verb、型付きのJSONレスポンス、そしてRFC準拠のエラー（401 unauthenticated、403 scope_required、429 と Retry-After）。HTMLスクレイピングも、壊れやすいエクスポートも不要です。

1つの正規データレイヤー

RESTエンドポイントとMCPツールは、同じプロバイダーの上に立つ兄弟で、CIでパリティをテストしています。あなたのダッシュボードとAIエージェントは、常に同一のクリック、表示回数、順位を見ます。

セルフサービスのキー

ダッシュボードからBearerトークンを数秒で発行・失効できます。同じ sca_live_ キーがREST APIとMCPサーバーの両方を認証します — 1つの資格情報で、2つのサーフェスを。

明文化されたレート制限

トークンごとに毎分60リクエスト、毎時1,000リクエスト。超過すると明確な 429 + Retry-After レスポンスが返ります。RESTの制限はMCP利用とは別プールなので、一方が他方を圧迫することはありません。

スコープ付きアクセス

粗粒度の読み取り・書き込みスコープがすべてのエンドポイントを制御し、ファイアウォールで標準的なstep-upレスポンスとともに強制されます。キーには必要な権限だけを付与できます。

マルチテナント、近日提供

テナントごとのGoogle OAuthフローにより、パートナーは各顧客のGSCプロパティを1つのアカウントの下に接続できます — 厳格なデータ分離とともに。現在アクティブに開発中で、早期アクセスはお問い合わせください。

3ステップで開始

ゼロから最初の認証済み呼び出しまで、数分で。

1

キーを発行

ダッシュボードでAPIトークンを開き、Bearerトークンを生成します。sca_live_で始まるので、一度だけコピーしておきましょう。

2

ヘッダーを送信

すべてのリクエストで Authorization: Bearer sca_live_… を https://api.seocrawl.ai/v1 に渡します。同じキーはMCPサーバーでも使えます。

3

データを取得

GET /v1/properties を呼んでプロパティの id を取得し、/v1/properties/{id}/… を叩いてGSCパフォーマンス、AI Trackerのプロンプト、タスクを取得 — JSONをそのままあなたのプロダクト、ダッシュボード、ウェアハウスに流し込めます。

データにアクセスする3つの方法

同じ数値、違うサーフェス — あなたの作り方に合ったものを選べます。

REST API

プロダクト、ダッシュボード、データパイプライン向け。Bearer認証、型付きJSON、レート制限。今ご覧のページです。

MCPサーバー

AIエージェント向け — Claude、ChatGPT、あらゆるMCPクライアントが、あなたのデータを自然言語でクエリします。

MCPを見る

ターミナル & CLI

スクリプトやCI/CD向け — MCP対応のあらゆるターミナルエージェントから、データを操作できます。

CLIを見る
すべての連携を比較

APIの上に構築する人たち

SEOとAI可視性のデータを、自社システムの中に取り込みたいチームへ。

SaaS & パートナー

ライブのSEOメトリクスを、あなたのプロダクトUIに埋め込みます。パイプラインを自分で構築せずに、ユーザーにSearch ConsoleとAI可視性データを提供できます。

代理店

すべてのクライアントのデータを、カスタムポータル、Looker Studio、レポーティングレイヤーに流し込めます — 1つのキーで、すべてのプロパティを、手動エクスポートなしで。

データチーム

GSC、順位、AI Trackerのデータを、スケジュールに沿ってウェアハウスに取り込みます。売上と結合し、ダッシュボードに必要なモデルを構築できます。

開発者

チェックとアラートを自動化し、タスクをPMツールと同期し、AI可視性モニタリングを、すでに提供しているアプリに組み込めます。

よくある質問

本当に公開のSEO APIがあるのですか？

はい — Bearer認証のREST /v1 APIがライブ稼働しており、Search Consoleパフォーマンス、プロパティ、AI Trackerのプロンプト、タスクをカバーしています。完全な公開リファレンスはapi.seocrawl.ai/docsで公開中です。より広いカバレッジ（GA4、完全なサイト監査エクスポート）とマルチテナントのパートナーOAuthは順次提供予定です。まだライブでない機能が必要ですか？ 早期アクセスはお問い合わせください。

認証はどうすればよいですか？

Bearerトークンを使います。ダッシュボードから sca_live_ キーを発行し、すべてのリクエストで Authorization: Bearer <key> として送信します。自分のアカウントにはOAuthの手続きは不要 — ヘッダーだけで済みます。

MCPと同じキーですか？

はい。同じトークンがREST APIとMCPサーバーの両方を認証します。どちらも1つの正規データレイヤーから読み取るからです。1つの資格情報で、2つのサーフェスを — そして両者で同一の数値を。

レート制限は何ですか？

トークンごとに毎分60リクエスト、毎時1,000リクエストです。超過すると Retry-After ヘッダー付きの 429 が返ります。RESTの制限はMCP利用とは別々に管理されるため、両者が同じ予算を奪い合うことはありません。

自分の顧客のSearch Consoleプロパティを接続できますか？

そのマルチテナントのパートナーフロー — テナントごとのGoogle OAuthで、各顧客のGSCプロパティを自分のアカウントの下に、厳格なデータ分離とともに接続できるもの — は現在アクティブに開発中です。パートナー連携を構築中なら、早期アクセスについてご連絡ください。

今日、どんなデータを取得できますか？

Search Consoleのサマリーと期間比較、トップキーワードとページ、単一キーワード／ページの詳細、あなたのプロパティ一覧、AI Trackerのプロンプト、そしてタスクの完全な読み書き。MCPが公開しているものを、RESTで反映します。

あなたのSEOデータの上に構築する準備はできましたか？

ダッシュボードからBearerキーを発行し、数分で最初のREST呼び出しを — あるいはパートナー／マルチテナントアクセスについてご相談ください。

APIキーを取得APIドキュメントを読むデモを予約