website-screenshot

ウェブサイトスクリーンショット API

html2png.dev を使って、公開中の任意のウェブサイトのスクリーンショットを撮影します。

エンドポイント

POST https://html2png.dev/api/screenshot

リクエスト

curl -X POST "https://html2png.dev/api/screenshot" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "width": 1280, "fullPage": true}'

パラメーター

パラメーター	型	デフォルト	説明
url	string	必須	撮影するウェブサイトの URL
width	int	1280	ビューポートの幅
height	int	800	ビューポートの高さ
fullPage	bool	false	スクロール可能なページ全体を撮影
format	string	png	png、webp、pdf
deviceScaleFactor	float	2	Retina スケール（1～4）
delay	int	0	撮影前の待機時間（ミリ秒）
omitBackground	bool	false	背景を透過
colorScheme	string	-	ライトまたはダーク
userAgent	string	-	カスタムユーザーエージェント

レスポンス

{
  "success": true,
  "url": "https://html2png.dev/api/blob/screenshot-abc.png",
  "format": "png",
  "timestamp": "2025-01-27T10:30:00.000Z"
}

例

基本的なスクリーンショット

curl -X POST "https://html2png.dev/api/screenshot" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://github.com"}'

ページ全体の撮影

curl -X POST "https://html2png.dev/api/screenshot" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "fullPage": true, "delay": 2000}'

モバイルビューポート

curl -X POST "https://html2png.dev/api/screenshot" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "width": 375, "height": 812, "deviceScaleFactor": 3}'

PDF のエクスポート

curl -X POST "https://html2png.dev/api/screenshot" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "format": "pdf", "fullPage": true}'

ダークモード

curl -X POST "https://html2png.dev/api/screenshot" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "colorScheme": "dark"}'

JavaScript の例

const response = await fetch("https://html2png.dev/api/screenshot", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    url: "https://example.com",
    width: 1280,
    fullPage: true,
    delay: 1000,
  }),
});

const data = await response.json();
console.log(data.url);

ヒント

• JavaScript やアニメーションが多用されているサイトでは、delay を使用します
• fullPage はスクロール可能なコンテンツ全体を撮影します
• 鮮明なテキストを表示するには、deviceScaleFactor=2 以上を指定します
• キャッシュはありません。リクエストごとに最新のコンテンツを撮影します

レート制限

IP あたり毎時 50 リクエストです。