GrabzIt Client with Python

Description

This class handles all communication with the GrabzIt screenshot web services.

Public Methods

• GetResult(id)
• URLToAnimation(url, options = None)
• URLToImage(url, options = None)
• HTMLToImage(html, options = None)
• FileToImage(path, options = None)
• URLToPDF(url, options = None)
• HTMLToPDF(html, options = None)
• FileToPDF(path, options = None)
• URLToDOCX(url, options = None)
• HTMLToDOCX(html, options = None)
• FileToDOCX(path, options = None)
• URLToTable(url, options = None)
• HTMLToTable(html, options = None)
• FileToTable(path, options = None)
• URLToRenderedHTML(url, options = None)
• HTMLToRenderedHTML(html, options = None)
• FileToRenderedHTML(path, options = None)
• Save(callBackURL = '')
• SaveTo()
• SaveTo(saveToFile)
• GetStatus(id)
• GetCookies(domain)
• SetCookie(name, domain, value = "", path = "/", httponly = False, expires = "")
• DeleteCookie(name, domain)
• GetWaterMarks()
• GetWaterMark(identifier)
• AddWaterMark(identifier, path, xpos, ypos)
• DeleteWaterMark(identifier)
• SetLocalProxy(proxyUrl)
• UseSSL(value)
• CreateEncryptionKey()
• Decrypt(path, key)
• DecryptFile(path, key)

GetResult(id)

This method returns the screenshot itself. If nothing is returned then something has gone wrong or the screenshot is not ready yet.

Parameters

• id - the unique identifier of the screenshot
  • Required

Return Value

The capture

URLToAnimation(url, options = None)

Specifiy the URL of the online video that should be converted into a animated GIF.

Parameters

• url - the URL of the online video to convert into an animated GIF.
  • Required
  • Accepts Vimeo and YouTube video URL's
    • Warning animating Vimeo and YouTube videos depends on a third party and so may not provide consistent results.
• options - a instance of the GrabzItAnimationOptions class that defines any special options to use when creating the animated GIF.

Return Value

void

GrabzItAnimationOptions

The class represents all of the options available when creating an animated GIF.

Attributes

• customId - custom identifier that you can pass through to the animated GIF web service. This will be returned with the callback URL you have specified.
  • Default: empty
• 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)
• 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)
• start - the starting position of the video that should be converted into a animated GIF.
  • Default: 0 seconds
• duration - the length in seconds of the video that should be converted into a animated GIF.
  • Default: maximum length for package
• speed - the speed of the animated GIF.
  • Default: 1
  • Minimum: 0.2
  • Maximum: 10
• framesPerSecond - the number of frames per second that should be captured from the video.
  • Default: 10
  • Minimum: 0.2
  • Maximum: 60
• repeat - number of times to loop the animated GIF.
  • Default: 0
  • Loop Continuously: 0
• reverse - if true the frames of the animated GIF are reversed
  • Default: false
• customWaterMarkId - add custom watermark to the animated GIF
  • Default: empty
• quality - the quality of the returned image, which has a default compression of 85%.
  • Reducing the quality will reduce the filesize and reduce download times.
  • Default: -1
  • Minimum: -1
  • Maximum: 100
• country - the country the animated GIF should be taken from.
  • Warning this feature is currently in beta and may not provide consistent results.
  • Default: The current fastest location
  • Options: "SG", "UK", "US"
• exportURL - the export URL that specifies where the capture should be exported too
  • Default: empty
• encryptionKey - the if a base 64 encoded AES encryption key is specified your capture is encrypted when it is created. It is recommended to use the create encryption key method to create the key and the decrypt methods to decrypt the encrypted capture as shown in this example.
  • Default: empty
• proxy - the HTTP proxy details the browser software should use to use to create this capture
  • Default: empty

URLToImage(url, options = None)

Specifies the URL that should be converted into a image screenshot.

Parameters

• url - the URL that the screenshot should be made of
  • Required
• options - a instance of the GrabzItImageOptions class that defines any special options to use when creating the screenshot.

Return Value

void

HTMLToImage(html, options = None)

Specifies the HTML that should be converted into a image.

Parameters

• html - the HTML to convert into a image
  • Required
