[DEMO] Website Snapshot

Convert URL to Snapshot
Capture high-quality webpage screenshots with optional CDN hosting via Cloudflare R2

Method: POST
Path: /v1/websitetools/url2snapshot?appkey={{appkey}}
Demo: https://api.gugudata.io/v1/websitetools/url2snapshot/demo

Request Parameters:

appkey (string, required): Obtained after payment

url (string, required): The webpage URL to capture

responseFormat (string, optional): Return format: base64 (default) or url for CDN image link

fullPage (boolean, optional): Whether to capture the entire page

width (integer, optional): Viewport width in pixels

height (integer, optional): Viewport height in pixels

deviceScaleFactor (integer, optional): Device scale factor for HiDPI rendering (1-4)

userAgent (string, optional): Custom user agent string for rendering

isMobile (boolean, optional): Whether to emulate a mobile device

Response Fields Count: 10
Response Field Examples:

dataStatus: Response status information

dataStatus.statusCode: HTTP status code

dataStatus.status: Response status

dataStatus.statusDescription: Status description

dataStatus.responseDateTime: Response timestamp

dataStatus.dataTotalCount: Data count

dataStatus.requestParameter: Logged request parameters

data: Snapshot result data

... total 10 fields

Key Features:

Capture full-page or viewport screenshots from any public URL

Optional CDN hosting on Cloudflare R2 with secure HTTPS URLs

Customizable viewport size, scale factor, and user agent

Supports desktop and mobile rendering modes

Best-effort capture using Cloudflare browser rendering

Details:
https://gugudata.io/details/url2snapshot

Responses

⚪0

application/json

Body

Example

{
  "dataStatus": {
    "statusCode": 0,
    "status": "string",
    "statusDescription": "string",
    "responseDateTime": "string",
    "dataTotalCount": 0,
    "requestParameter": "string"
  },
  "data": {
    "image": "string",
    "content": "string"
  },
  "DataStatus": {
    "StatusCode": 100,
    "StatusDescription": "OK",
    "ResponseDateTime": "2026-01-01 00:00:00",
    "DataTotalCount": 1
  }
}

Request

Request Code Samples

Responses