Webpage Screenshot Capture
Capture a webpage screenshot and return its image URL
Bestseller
Webpage Screenshot Image Generation
Webpage to Image Rendering
Render a webpage as an image with configurable viewport settings
What can this API do?
Support capturing screenshots from any publicly accessible webpage
Use this capability when your Webpage to Image Rendering workflow needs the supported option without custom handling in your own application.
Flexible image dimensions with customizable width and height
This Webpage to Image Rendering feature is available through the documented endpoint and can be used in application, automation, or data workflows.
Full page capture or viewport-only screenshot options
This Webpage to Image Rendering feature is available through the documented endpoint and can be used in application, automation, or data workflows.
Mobile device simulation for responsive design testing
This Webpage to Image Rendering feature is available through the documented endpoint and can be used in application, automation, or data workflows.
Dark mode support for modern websites
This Webpage to Image Rendering feature is available through the documented endpoint and can be used in application, automation, or data workflows.
High-DPI rendering with device scale factor up to 4x
This Webpage to Image Rendering feature is available through the documented endpoint and can be used in application, automation, or data workflows.
Full API support for HTTPS (TLS v1.0 / v1.1 / v1.2 / v1.3)
Use this integration capability when exposing results to production applications, internal tools, or customer-facing workflows.
Fully compatible with Apple ATS
This Webpage to Image Rendering feature is available through the documented endpoint and can be used in application, automation, or data workflows.
Nationwide multi-node CDN deployment
Use this integration capability when exposing results to production applications, internal tools, or customer-facing workflows.
Ultra-fast response, API interface load balancing built with multiple servers
The Webpage to Image Rendering response exposes this data in a documented format for storage, display, validation, and downstream processing.
Annual plan
$49$99
Try it for free!
Sign In Sign in to get a trial key and test all APIs.
Secure checkout powered by Stripe
API Document
HTTP Protocol:HTTPS
HTTP Method:GET
HTTP Endpoint:https://api.gugudata.io/v1/websitetools/url2image
Response Type:application/json; charset=utf-8
DEMO Endpoint:https://api.gugudata.io/v1/websitetools/url2image/demo
Live Demo:Try Interactive Demo
Full API Docs:developers.gugudata.io
API Request Parameters
| Name | Type | Is Required | Default Value | Remark |
|---|---|---|---|---|
| appkey | string | true | YOUR_APPKEY | Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type. |
| url | string | true | Target webpage URL. | |
| isFullPage | boolean | false | false | Whether the renderer should capture the full page height. |
| width | integer | false | 250 | Output width in pixels. |
| height | integer | false | 250 | Output height in pixels. |
| viewportWidth | integer | false | 1080 | Viewport width in pixels used during page rendering. |
| viewportHeight | integer | false | 1080 | Viewport height in pixels used during page rendering. |
| forceReload | boolean | false | false | Whether the renderer should bypass cached page content before capture. |
| isMobile | boolean | false | false | Whether the renderer should emulate a mobile device viewport. |
| isDarkMode | boolean | false | false | Whether the renderer should emulate dark mode when rendering the target page. |
| deviceScaleFactor | integer | false | 1 | Device scale factor used during page rendering. |
API Response Parameters
| Name | Type | Remark |
|---|---|---|
| image | binary | Rendered image binary stream returned on success. On failure, the endpoint returns a JSON error payload instead of binary content. |
API Response Status Codes
| Status Code | Explanation of Status Code | Remarks |
|---|---|---|
| 200 | Request processed successfully. | Some endpoints expose a separate application-level status field in the response body, such as `dataStatus.statusCode`. |
| 400 | Invalid request parameters or request format. | Check required fields, data types, and request body format. |
| 401 | Missing or unknown application key. | Provide a valid `appkey` with the request. |
| 403 | The application key is recognized but access is not allowed. | The key may be expired, inactive, or not permitted for the requested API. |
| 429 | Request rate or trial usage limit exceeded. | Reduce concurrency or retry after the limit window resets. |
| 500 | Internal service error. | Retry later or contact support if the error persists. |
| 503 | Upstream service unavailable. | Retry later; the requested upstream dependency is temporarily unavailable. |
Remote MCP
AI client access
Use this API through GuGuData Remote MCP
Connect your AI client once, authorize in the browser, and the client can use the GuGuData API tools available to your account. You do not need to paste an appkey into the MCP client.
Endpoint
https://mcp.gugudata.io/mcpGeneric MCP configuration
{
"mcpServers": {
"gugudata": {
"url": "https://mcp.gugudata.io/mcp",
"transportType": "streamable-http"
}
}
}Code Snippets
Convert Webpage to Markdown
Convert a webpage into clean Markdown for content pipelines
URL to Static HTML Converter
Capture a webpage as static HTML for archiving or processing
HTML/URL to PDF
Convert HTML or a public webpage into a downloadable PDF