• options - a instance of the GrabzItImageOptions class that defines any special options to use when creating an image.

Return Value

void

FileToImage(path, options = None)

Specifies a HTML file that should be converted into a image.

Parameters

• path - the file path of a HTML file to convert into a image
  • Required
• options - a instance of the GrabzItImageOptions class that defines any special options to use when creating an image.

Return Value

void

GrabzItImageOptions

The class represents all of the options available when creating image captures.

Attributes

• customId - custom identifier that you can pass through to the screenshot webservice. This will be returned with the callback URL you have specified.
  • Default: empty
• browserWidth - the width of the browser in pixels
  • Default: 1024
  • Maximum: 10000
• browserHeight - the height of the browser in pixels
  • Default: 768
  • Maximum: 10000
  • Full Length: -1 (passing -1 means that a sceenshot of the whole web page is taken)
• width - the width of the resulting thumbnail in pixels
  • Default: The highest ratio of the browser width possible that fits within the maximum width for the users package
  • Maximum: Maximum width for package
  • Full Width: -1 (passing -1 means that the width of the thumbnail is not reduced)
• height - the height of the resulting thumbnail in pixels
  • Default: The highest ratio of the browser height possible that fits within the maximum height for the users package
  • Maximum: Maximum height for package
  • Full Height: -1 (passing -1 means that the height of the thumbnail is not reduced)
• format - the format the screenshot should be in.
  • Default: "jpg"
  • Options: "bmp8", "bmp16", "bmp24", "bmp", "tiff", "webp", "jpg", "png"
• delay - the number of milliseconds to wait before taking the screenshot
  • Default: 0
  • Maximum: 30000
• targetElement - the id or class CSS selector of the only HTML element on the target web page that is to be turned into a screenshot, all other parts of the web page are ignored. If there are multiple matching HTML elements the first one is chosen
  • Default: empty
• hideElement - the id or class 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
• waitForElement - the id or class CSS selectors of the HTML element in the web page that must be visible before the capture is performed
  • Default: empty
• requestAs - the type of user agent you wish to use
  • Default: 0
  • Options:
    • 0 = indicates the user agent of a standard browser should be used
    • 1 = indicates the user agent of a mobile browser should be used
    • 2 = indicates the user agent of a search engine should be used
    • 3 = indicates the user agent of a basic browser should be used
• customWaterMarkId - add a custom watermark to the image
  • Default: empty
• quality - the quality of the returned image. This currently only effects JPG images, which has a default compression of 85%.
  • Reducing the quality will reduce the filesize and reduce download times.
  • Default: -1
  • Minimum: -1
  • Maximum: 100
• transparent - if true the image capture should be transparent. This is only compatible with png and tiff images.
  • Default: false
• hd - if true the image capture will be in high definition this doubles the size of the image dimensions.
  • Default: false
• country - the country the screenshot should be taken from.
  • Warning this feature is currently in beta and may not provide consistent results.
  • Default: The current fastest location
  • Options: "SG", "UK", "US"
• exportURL - the export URL that specifies where the capture should be exported too
  • Default: empty
• encryptionKey - the if a base 64 encoded AES encryption key is specified your capture is encrypted when it is created. It is recommended to use the create encryption key method to create the key and the decrypt methods to decrypt the encrypted capture as shown in this example.
  • Default: empty
• noAds - if true adverts should be automatically hidden.
  • Default: false
• noCookieNotifications - if true all commonly found cookie notifications should be automatically hidden.
  • Default: false
• address - the URL to execute the HTML code in. Can be useful if the HTML being converted uses relative URL's for resources such as CSS and images.
  • Default: empty
• proxy - the HTTP proxy details the browser software should use to use to create this capture
  • Default: empty

Methods

• AddPostParameter(name, value) - defines a HTTP Post parameter and optionally value, this method can be called multiple times to add multiple parameters. Using this method will force GrabzIt to perform a HTTP post.
  • name - the name of the HTTP Post parameter
  • value - the value of the HTTP Post parameter

URLToRenderedHTML(url, options = None)

Specifies the URL that should be converted into rendered HTML.

Parameters

• url - the URL that the rendered HTML should be made of
  • Required
• options - a instance of the GrabzItHTMLOptions class that defines any special options to use when creating the rendered HTML.

