Html2Image is perfect for converting any html pages into a picture.
API Status
Loading...
Sign up
Sign up, it's free. Get today your personal API key
Create your free account
Get your personal API key instantly. No credit card required.
Create AccountAlready have an account? Login here
API Documentation
Our API is easy, fast, and powerful!
Base URL
https://www.html2image.net/api/api.php?Required Parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
key | string | Your personal API key | key=abc123 |
source | string | URL of the page OR HTML code via POST | source=https://example.com |
type | string | Output format: png, jpg, gif, svg, pdf | type=png |
Source Options
You can provide content in two ways:
Option 1: URL (GET)
GET /api/api.php?key=[YOUR_KEY]&source=https://example.com&type=pngOption 2: HTML via POST NEW!
Send HTML directly for dynamic content generation:
POST /api/api.php?key=[YOUR_KEY]&type=svg
Content-Type: application/x-www-form-urlencoded
source=<html><body><h1>Hello World</h1></body></html>Basic Options
| Parameter | Type | Description | Range |
|---|---|---|---|
width | int | Width in pixels | 1-4096 |
height | int | Height in pixels | 1-4096 |
quality | int | Quality (JPG only) | 1-100 |
zoom | float | Zoom factor | 0.1-5.0 |
Rendering Options NEW!
| Parameter | Type | Description | Values |
|---|---|---|---|
delay | int | JavaScript wait time (ms) | 0-30000 |
fullpage | bool | Capture entire page | true/false |
transparent | bool | Transparent background (PNG) | true/false |
grayscale | bool | Grayscale image | true/false |
Examples
Basic Screenshot
https://www.html2image.net/api/api.php?key=[YOUR_KEY]&source=https://example.com&type=pngFull Page with Custom Width
https://www.html2image.net/api/api.php?key=[YOUR_KEY]&source=https://example.com&type=png&fullpage=true&width=1200High Quality JPG
https://www.html2image.net/api/api.php?key=[YOUR_KEY]&source=https://example.com&type=jpg&quality=95&width=1920Success Response
{
"Status": "OK",
"Link": "https://www.html2image.net/api/tmp/.../image.png",
"Expires": "2024-12-24T15:30:00+01:00"
}Error Response NEW!
When rendering fails, you get a detailed error response with codes and hints:
{
"Status": "Error",
"Message": "Error creating image. Please check your parameters.",
"ErrorCode": "FONT_LOAD_ERROR,NETWORK_ERROR",
"Details": "Google Fonts could not be loaded (HTTP 400)",
"Warnings": ["Failed to load optional resource"],
"Hints": ["Check your Google Fonts URL syntax"]
}Error Codes
| Code | Description |
|---|---|
FONT_LOAD_ERROR | Google Fonts or custom fonts failed to load |
RESOURCE_NOT_FOUND | Image or resource not found |
NETWORK_ERROR | Network error during rendering |
SSL_ERROR | SSL/TLS certificate error |
TIMEOUT_ERROR | Request timed out |
DNS_ERROR | Domain could not be resolved |
HTTP Status Codes
| 200 | Success |
| 400 | Invalid parameters |
| 401 | Invalid API key |
| 429 | Rate limit exceeded |
| 500 | Server error |