The GrabzIt JavaScript API allows you to customize your screenshots and captures by specifying different parameters. Just select what you want to do from the filter below and the available parameters will be displayed, all of which are optional.
format - the format the screenshot/capture should be in.
Default: jpg
Options:
bmp8
bmp16
bmp24
bmp
csv
CSV files are automatically downloaded.
gif
html
HTML files are automatically downloaded.
jpg
json
JSON files are automatically downloaded.
pdf
PDF files are automatically downloaded.
docx
DOCX files are automatically downloaded.
png
seo
tiff
mp4
webp
xlsx
XLSX files are automatically downloaded.
address - the URL to execute the HTML code in. Can be useful if the HTML being converted uses relative URL's to resources such as CSS and images.
Default: empty
background - if true the background of the web page should be included in the PDF
Default: 1
Options:
0 = indicates the PDF document should not include the web page background
1 = indicates the PDF document should include the web page background
background - if true the background images of the web page should be included in the DOCX
Default: 1
Options:
0 = indicates the DOCX document should not include the web page background images
1 = indicates the DOCX document should include the web page background images
bwidth - the width of the browser in pixels
Default: 1366
Maximum: 10000
Auto Width: -1 (passing -1 means that the width of the browser matches the width of the document)
bheight - the height of the browser in pixels.
Default: 1170
Maximum: 10000
Full Length: -1 (passing -1 means that a sceenshot of the whole web page is taken)
cache - this parameter specifies if the screenshot/capture should be cached or not
Default: 1
Options:
0 = indicates it will not be cached
1 = indicates it will be cached
cachelength - this parameter specifies the length of time a screenshot/capture should be cached for in minutes
download - this parameter specifies if the capture should downloaded or shown in the web page
Default: 0
Options:
0 = indicates the capture will be shown in the web page
1 = indicates the capture will be automatically downloaded
duration - the length in seconds of the video that should be converted into a animated GIF.
Default: maximum length for package
duration - the length in seconds of the web page should be recorded for.
Default: 10
Maximum: 30
encryption - the encryption key to use to encrypt the capture with. If you are creating the key in JavaScript it is recommended that you use the encrypt method instead as shown in this example.
height - the height of the resulting thumbnail in pixels
Default: if both the output width and output height are not specified or 0 then the output width and height will match the final image width and height, if the output width is specified the output height will be proportional to the output width
Maximum: Maximum height for package
Full Height: -1 (passing -1 means that the height of the thumbnail is not reduced)
height - the height of the resulting video in pixels
Default: if not set it will match the browser height
Full Length: -1 (passing -1 means that the page height is equal to the web page)
height - the height of the resulting animated GIF in pixels.
Default: 120px
Maximum: Maximum height for package
Auto-size: -1 (passing -1 means that the height of the animated GIF is scaled in relation to its width, if the height is being auto-sized the width cannot)
hide - the CSS selectors of the one or more HTML elements in the web page to hide, to specify multiple HTML elements to hide seperate each selector with a comma.
Default: empty
includealltables - if true all table on the web page will be extracted with each table appearing in a separate spreadsheet sheet.
Only available with the XLSX format
Default: 0
Options:
0 = indicates all the tables will not be extracted
1 = indicates all the tables will be extracted
includeheadernames - if true header names will be included in the table
Default: 1
Options:
0 = indicates the header names will not be include in the table
1 = indicates the header names will be include in the table
includeimages - if true the images of the web page should be included in the DOCX
Default: 1
Options:
0 = indicates the DOCX document will not include web page images
1 = indicates the DOCX document will include web page images
includelinks - true if links should be included in the document
Default: 1
Options:
0 = indicates the document should not include links
1 = indicates the document should inlcude links
includeoutline - true if PDF bookmarks should be included
Default: 0
Options:
0 = indicates the PDF document will not include a outline
1 = indicates the PDF document will include a outline
proxy - the HTTP proxy details the browser software should use to use to create this capture
post - any post parameters you want to send. It is recommended that you use the AddPostVariable method instead as this ensures the parameters are properly encoded.
quality - the quality of the capture, JPG and WEBP have a default compression of 90% and GIF 85%. This parameter has no effect on BMP, PNG or TIFF images.
Reducing the quality will reduce the filesize and reduce download times.
Default: -1
Minimum: -1
Maximum: 100
repeat - number of times to loop the animated GIF.
Default: 0
Loop Continuously: 0
Never Loop: -1
reverse - if true the frames of the animated GIF are reversed
Default: 0
Options:
0 = indicates the animation will not be reveresed
1 = indicates the animation will be reversed
requestas - the type of user agent you wish to use
Default: 0
Options:
0 = indicates the standard version of the website should be returned
1 = indicates the mobile version of a website should be returned
2 = indicates the search engine view of a website should be returned
speed - the speed of the animated GIF.
Default: 1
Minimum: 0.2
Maximum: 10
start - the starting position of the video that should be converted into a animated GIF.
Default: 0 seconds
start - the starting time in seconds after loading that the video should be captured from.
Default: 0 seconds
suppresserrors - suppresses error reporting
Only valid where the screenshot result is being downloaded
Default: 0
Options:
0 = shows any errors
1 = hides any errors
tabletoinclude - the index of the table to be converted, were all tables in a web page are ordered from the top of the web page to bottom
Default: 1
target - this parameter specifies the CSS selector of the only HTML element on the target web page that is to be turned into a document, all other parts of the web page are ignored. If there are multiple matching HTML elements the first one is chosen.
Default: empty
target - this parameter specifies the CSS selector of the only HTML element on the target web page that is to be turned into a image, all other parts of the web page are ignored. If there are multiple matching HTML elements the first one is chosen.
Default: empty
target - the id of the only HTML element in the web page that should be used to extract tables from
templateid - add a template ID that specifies the header and footer of the document
Default: empty
title - provide a title to the PDF document
Default: empty
waitfor - this specifies the HTML element, using a CSS selector. Once the element is visible the capture is executed. If there are multiple matching HTML elements the first one is chosen. When this parameter is used it will wait for a maximum of 25 seconds before the capture is performed.
width - the width of the resulting thumbnail in pixels
Default: if both the output width and output height are not specified or 0 then the output width and height will match the final image width and height, if the output height is specified the output width will be proportional to the output height
Maximum: Maximum width for package
Full Width: -1 (passing -1 means that the width of the thumbnail is not reduced)
width - the width of the resulting video in pixels
Default: if not set it will match the browser width
width - the width of the resulting animated GIF in pixels.
Default: 180px
Maximum: Maximum width for package
Auto-size: -1 (passing -1 means that the width of the animated GIF is scaled in relation to its height, if the width is being auto-sized the height cannot)