Return Value

void

HTMLToRenderedHTML(html, options = None)

Specifies the HTML that should be converted into rendered HTML.

Parameters

• html - the HTML to convert into rendered HTML
  • Required
• options - a instance of the GrabzItHTMLOptions class that defines any special options to use when creating rendered HTML.

Return Value

void

FileToRenderedHTML(path, options = None)

Specifies a HTML file that should be converted into rendered HTML.

Parameters

• path - the file path of a HTML file to convert into rendered HTML
  • Required
• options - a instance of the GrabzItHTMLOptions class that defines any special options to use when creating rendered HTML.

Return Value

void

GrabzItHTMLOptions

The class represents all of the options available when creating rendered HTML captures.

Attributes

• customId - custom identifier that you can pass through to the webservice. This will be returned with the callback URL you have specified.
  • Default: empty
• browserWidth - the width of the browser in pixels
  • Default: 1024
  • Maximum: 10000
• browserHeight - the height of the browser in pixels
  • Default: 768
  • Maximum: 10000
• waitForElement - the id or class CSS selectors of the HTML element in the web page that must be visible before the capture is performed
  • Default: empty
• requestAs - the type of user agent you wish to use
  • Default: 0
  • Options:
    • 0 = indicates the user agent of a standard browser should be used
    • 1 = indicates the user agent of a mobile browser should be used
    • 2 = indicates the user agent of a search engine should be used
    • 3 = indicates the user agent of a basic browser should be used
• country - the country the screenshot should be taken from.
  • Warning this feature is currently in beta and may not provide consistent results.
  • Default: The current fastest location
  • Options: "SG", "UK", "US"
• exportURL - the export URL that specifies where the capture should be exported too
  • Default: empty
• encryptionKey - the if a base 64 encoded AES encryption key is specified your capture is encrypted when it is created. It is recommended to use the create encryption key method to create the key and the decrypt methods to decrypt the encrypted capture as shown in this example.
  • Default: empty
• noAds - if true adverts should be automatically hidden.
  • Default: false
• noCookieNotifications - if true all commonly found cookie notifications should be automatically hidden.
  • Default: false
• address - the URL to execute the HTML code in. Can be useful if the HTML being converted uses relative URL's for resources such as CSS and images.
  • Default: empty
• proxy - the HTTP proxy details the browser software should use to use to create this capture
  • Default: empty

Methods

• AddPostParameter(name, value) - defines a HTTP Post parameter and optionally value, this method can be called multiple times to add multiple parameters. Using this method will force GrabzIt to perform a HTTP post.
  • name - the name of the HTTP Post parameter
  • value - the value of the HTTP Post parameter

URLToPDF(url, options = None)

Specifies the URL that should be converted into a PDF.

Parameters

• url - the URL that the should be converted into a PDF
  • Required
• options - a instance of the GrabzItPDFOptions class that defines any special options to use when creating a PDF.

Return Value

void

HTMLToPDF(html, options = None)

Specifies the HTML that should be converted into a PDF.

Parameters

• html - the HTML to convert into a PDF
  • Required
• options - a instance of the GrabzItPDFOptions class that defines any special options to use when creating a PDF.

Return Value

void

FileToPDF(path, options = None)

Specifies a HTML file that should be converted into a PDF.

Parameters

• path - the file path of a HTML file to convert into a PDF
  • Required
• options - a instance of the GrabzItPDFOptions class that defines any special options to use when creating a PDF.

Return Value

void

GrabzItPDFOptions

The class represents all of the options available when creating PDF captures.

Attributes

• customId - a custom identifier that you can pass through to the webservice. This will be returned with the callback URL you have specified.
  • Default: empty
• includeBackground - if true the background of the web page should be included in the screenshot
  • Default: true
• pagesize - the page size of the PDF
  • Default: "A4"
  • Options: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legal", "Letter"
• orientation - the orientation of the PDF document
  • Default: "Portrait"
  • Options: "Portrait", "Landscape"
• cssMediaType - the CSS Media Type of the PDF document
  • Default: "Screen"
  • Options: "Screen", "Print"
• includeLinks - true if links should be included in the PDF
  • Default: true
