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

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

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

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

APIキーを取得MCPを見る

Bearer認証 · 60 req/min · MCPと同じデータレイヤー · スクレイピングなし

seocrawl — REST /v1

$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \

-H "Authorization: Bearer sca_live_…"

{ "data": {

"period": { "from": "2026-06-09", "to": "2026-07-06" },

"metrics": {

"clicks": 2388, "impressions": 811019,

"ctr": 0.00294, "position": 22.87

},

"metrics_diff": { "clicks": 584, … }

} }

一度認証すれば、あとは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
cURLJavaScriptPython
# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
  -H "Authorization: Bearer sca_live_…"

curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
  -H "Authorization: Bearer sca_live_…"

// JavaScript
const res = await fetch(
  "https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
  { headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();

# Python
import requests
r = requests.get(
  f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
  params={"range": "last_28_days"},
  headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())
エンドポイント

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

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

プロパティ

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

  • GET/v1/propertiesライブ

Google Search Console

クリック、表示回数、CTR、平均掲載順位を — クエリ別、ページ別、期間別、期間比較で。

  • 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近日
このAPIの理由

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

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キーを取得デモを予約