Screenshot Machine

Screenshot Machine is an API service that allows users to capture and retrieve screenshots of web pages programmatically.

Screenshot Machine is a web-based service that captures high-quality screenshots of web pages across different devices and formats. This connector enables Swimlane Turbine users to automate the process of capturing, customizing, and retrieving screenshots of specified URLs directly within their security workflows. By integrating Screenshot Machine, security teams can visually document web content for investigations, compliance, and reporting without manual intervention. The connector supports advanced options such as device emulation, cropping, hiding elements, and setting cookies, allowing for precise and context-aware captures. This integration streamlines evidence collection and enhances incident response by embedding visual context into automated playbooks.

This connector integrates the Screenshot Machine API with Turbine.

Prerequisites

To use the Screenshot Machine connector, ensure you have the following prerequisites:

API Key authentication using these parameters:

API Key: Your unique key provided by Screenshot Machine to authenticate API requests.

Capabilities

Use the Screenshot Machine Connector to Submit URLs.

For further information about input values see the offical Screenshotmachine documentation.

Configurations

API Key Authentication

Screenshotmachine API turbine connector

Configuration Parameters

Parameter	Description	Type	Required
url	A URL to the target host.	string	Optional
api_key	API Key	string	Required
secret_phrase	Secret Phrase	string	Optional
verify_ssl	Verify SSL certificate	boolean	Optional
http_proxy	A proxy to route requests through.	string	Optional

Actions

URL Submit

Submit a URL to Screenshot Machine to capture and retrieve a screenshot of the specified web page.

Input

Argument Name	Type	Required	Description
web_url	string	Optional	URL endpoint for the request
get-file	boolean	Optional	Parameter for URL Submit
dimension	string	Optional	Parameter for URL Submit
device	string	Optional	Parameter for URL Submit
format	string	Optional	Parameter for URL Submit
hash	string	Optional	Parameter for URL Submit
cacheLimit	string	Optional	Parameter for URL Submit
delay	string	Optional	Parameter for URL Submit
zoom	string	Optional	Parameter for URL Submit
click	string	Optional	Parameter for URL Submit
hide	string	Optional	Unique identifier
cookies	string	Optional	Parameter for URL Submit
accept-language	string	Optional	Parameter for URL Submit
user-agent	string	Optional	Parameter for URL Submit
selector	string	Optional	Parameter for URL Submit
crop	string	Optional	Parameter for URL Submit

Input Example

{"web_url":"https://www.google.com","get-file":true,"dimension":"1024xfull","device":"desktop","format":"jpg","hash":"ac502de622959ae5f59a6bdc2346771e","cacheLimit":"0","delay":"0","zoom":"10","click":".button-close","hide":".cookie-banner","cookies":"name1=value1","accept-language":"en-US","user-agent":"Mozilla/5.0 (Linux; Android 10; SM-G981B)","selector":"Selector","crop":"100,0,800,300"}

Output

Parameter	Type	Description
status_code	number	HTTP status code of the response
reason	string	Response reason phrase
file	object	Output field: file
file.file_name	string	Name of the resource
file.file	string	Output field: file.file
url_response	string	URL endpoint for the request

Output Example

{"status_code":200,"response_headers":{"content-length":"140","content-type":"application/json","Date":"Mon, 10 Jul 2023 20:37:23 GMT"},"reason":"OK","file":{"file_name":null,"file":null},"json_body":{"url_response":"https://www.google.com"}}

Response Headers

Header	Description	Example
content-length	The length of the response body in bytes	140
content-type	The media type of the resource	application/json
Date	The date and time at which the message was originated	Mon, 10 Jul 2023 20:37:23 GMT