• includeOutline - true if PDF bookmarks should be included
  • Default: false
• title - provide a title to the PDF document
  • Default: empty
• coverURL - the URL of a web page that should be used as a cover page for the PDF
  • Default: empty
• marginTop - the margin in millimeters that should appear at the top of the PDF document page
  • Default: 10
• marginLeft - the margin in millimeters that should appear at the left of the PDF document page
  • Default: 10
• marginBottom - the margin in millimeters that should appear at the bottom of the PDF document page
  • Default: 10
• marginRight - the margin in millimeters that should appear at the right of the PDF document
  • Default: 10
• browserWidth - the width of the browser in pixels
  • Warning this feature is currently in beta and may not provide consistent results.
  • Default: 1024
  • Maximum: 10000
  • Auto Width: -1 (passing -1 means that the width of the browser matches the width of the PDF document)
• pageWidth - the custom width of the resulting PDF in mm
  • Default: page size width
  • Minimum: 15
• pageHeight - the custom height of the resulting PDF in mm
  • Default: page size height
  • Minimum: 15
• delay - the number of milliseconds to wait before taking the screenshot
  • Default: 0
  • Maximum: 30000
• templateId - add a template ID that specifies the header and footer of the PDF document
  • Default: empty
• targetElement - the id or class CSS selector of the only HTML element on the target web page that is to be turned into a PDF, all other parts of the web page are ignored. If there are multiple matching HTML elements the first one is chosen
  • Default: empty
• hideElement - the id or class 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
• waitForElement - the id or class CSS selectors of the HTML element in the web page that must be visible before the capture is performed
  • Default: empty
• requestAs - the type of user agent you wish to use
  • Default: 0
  • Options:
    • 0 = indicates the user agent of a standard browser should be used
    • 1 = indicates the user agent of a mobile browser should be used
    • 2 = indicates the user agent of a search engine should be used
    • 3 = indicates the user agent of a basic browser should be used
• customWaterMarkId - add a custom watermark to each page of the PDF document
  • Default: empty
• quality - the quality of the returned PDF. The default uses the recommended quality for a PDF.
  • Reducing the quality will reduce the filesize and reduce download times.
  • Default: -1
  • Minimum: -1
  • Maximum: 100
• country - the country the screenshot should be taken from.
  • Warning this feature is currently in beta and may not provide consistent results.
  • Default: The current fastest location
  • Options: "SG", "UK", "US"
• exportURL - the export URL that specifies where the capture should be exported too
  • Default: empty
• encryptionKey - the if a base 64 encoded AES encryption key is specified your capture is encrypted when it is created. It is recommended to use the create encryption key method to create the key and the decrypt methods to decrypt the encrypted capture as shown in this example.
  • Default: empty
• noAds - if true adverts should be automatically hidden.
  • Default: false
• noCookieNotifications - if true all commonly found cookie notifications should be automatically hidden.
  • Default: false
• address - the URL to execute the HTML code in. Can be useful if the HTML being converted uses relative URL's for resources such as CSS and images.
  • Default: empty
• proxy - the HTTP proxy details the browser software should use to use to create this capture
  • Default: empty
• mergeId - the ID of a capture that should be merged at the beginning of the new PDF document
  • Default: empty

Methods

• AddPostParameter(name, value) - defines a HTTP Post parameter and optionally value, this method can be called multiple times to add multiple parameters. Using this method will force GrabzIt to perform a HTTP post.
  • name - the name of the HTTP Post parameter
  • value - the value of the HTTP Post parameter
• AddTemplateParameter(name, value) - define a custom template parameter and value, this method can be called multiple times to add multiple parameters.
  • name - the name of the template parameter
  • value - the value of the template parameter

URLToDOCX(url, options = None)

Specifies the URL that should be converted into a DOCX.

Parameters

• url - the URL that the should be converted into a DOCX
  • Required
• options - a instance of the GrabzItDOCXOptions class that defines any special options to use when creating a DOCX.

Return Value

void

HTMLToDOCX(html, options = None)

Specifies the HTML that should be converted into a DOCX.

Parameters

• html - the HTML to convert into a DOCX
  • Required
• options - a instance of the GrabzItDOCXOptions class that defines any special options to use when creating a DOCX.

