Screenshot API

スクリーンショットAPIは、HTTPリクエストでURLと撮影のオプションを受け取り、自社のサーバー上のブラウザでページを読み込んで、画像またはPDFとして結果を返すWebサービスです。アプリケーションは、ブラウザを自分でインストールまたは実行せずに、コードからスクリーンショットを要求できます。

多くのサービスは、APIキーでリクエストを認証し、撮影の回数に応じて課金します。機能、上限、料金はプロバイダーごとに異なり、時間とともに変わるため、各プロバイダーのドキュメントで比較してください。

スクリーンショットAPIの仕組み

1. クライアントは、URLと、ビューポートの幅と高さ、ビューポートまたはフルページの範囲、デバイススケールファクター、形式、遅延、待機条件などのオプションを含むリクエストを送信します。
2. サービスは、多くの場合PlaywrightまたはPuppeteerで操作されるヘッドレスブラウザでURLを開きます。
3. ページの読み込みを待ち、クッキーバナーや広告を非表示にするなどのオプションを適用してから撮影します。
4. 画像を直接返すか、保存してリンクを返します。

スクリーンショットAPIの用途

• 要求に応じて生成される、リンクのプレビューやSNSのカード画像。
• ディレクトリやCMSツールで、ユーザーが投稿したURLのサムネイル。
• 記録のための、ページのアーカイブコピー。
• 時間をかけてページを比較する、定期的なチェック。

ホスト型とセルフホスト型

ホスト型のAPIは、ブラウザの保守、スケーリング、更新を不要にします。その代わりに、URLと画像は第三者を経由します。また、ページはプロバイダーのネットワークと地域から読み込まれるため、ログイン、VPN、地域制限の背後にあるコンテンツは変わることがあります。PlaywrightまたはPuppeteerを使ったセルフホスト型では、データを自社のインフラに残せますが、ブラウザ、キュー、再試行を運用する必要があります。

スクリーンショットAPIでよくある間違い

• セッションのデータを渡さず、ログインが必要なページを撮影する。
• 待機条件を設定せず、読み込みが途中のページが返される。
• 非公開または社内のURLを、第三者のサービスに送信する。
• 大量の処理で、レート制限とタイムアウトを無視する。

同じスクリーンショットを繰り返し撮りますか？

Temposhotの Website Capture は、入力したURLを、お使いのMac上で管理されたローカルブラウザで読み込み、ファイルをローカルに保存します。HTTPサービスとしてではなく、アプリから実行されます。詳しくは Webサイトのスクリーンショット自動化 をご覧ください。

よくある質問

スクリーンショットAPIを使うにはコードを書く必要がありますか？

はい。少なくとも、スクリプトまたは自動化ツールからのリクエストは必要です。

スクリーンショットAPIでログインの背後にあるページを撮影できますか？

そのためのクッキーやヘッダーを受け付けるサービスもあります。プロバイダーのドキュメントとサイトの利用規約を確認してください。

出典

• Headless browser（Wikipedia）
• Playwright screenshots guide

関連リソース

• Website Captureのクイックスタート: URLのリストをローカルで撮影します。
• Website Captureのオプション: 待機条件とクッキーバナーの扱い。
• 実行と結果: 再試行と部分的なセッション。