ページ全体、ビューポート、要素を取得する Screenshot API
公開 Web ページを PNG、JPEG、WebP に変換し、キャプチャ範囲、ビューポート、ページ準備状態、配色を明示的に制御できます。
エンドポイント
公開 Web ページを画像に変換し、形式、ビューポート、ページ状態、キャプチャ範囲を明示的に制御できます。
ページを上から下まで取得。
CSS セレクターで表示中の要素を取得。
ビューポート、DPR、待機、配色を指定。
活用例
サイトプレビュー / 視覚テスト素材 / Agent vision
ワークフローに必要なページ状態を取得
Screenshot endpoint は公開 HTTP / HTTPS URL を 1 つ受け取り、画像本体を直接返します。フルページまたは要素キャプチャを選び、ビューポート、DPR、ページ読み込み、表示セレクター待機を設定できます。
ページ全体または特定要素
ドキュメント全体、または CSS セレクターで指定した可視要素を取得します。
レスポンシブレンダリング
ビューポートの幅と高さ、1–2× のデバイススケール係数を設定できます。
ページ準備の制御
load、network idle、指定要素の表示、追加の待機時間を選べます。
画像出力の制御
PNG、JPEG、WebP、品質、ライト・ダーク配色、背景、アニメーション動作を指定できます。
Screenshot API とは？
Screenshot API は、管理されたブラウザで Web ページを開き、レンダリング済み画像を返す API です。独自の Chromium 基盤を運用せず、動的ページを画像化できます。Search1API は PNG・JPEG・WebP、フルページまたは CSS セレクター、ビューポートと DPR、ページ待機、タイムアウト、配色、背景、アニメーション制御に対応します。
基本フロー
公開 Web ページを PNG、JPEG、WebP に変換し、キャプチャ範囲、ビューポート、ページ準備状態、配色を明示的に制御できます。
公開 URL と出力形式、キャプチャ設定を送信します。
サービスが管理ブラウザでページを描画し、指定状態まで待機します。
画像バイナリを受け取り、アプリ側で比較、保存、解析します。
主な用途
公開 Web ページを PNG、JPEG、WebP 画像に変換します。
URL からサイトのサムネイルやリンクプレビューを生成。
外部の画像比較システム向けに基準画像と比較画像を生成。
Vision model や agent に渡す Web ページ画像を準備。
FAQ
Screenshot API の対応形式は？
PNG、JPEG、WebP に対応します。JPEG と WebP は 1〜100 の quality を指定できます。
ページ内の 1 要素だけ取得できますか？
はい。CSS セレクターを指定して表示中の 1 要素を取得できます。要素キャプチャとフルページは同時に指定できません。
ページ待機はどのように指定しますか？
DOM、load、network idle を待機でき、表示中の CSS セレクター待機や最大 5 秒の追加遅延も設定できます。タイムアウトは 1〜30 秒です。
Screenshot API のクレジット消費は？
成功した Screenshot API リクエストは 2 クレジットです。失敗したリクエストは課金されません。