Return Value

void

FileToDOCX(path, options = None)

Specifies a HTML file that should be converted into a DOCX.

Parameters

• path - the file path of a HTML file to convert into a DOCX
  • Required
• options - a instance of the GrabzItDOCXOptions class that defines any special options to use when creating a DOCX.

Return Value

void

GrabzItDOCXOptions

The class represents all of the options available when creating DOCX captures.

Attributes

• customId - a custom identifier that you can pass through to the webservice. This will be returned with the callback URL you have specified.
  • Default: empty
• includeBackground - if true the background images of the web page should be included in the DOCX
  • Default: true
• pagesize - the page size of the DOCX
  • Default: "A4"
  • Options: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legal", "Letter"
• orientation - the orientation of the DOCX document
  • Default: "Portrait"
  • Options: "Portrait", "Landscape"
• includeLinks - true if links should be included in the DOCX
  • Default: true
• includeImages - if true the background images of the web page should be included in the DOCX
  • Default: true
• title - provide a title to the DOCX document
  • Default: empty
• marginTop - the margin in millimeters that should appear at the top of the DOCX document page
  • Default: 10
• marginLeft - the margin in millimeters that should appear at the left of the DOCX document page
  • Default: 10
• marginBottom - the margin in millimeters that should appear at the bottom of the DOCX document page
  • Default: 10
• marginRight - the margin in millimeters that should appear at the right of the DOCX document
  • Default: 10
• browserWidth - the width of the browser in pixels
  • Warning this feature is currently in beta and may not provide consistent results.
  • Default: 1024
  • Maximum: 10000
  • Auto Width: -1 (passing -1 means that the width of the browser matches the width of the DOCX document)
• pageWidth - the custom width of the resulting DOCX in mm
  • Default: page size width
  • Minimum: 15
• pageHeight - the custom height of the resulting DOCX in mm
  • Default: page size height
  • Minimum: 15
• delay - the number of milliseconds to wait before taking the screenshot
  • Default: 0
  • Maximum: 30000
• templateId - add a template ID that specifies the header and footer of the DOCX document
  • Default: empty
• targetElement - the id or class CSS selector of the only HTML element on the target web page that is to be turned into a DOCX, all other parts of the web page are ignored. If there are multiple matching HTML elements the first one is chosen
  • Default: empty
• hideElement - the id or class 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
• waitForElement - the id or class CSS selectors of the HTML element in the web page that must be visible before the capture is performed
  • Default: empty
• requestAs - the type of user agent you wish to use
  • Default: 0
  • Options:
    • 0 = indicates the user agent of a standard browser should be used
    • 1 = indicates the user agent of a mobile browser should be used
    • 2 = indicates the user agent of a search engine should be used
    • 3 = indicates the user agent of a basic browser should be used
• quality - the quality of the returned DOCX. The default uses the recommended quality for a DOCX.
  • Reducing the quality will reduce the filesize and reduce download times.
  • Default: -1
  • Minimum: -1
  • Maximum: 100
• country - the country the screenshot should be taken from.
  • Warning this feature is currently in beta and may not provide consistent results.
  • Default: The current fastest location
  • Options: "SG", "UK", "US"
• exportURL - the export URL that specifies where the capture should be exported too
  • Default: empty
• encryptionKey - the if a base 64 encoded AES encryption key is specified your capture is encrypted when it is created. It is recommended to use the create encryption key method to create the key and the decrypt methods to decrypt the encrypted capture as shown in this example.
  • Default: empty
• noAds - if true adverts should be automatically hidden.
  • Default: false
• noCookieNotifications - if true all commonly found cookie notifications should be automatically hidden.
  • Default: false
• address - the URL to execute the HTML code in. Can be useful if the HTML being converted uses relative URL's for resources such as CSS and images.
  • Default: empty
• proxy - the HTTP proxy details the browser software should use to use to create this capture
  • Default: empty
• mergeId - the ID of a capture that should be merged at the beginning of the new DOCX document
  • Default: empty

Methods

• AddPostParameter(name, value) - defines a HTTP Post parameter and optionally value, this method can be called multiple times to add multiple parameters. Using this method will force GrabzIt to perform a HTTP post.
  • name - the name of the HTTP Post parameter
  • value - the value of the HTTP Post parameter
