Endpoint
GET https://api.rasterwise.com/v1/get-screenshot
Use this endpoint to invoke the API and modify the request with the parameters below.
Required Parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
apikey |
string | Your secret API Key. This is required to authenticate your request. | ?apikey=5WjESjB72Rb2JC7frBf026kBgg82DaPQIOxc -Not an actual apikey- |
url |
string | URL of the website / page you want to screenshot. Should start with http:// or https:// | &url=https://google.com |
Format Parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
format |
string | The file type/format in which you want to get your capture. It can be either png or jpeg. Defaults to png |
&format=png |
pdf |
string | If set to true, any image format will be ignored and instead an A4 PDF of the passed website will be generated. Websites will render the same as if you were printing it from your browser. Defaults to false |
&pdf=true |
urlasfilename |
boolean | By default GetScreenshot return screenshots with a random filename. If this parameter is set to true, the resulting screenshot filename will contain the target screenshot URL. Defaults to false |
&urlasfilename=true |
filenameprefix |
string | Custom prefix for the screenshot filename. Dashes become path separators (e.g., project-2026 becomes project/2026/ in the storage path). |
&filenameprefix=myproject-screenshots |
Dimensions/Viewport Parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
height |
number | Height in pixels of the viewport when taking the page screenshot. Defaults to 800 |
&height=800 |
width |
number | Width in pixels of the viewport when taking the page screenshot. Defaults to 1280 |
&width=1200 |
fullpage |
boolean | If set to true, we will calculate the full height of the website and used it as the height in pixels of the viewport when taking the page screenshot. Any passed height value will be ignored. Defaults to false |
&fullpage=true |
preset |
string | If set, we will control the dimension and user-agent to simulate the preset device or graphics display resolution. If a preset value is passed, we will ignore other passed dimension parameters. This parameter can accept any of the following presets: iphone5 (iPhone 5) iphone678 (iPhone 6/7/8)iphone678_plus (iPhone 6/7/8 +)iphonex (iPhone X / XS)iphone12 (iPhone 12 / 13)pixel2 (Google Pixel 2)pixel2_xl (Google Pixel 2 XL)ipad (iPad in Vertical)ipadpro (iPad Pro Vertical)hvga (320 x 480)wvga (480 x 800)dvga (640 x 960)wxga_v (768 x 1280)xga (1024 x 768)wxga_s (1280 x 800)wxga_l (1366 x 768)sxga (1280 x 1024)wsxga_plus (1680 x 1050) |
&preset=dvga |
devicefactor |
number | Changes the device scale factor. If set to a higher value will result in a higher device pixel ratio. Defaults to 1 |
&devicefactor=2 |
noheight |
boolean | Allows fullpage parameter to overwrite preset height. This parameter is meant to be used with in combination with a preset and fullpage=true. Defaults to false. |
&noheight=true |
element |
string (CSS selector) | If you need to target specific DOM elements instead of taking dimension-based screenshots you can use the DOM capture parameters to target those elements. Pass DOM element selectors in CSS Selector fashion. For example. if targeting a div with the id colordiv you can target it by passing the parameter #colordiv. |
&element=#colordiv |
fullpagebyel |
string (CSS selector) | Use a specific element’s height as the full page height instead of calculating the entire document height. Useful when you want fullpage capture but only up to a certain element. | &fullpagebyel=#main-content |
Modified Rendering Parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
highlight |
string | A custom word or phrase you want to highlight. If passed, GetScreenshot will look for that string on the website and highlight all its instances with bright-yellow box. | &highlight=apple |
customjs |
string | A custom JS evaluation you want to inject before the capture. If passed we will inject this statement as a header | &customjs=alert("Injected JS"); |
customcss |
string | A custom CSS style you want to inject before the capture. If passed we will inject the style declaration as a header | &customcss=#demo {color: red } |
hidemsg |
boolean | If set to true, we will hide message, chat and customer support clients. Currently hides the following clients: Intercom, Drift, Facebook and Tawk (partiallly). Defaults to false |
&hidemsg=true |
hidecookie |
boolean | Hides cookie disclaimers that appear as floating boxes or fixed containers. The hiding is not guaranteed but has broad coverage and the underlying heuristic is updated weekly. Defaults to true. Set to false if you want cookie disclaimers to remain visible. |
&hidecookie=false |
hideelement |
string (CSS selector) | Allows you to hide a page element by passing its element selectors in CSS Selector fashion. For example. if you want to hide a div with the id “ad_div” you can do so by passing the parameter #ad_div. |
&hideelement=#ad_div |
forcetr |
boolean | If set to true, the website background will be forced to be transparent. Defaults to false |
&forcetr=true |
Pre-Screenshot Action and Browser Config Parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
click |
array (as string) | The click parameter will dispatch a click at the start of the rendering flow to the passed coordinates or dom element. For example if you need to click in the coordinates X = 20px and Y = 100px you can pass an array [20, 100. If you need to click on a button or element you can pass the selector of said element. | &click=[20,10] or &click=#demobtn |
cookie |
string | Allows you to set a cookie by passing it’s key and value in a comma separated fashion. | &cookie=session,31239e81293undb1db2hgr812gr |
scrollmotion |
boolean | Scrolls the page to trigger lazy-loaded content before capture. Defaults to true. Set to false for faster captures when lazy-loading isn’t needed. |
&scrollmotion=false |
API Result Workflow Parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
email |
string | A valid email address. If set, we will send a formatted email to this email address including the captured image and the details of the capture (capture time and URL). | &email=john@example.com |
emailsubject |
string | Custom subject line for the email notification. Only used when email parameter is set. |
&emailsubject=Daily%20Report |
emailmessage |
string | Custom message to include in the email body. Only used when email parameter is set. |
&emailmessage=Here%20is%20your%20screenshot |
webhook |
string | A valid endpoint URL that can receive and respond to a POST request (preferably an endpoint that you control). If set, we will send a POST request with the final response of the original call, to the provided endpoint (webhook listener). For your convenience, we send the response in the body and queryStringParameters of the request. |
&webhook=https://webhook.myapp.com |
Rendering Strategy Parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
strategy |
number | Changes the rendering strategy. Available values: 0 (default) - Standard clipped capture; 1 - CSS vh/vw unit normalization before capture, useful for responsive designs; 2 - Puppeteer’s native fullPage capture; 3 - Capture beyond viewport without expansion, fixes sites that hide images on viewport resize. Experiment with this parameter if the default strategy fails to produce an accurate screenshot. |
&strategy=1 |
timewait |
number | This parameter receives an extra time wait in ms. GetScreenshot goes through a rendering execution flow that optimizes for accuracy. To accomplish this, the execution flow introduces arbitrary waits that fix common rendering issues. However, there are instances in which an extra wait will be required to deliver a correct screenshot. In particular websites that perform some extended operation. To address this we make this parameter available so you can increase the wait period before taking the screenshot. We recommend starting at 5000 with 1000 increments. However be advised that our endpoint times out at 30 seconds, so using this parameter will increase the chances of your call timing out. Use this parameter with caution. Defaults to 2000 |
&timewait=5000 |
Browser Configuration Parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
waituntil |
string | Controls when navigation is considered complete. Available values: load - wait for load event; domcontentloaded - wait for DOMContentLoaded event; networkidle0 - wait until no network connections for 500ms; networkidle2 (default) - wait until no more than 2 network connections for 500ms. |
&waituntil=networkidle0 |
lang |
string | Sets the Accept-Language header for the request. Useful for capturing localized content. Defaults to en-US. |
&lang=es-ES |
Bypass Login Parameters
Note: Before using the bypass login functionality please have in mind that this is a highly experimental feature and its stability or reliability isn’t guaranteed.
Our bypass login strategy depends on instuction data that needs to be passed to the bplogin param as a URL encoded string. The instruction data needed is the following:
- Login Page URL
- Username (or email) needed to bypass the login.
- Password needed to bypass the login.
- Username Field CSS Selector
- Password CSS Selector
To pass this data you need to form an encoded comma separated string. For example an instruction like the following https://example.com/login,jj@example.com,24h3dnfbnkjbnf,input#user,input#password should ultimately be passed as https%3A%2F%2Fexample.com%2Flogin%2Cjj%40example.com%2C24h3dnfbnkjbnf%2Cinput%23user%2Cinput%23password.
Needless to say that this feature should be used carefully since you will be passing credentials for an online resource. Make sure that you understand the risks of revealing authentication data to any third party. Although your credentials are never logged into our systems and they only exist in memory for the duration of the screenshot process, we highly recommend that you only give us credentials that were created for the specific purpose of being handed to and used by GetScreenshot as part of your screenshot needs.
Please DO NOT pass credentials that are being used regularly by you or any other person in a day to day authentication context. If you insist on passing your personal credentials, please remember that GetScreenshot is not responsible for their misuse since we don’t control the whole end to end life cycle of your requests.
GetScreenshot will use the instruction data to authenticate against the protected website and then will navigate to the target URL to finish the screenshot operation.
If you have questions about this feature please don’t hesitate to contact us at support@rasterwise.com
| Parameter | Type | Description | Example |
|---|---|---|---|
bplogin |
URL Encoded String | An encoded comma separated string with login url, username, password, username field CSS selector, password field CSS selector | &bplogin=example.com%2Flogin%2Cjj%40example.com%2C24h3dnfbnkjbnf%2Cinput%23user%2Cinput%23password |
Bypass Login Instruction
NOTE: This guide is mostly tailored for Zapier Users
If you are a Zapier user you may not be entirely sure on how to form a bypass instruction. Don’t worry forming an instruction that can be used in the context of Zapier is quite simple.
If you need to bypass a login through Zapier you need to provide the following information in a comma separated format:
- Login Page URL
- Username (or email) needed to bypass the login.
- Password needed to bypass the login.
- Username Field CSS Selector
- Password CSS Selector
This will result in an instruction that looks similar to the following: https://example.com/login,jj@example.com,24h3dnfbnkjbnf,input#user,input#password.
Although the first three values (login url, username and password) are quite straight-forward you might not know what’s a CSS selector and how to get it. Fortunately CSS selectors are quite simple. CSS Selectors are identifiers that point to an element in a website UI. In this case you need to tell GetScreenshot the fields in which to enter the username and password you provided in the first two fields.
To obtain the CSS selectors you just need to do a small operation in your browser. Here is a quick YouTube video that explains how to do it: How to Get CSS Selector
When copying the CSS selector of the username field and password field, make sure you’re actually copying the selector of the actual form field. Most likely this would be a <input> element in both cases.
If you have any questions please reach out to support@rasterwise.com
AI Analysis Parameters
Note: AI analysis requires a JaxonAI plan subscription.
| Parameter | Type | Description | Example |
|---|---|---|---|
aiprompt |
string | An AI prompt to analyze the captured screenshot. The analysis result will be included in the response as aiAnalysis. Requires a JaxonAI plan. |
&aiprompt=Describe%20this%20webpage |
Response Format
A successful API call returns a JSON response with the following structure:
{
"status": "success",
"originUrl": "https://example.com",
"pageStatus": 200,
"captureDate": "2026/01/17",
"captureHour": "14:30:25",
"screenshotImage": "https://storage.googleapis.com/getscreenshot-storage/..."
}
Response Fields
| Field | Type | Description |
|---|---|---|
status |
string | "success" on successful capture |
originUrl |
string | The original URL that was captured |
pageStatus |
number | HTTP status code returned by the target page |
captureDate |
string | Date of capture in YYYY/MM/DD format |
captureHour |
string | Time of capture in HH:MM:SS format |
screenshotImage |
string | URL to the captured screenshot image |
pdfFile |
string | URL to the generated PDF (only present when pdf=true) |
aiAnalysis |
string | AI analysis result (only present when aiprompt is provided and plan supports it) |
Error Responses
When an error occurs, the API returns a JSON response with error details:
| HTTP Code | Description |
|---|---|
| 400 | Invalid URL format - The provided URL is malformed or missing required protocol (http/https) |
| 403 | Blocked URL - URL shorteners and certain domains are not allowed |
| 500 | Capture failed - The target page was unreachable or an internal error occurred |
Error Response Format
{
"status": "error",
"message": "Description of what went wrong"
}
Webhook Payload
When you provide a webhook parameter, GetScreenshot sends a POST request to your endpoint with the capture results. The response data is sent in both the request body and as query string parameters for flexibility.
Webhook Request Format
- Method: POST
- Content-Type: application/json
- Body: Same JSON structure as the standard response
- Query Parameters: Same fields as the response body
Example Webhook Payload
{
"status": "success",
"originUrl": "https://example.com",
"pageStatus": 200,
"captureDate": "2026/01/17",
"captureHour": "14:30:25",
"screenshotImage": "https://storage.googleapis.com/getscreenshot-storage/..."
}
Your webhook endpoint should return a 2xx status code to acknowledge receipt of the payload.
