Googleの検索結果、オーガニックランキング、結果URL、タイトル、スニペット、関連検索キーワードを構造化JSONとして抽出し、SERPモニタリング、順位トラッキング、検索露出ワークフローに活用できます。
構造化出力
CrawloraのGoogle Search APIを使えば、自前のパーサー、プロキシルーティング、リトライ処理、レスポンス正規化を構築することなく、公開されているGoogleのSERPデータを収集できます。このエンドポイントが返す構造化JSONは、順位トラッキングツール、SEOダッシュボード、キーワードモニタリングツール、競合リサーチ、AI検索ワークフローを支えます。
SERPワークフロー
Crawloraは、各ドメインがGoogleでどのように順位付けされているか、どの結果URLとスニペットが表示されているか、そしてキーワード・国・言語をまたいで順位が時間とともにどう変化するかを記録するチームを支援します。
SERPモニタリングワークフローリクエストスキーマ
これらのパラメータは、稼働中の「Google search API」カタログエントリから取得しています。
| パラメータ | 型 | 必須 | 説明 | 例 |
|---|
JSON例
この例は稼働中のエンドポイントカタログからレンダリングされるため、ページは常にDocsおよびPlaygroundと同期しています。
{
"code": 200,
"msg": "OK",
"data": {
"result": [
{
"position": 1,
"title": "ChatGPT",
"website_name": "ChatGPT",
"icon": "",
"link": "https://chatgpt.com/",
"Snippet": "ChatGPT helps you get answers and create."
}
],
"ai_overview": {
"heading": "AI Overview",
"summary": "ChatGPT is a generative AI chatbot developed by OpenAI that can answer questions and hold conversations.",
"sources": [
"https://openai.com/chatgpt/"
]
},
"people_also_ask": [
{
"question": "What is ChatGPT used for?"
}
]
}
}エンドポイントカタログ
/google/searchReturns normalized Google web search results. Results are fetched through proxied browser renderers that race several concurrent renders per request and return the first clean result, with stale-cache fallback when available. The endpoint returns 503 when Google serves a challenge page or unusable HTML. Rate limit is enforced at 1 request per second, and if the limit is exceeded a 429 status code is returned with rate limit headers.
MCPツール google_search
マネージド実行
対応する公開Google検索結果ページ向けに、Crawloraはリクエスト処理、プロキシ対応の収集、レスポンスのパース、ドキュメント化されたエラー挙動を安定したAPIインターフェースの背後で提供します。
Googleウェブ検索結果ページに対するリクエストロジック
対応範囲でのプロキシ対応の収集とリトライ対応の実行
利用不能な上流レスポンスに対する確認ページ対応処理
Playgroundでテスト済みのサンプル付き、正規化されたJSONレスポンス
ドキュメント化されたエンドポイントコストに基づくクレジット課金
Crawloraは利用不能な上流レスポンスを検知し、壊れたHTMLを黙って返す代わりにドキュメント化されたエラーを返します。
自社構築との比較
スクレイピングインフラを社内で維持するか、マネージドエンドポイントを呼び出すかの判断にご活用ください。
| 要件 | 自社構築 | Crawlora |
|---|---|---|
| プロキシローテーション | プロキシプールの購入・検証・ローテーション・監視を自前で行います。 | 対応範囲でマネージドなプロキシ対応の収集を利用できます。 |
| パーサーの保守 | Googleのページレイアウト変更に合わせてセレクタを保守し続けます。 | API背後で保守されるパーサーを利用できます。 |
| スキーマの正規化 | レスポンスモデルを自分で設計・バージョン管理します。 | カタログからドキュメント化されたJSONフィールドを受け取れます。 |
| リトライとエラー分類 | 確認ページ、空ページ、上流障害を自力で分類します。 | 利用不能な上流レスポンスに対しドキュメント化されたエラーを受け取れます。 |
| エンドポイントドキュメント | 社内APIドキュメントを自分で作成・保守します。 | 稼働中のエンドポイントカタログから生成されるDocsページを利用できます。 |
| Playgroundでのテスト | 開発者向けのテストコンソールを構築します。 | 同じエンドポイントを出荷前にPlaygroundでテストできます。 |
| 利用量課金 | メータリングと上限を自前で構築します。 | クレジットベースの利用量とプラン上限を利用できます。 |
| モニタリング | リクエスト量と障害のモニタリングをゼロから構築します。 | Crawloraのドキュメント化されたステータス・利用状況ワークフローを利用できます。 |
CrawloraはGoogleの公式Custom Search APIやProgrammable Search APIではありません。Crawloraは、対応する公開Google検索結果ページ向けの構造化Web公開データ抽出エンドポイントを提供します。Google公式の認可を受けた検索APIが必要なユースケースには、Google公式APIをご利用ください。
関連API
このエンドポイントを、関連するCrawloraの検索、モニタリング、ドキュメント、料金の各ページと組み合わせて活用できます。
GoogleとBingのSERPデータの露出を比較できます。
開くBraveサーチの結果をエンジン横断モニタリングワークフローに追加できます。
開くSERPトラッキングを検索需要とトレンド発見データと組み合わせられます。
開くキーワード順位、結果の変化、検索露出を追跡できます。
開く定期的な検索結果スナップショットに基づくキーワード追跡ダッシュボードを構築できます。
開くキーワード・URL・競合モニタリング用の定期SERPチェックを保存できます。
開く構造化されたGoogle結果のスナップショットでキーワード順位と順位URLを確認できます。
開く代理店やSaaSのSEOレポートの背後でCrawloraをデータレイヤーとして利用できます。
開くGoogle Searchのスクレイピング方法
Crawloraの/google/searchエンドポイントは、keyword、country、language、limit(結果件数の上限)、pageのパラメータを受け付けるPOSTリクエストで、Googleのウェブ検索結果ページを正規化JSONとして返します。順位・タイトル・URL・ドメイン・スニペットを含むオーガニック結果、関連検索キーワード、ページネーションメタデータが含まれます。リクエストはプロキシ経由のブラウザレンダラーを通じて実行され、複数のレンダリングを並行して競わせて最初に得られたクリーンな結果を返す仕組みで、古いキャッシュへのフォールバックも備えています。Googleの確認ページに遭遇した場合は、壊れたHTMLの代わりにドキュメント化されたエラーを返します。
/google/searchにJSONボディでPOSTリクエストを送ります:keyword、country(例:us)、language(en)、limit(ドキュメント記載の上限まで)、page。countryとlanguageはどのGoogleフロントエンドが応答するかを決めるため、順位トラッキングツールはキーワードごとにこの2つを固定し、デフォルト値に頼らないようにしてください。
各オーガニック結果にはposition、title、link、website_name(ドメイン)、スニペットが含まれます。positionはそのリージョンとページでGoogleが示す実際の順位そのものであり、これが順位トラッキングに必要なデータです。website_nameを自社ドメインと照合し、取得時刻のタイムスタンプ付きで順位を記録してください。
limitを維持したままpageを増やせば、最初のページ以降の結果を読み取れます。実行ごと・キーワードごと・ページごとに1件のレコードを保存すれば、複数回の実行間の比較は再パースではなく差分比較になります。
CrawloraのGET /google/news、/google/videosエンドポイント(q、country、langパラメータ)でニュースと動画のサービスを、/google/suggestでオートコンプリート候補を、/google/jobsで求人情報を取得できます。Bing、Brave、DuckDuckGoの検索エンドポイントも同じ構造のレスポンスを返すため、エンジン横断の露出比較はパスを変えるだけで同じコードを再利用できます。
FAQ
対応する公開検索結果ページ向けにCrawloraを評価している開発者向けの回答です。
はい。Crawloraは対応する公開Google検索結果ページ向けのGoogle Searchエンドポイントを提供し、ドキュメント化されたAPIルート経由で正規化JSONを返します。
はい。各レスポンスにはオーガニック結果の順位、タイトル、URL、スニペットが含まれるため、時間経過でキーワード順位を記録し、SERPの変化を検知できます。定期的なスナップショットをSERPモニタリングのユースケースと組み合わせれば、Googleの順位トラッカーを構築できます。
カタログの例には、順位、タイトル、URL、説明、ドメイン、ページネーションメタデータを含むオーガニック結果、Googleが提供する場合の関連検索キーワードが含まれます。
対応しています。Google Searchエンドポイントはkeyword、country、language、limit、pageを受け付けます。
Crawloraは利用不能な上流レスポンスを検知し、壊れたHTMLを黙って返す代わりにドキュメント化されたエラーを返します。エラー処理、リトライ、上流の可用性変化への対応は、各自の統合側で行ってください。
いいえ。CrawloraはGoogleの公式Custom Search APIやProgrammable Search APIではありません。Crawloraは、対応する公開Google検索結果ページ向けの構造化Web公開データ抽出エンドポイントを提供します。Google公式の認可を受けた検索APIが必要なユースケースには、Google公式APIをご利用ください。
keyword、country、language、limit、pageを指定してCrawloraの/google/searchエンドポイントにPOSTリクエストを送るだけです。レスポンスはその結果ページのJSON版で、position・title・link・ドメイン・スニペットを含むオーガニック結果、関連検索キーワード、ページネーションメタデータが含まれます。自前のプロキシ、ブラウザ、パーサーは不要です。
はい。各オーガニック結果のpositionは、リクエスト時点でそのキーワード・国・言語・ページに対してGoogleが示す実際の順位です。関連度で並べ替えたリストではなく文字どおりのSERPであるため、順位トラッキングやシェア・オブ・ボイス分析に適しています。
リクエストは複数のプロキシ経由ブラウザレンダリングを並行して競わせ、最初に得られたクリーンな結果を返します。古いキャッシュへのフォールバックも備えています。クリーンな結果が得られない場合、Crawloraは確認ページを結果として偽装する代わりにドキュメント化されたエラーコードを返し、その呼び出しは成功として課金されません。
はい。Crawloraの/google/news、/google/videos、/google/suggestエンドポイントはq、country、langを受け付けるGETリクエストで、/google/jobsはPOSTリクエストです。これらはウェブ検索と同じAPIキーとクレジットプールを共有します。
リサーチやモニタリング目的で公開されている検索結果ページを収集することは、Googleの利用規約、レート制限、適用法を遵守する限り一般的に許容されます。検索結果自体は公開されています。データは責任を持って利用し、大規模なスクレイピングの前に基本的な法的留意点を確認してください。
Playgroundで/google/searchをテストし、Docsで現在のレスポンススキーマを確認し、料金ページでクレジット利用量を比較できます。