웹페이지
스크린샷 API

공개 URL을 PNG·JPEG로 캡처합니다.
JS/TS·Python SDK와 MCP로 연결하세요.

URL과 캡처 옵션을 보내면 작업 ID를 반환합니다.

POST /v1/screenshots

{
  "url": "https://example.com",
  "format": "png",
  "viewport": {
    "width": 1280, "height": 720
  }
}

API 키와 Idempotency-Key를 헤더에 함께 보냅니다.

서버의 Chromium이 페이지를 열고 JavaScript를 실행합니다. 작업 ID로 처리 상태를 조회합니다.

GET /v1/screenshots/{id}

{
  "id": "…",
  "status": "running"
}

최초 응답의 202는 요청이 접수됐다는 뜻입니다. 캡처 완료 여부는 status로 확인합니다.

지정한 화면 영역이나 전체 페이지를 이미지로 저장합니다.

status: succeeded

{
  "status": "succeeded",
  "result": {
    "width": 1280, "height": 720,
    "format": "png"
  }
}

다운로드 URL을 발급받아 이미지 파일을 가져옵니다.

POST /v1/screenshots/{id}/download-url

{
  "url": "https://…/signed-image"
}

코드와 AI 도구에서 연결