Documentation
URL Parameter
The url
parameter is required for the Screenshot API and specifies which webpage to capture.
Specifications
Property | Value |
---|---|
Type | string |
Required | Yes |
Default | None |
API | Screenshot API only |
Description
The URL of the webpage you want to screenshot. The URL must be:
- Publicly accessible
- A valid URL with protocol (http:// or https://)
- Responsive within a reasonable timeout period
We strongly recommend using the webhook_url
parameter with URL screenshots, as page load times can be unpredictable and may exceed the 30-second timeout limit.
Examples
Basic URL Screenshot
{
"url": "https://example.com"
}
Response:
{
"success": true,
"credits_remaining": 95,
"id": "abc123",
"url": "https://i.html2img.com/abc123.png"
}
URL with Query Parameters
{
"url": "https://example.com/search?q=test&page=1"
}
URL with Specific Viewport
{
"url": "https://example.com",
"width": 1920,
"height": 1080
}
Some websites may block or behave differently when accessed by our service. Ensure the target website:
- Doesn’t require authentication
- Allows automated access
- Is publicly accessible