• AddTemplateParameter(name, value) - define a custom template parameter and value, this method can be called multiple times to add multiple parameters.
  • name - the name of the template parameter
  • value - the value of the template parameter

URLToTable(url, options = None)

Specifies the URL that the HTML tables should be extracted from.

Parameters

• url - the URL to extract HTML tables from
  • Required
• options - a instance of the GrabzItTableOptions class that defines any special options to use when converting the HTML table.

Return Value

void

HTMLToTable(html, options = None)

Specifies the HTML that the HTML tables should be extracted from.

Parameters

• html - the HTML to extract HTML tables from.
  • Required
• options - a instance of the GrabzItTableOptions class that defines any special options to use when converting the HTML table.

Return Value

void

FileToTable(path, options = None)

Specifies a HTML file that the HTML tables should be extracted from.

Parameters

• path - the file path of a HTML file to extract HTML tables from.
  • Required
• options - a instance of the GrabzItTableOptions class that defines any special options to use when converting the HTML table.

Return Value

void

GrabzItTableOptions

The class represents all of the options available when converting HTML tables to CSV, XLSX or JSON.

Attributes

• customId - a custom identifier that you can pass through to the webservice. This will be returned with the callback URL you have specified
  • Default: empty
• tableNumberToInclude - 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
• format - the format the table should be in
  • Default: "csv"
  • Options: "csv", "json", "xlsx"
• includeHeaderNames - if true header names will be included in the table
  • Default: true
• includeAllTables - if true all table on the web page will be extracted with each table appearing in a seperate spreadsheet sheet. Only available with the XLSX format
  • Default: false
• targetElement - the id of the only HTML element in the web page that should be used to extract tables from
  • Default: empty
• requestAs - the type of user agent you wish to use
  • Default: 0
  • Options:
    • 0 = indicates the user agent of a standard browser should be used
    • 1 = indicates the user agent of a mobile browser should be used
    • 2 = indicates the user agent of a search engine should be used
    • 3 = indicates the user agent of a basic browser should be used
• country - the country the screenshot should be taken from.
  • Warning this feature is currently in beta and may not provide consistent results.
  • Default: The current fastest location
  • Options: "SG", "UK", "US"
• exportURL - the export URL that specifies where the capture should be exported too
  • Default: empty
• encryptionKey - the if a base 64 encoded AES encryption key is specified your capture is encrypted when it is created. It is recommended to use the create encryption key method to create the key and the decrypt methods to decrypt the encrypted capture as shown in this example.
  • Default: empty
• address - the URL to execute the HTML code in. Can be useful if the HTML being converted uses relative URL's for resources such as CSS and images.
  • Default: empty
• proxy - the HTTP proxy details the browser software should use to use to create this capture
  • Default: empty

Methods

• AddPostParameter(name, value) - defines a HTTP Post parameter and optionally value, this method can be called multiple times to add multiple parameters. Using this method will force GrabzIt to perform a HTTP post.
  • name - the name of the HTTP Post parameter
  • value - the value of the HTTP Post parameter

Save(callBackURL = '')

Save the result asynchronously and returns a unique identifier, which can be used to get the screenshot with the GetResult method.

Parameters

• callBackURL - the handler the GrabzIt service should call after it has completed its work

Return Value

The unique identifier of the screenshot otherwise if a error has occured an exception is thrown. This can be used to get the screenshot with the GetResult method

SaveTo()

Save the result synchronously to a variable containing the screenshot byte data.

Return Value

returns the byte data of the file if successful otherwise it throws an exception.

SaveTo(saveToFile)

Save the result synchronously to a file.

Parameters

• saveToFile - the file path that capture will be saved to once it has been completed
  • Required

Return Value

returns the true if it is successful otherwise it throws an exception.

GetStatus(id)

Get the current status of a GrabzIt screenshot.

Parameters

• id - the unique identifier of the screenshot
  • Required

Return Value

ScreenShotStatus object

GetCookies(domain)

Get all the cookies that GrabzIt is using for a particular domain. This may include user defined cookies as well.

Parameters

• domain - the domain to return cookies for
  • Required

Return Value

GrabzItCookie array

SetCookie(name, domain, value = "", path = "/", httponly = False, expires = "")

Sets a new custom cookie on GrabzIt, if the custom cookie has the same name and domain as a global cookie the global cookie is overridden.

This can be useful if a websites functionality is controlled by cookies.

Parameters

• name - the name of the cookie to set
  • Required
• domain - the domain of the website to set the cookie for
  • Required
• value - the value of the cookie
• path - the website path the cookie relates to
• httponly - if true the cookie can only be used with the HTTP protocol
• expires - defines when the cookie expires. Pass a None value if the cookie should not expire
  • Should be in the format yyyy-mm-dd hh:mm:ss

Return Value

True if the cookie is successfully set, otherwise false

DeleteCookie(name, domain)

Delete a custom cookie or block a global cookie from being used

Parameters

• name - the name of the cookie to delete
  • Required
• domain - the domain of the website to delete the cookie for
  • Required

Return Value

True if the cookie is successfully deleted, otherwise false

GetWaterMarks()

Get your uploaded custom watermarks

Return Value

GrabzItWaterMark array

GetWaterMark(identifier)

Return your custom watermarks that matches the specified identifier

Parameters

• identifier - the identifier of a particular custom watermark you want to view
  • Required

Return Value

GrabzItWaterMark

AddWaterMark(identifier, path, xpos, ypos)

Add a new custom watermark

Parameters

• identifier - the identifier you want to give the custom watermark. It is important that this identifier is unique.
  • Required
• path - the absolute path of the watermark on your server. For instance C:/watermark/1.png
  • Required
• xpos - the horizontal position you want the screenshot to appear at
  • Required
  • Options:
    • Left = 0
    • Center = 1
    • Right = 2
• ypos - vertical position you want the screenshot to appear at
  • Required
  • Options:
    • Top = 0
    • Middle = 1
    • Bottom = 2

Return Value

returns true if the watermark was successfully set

DeleteWaterMark(identifier)

Delete a custom watermark

Parameters

• identifier - the identifier of the custom watermark you want to delete
  • Required

Return Value

returns true if the watermark was successfully deleted

SetLocalProxy(proxyUrl)

This method enables a local proxy server to be used for all requests.

Parameters

• proxyUrl - the URL, which can include a port if required, of the proxy. Providing a null will remove any previously set proxy
  • Required

UseSSL(value)

Specifies if requests to GrabzIt's API should use SSL

Parameters

• value - if true all requests to GrabzIt's API will use SSL
  • Required

CreateEncryptionKey()

Create a cryptographically secure base 64 encryption key, 44 characters long.

Decrypt(data, key)

Decrypt an encrypted capture using the provided encryption key.

Parameters

• data - the encrypted bytes
  • Required
• key - the encryption key
  • Required

DecryptFile(path, key)

Decrypt an encrypted capture using the provided encryption key.

Parameters

• path - the path of the encrypted capture
  • Required
• key - the encryption key
  • Required

Result Classes

GrabzItCookie

Public Properties

• Name
  • The cookie name.
• Value
  • The cookie value.
• Domain
  • The domain the cookie is set for.
• Path
  • The path on the domain that this cookie applies to.
• HttpOnly
  • If this cookie is only valid when the website is viewed with the HTTP protocol.
• Expires
  • The date this cookie expires
• Type
  • The type of cookie this is, which can be one of the following:
    • Global - this is a global cookie set by GrabzIt
    • Local - this is a local cookie set by you
    • Overridden - a global cookie that has been overridden by you

ScreenShotStatus

The class representing the current status of the screenshot.

Public Properties

• Processing
  • If true the screenshot is still being processed.
• Cached
  • If true the screenshot is has been processed and is currently cached.
• Expired
  • If true the screenshot is no longer on the GrabzIt system.
• Message
  • An error message returned by the system.

GrabzItWaterMark

This class represents the custom watermarks stored in GrabzIt

Public Properties

• Identifier
  • The identifier of the watermark
• XPosition
  • The horizontal postion of the watermark
    • Left = 0
    • Center = 1
    • Right = 2
• YPosition
  • The vertical postion of the watermark
    • Top = 0
    • Middle = 1
    • Bottom = 2
• Format
  • The format of the watermark