Site to Image API

# Find your API token at https://sitetoimage.com/account
token="token-6a5e01c336dc5ec721668e2c862e43d22cce22acc6ed53b98466ee15b626d894"
# The URL you want to take a screenshot of:
url="https://example.com"
# The width of the resulting image:
width="800"
# The height of the resulting image:
height="600"
# Whether to capture the full page of content, regardless of the height parameter:
fullPage="false"
# The format to save the image in:
fileType="jpeg"
# The quality of the resulting JPEG:
quality="50"
# Use a transparent background instead of a white one:
omitBackground="true"
# Controls how a page is determined to be "loaded":
loadedAutoDetect="2"
# How long to wait after load before taking the screenshot in milliseconds:
delayMs="1000"
# How long the image should be cached for in seconds:
ttl="300"
# Change this to force a new screenshot to be generated:
unique="1567032458962"
# Use cURL to get the image:
curl -L -G "https://sitetoimage.com/api/screenshot?token=$token&width=$width&height=$height&fullPage=$fullPage&fileType=$fileType&quality=$quality&omitBackground=$omitBackground&loadedAutoDetect=$loadedAutoDetect&delayMs=$delayMs&ttl=$ttl&unique=$unique" --data-urlencode "url=$url" --output screenshot.jpeg
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  236k  100  236k    0     0   114k      0  0:00:02  0:00:02 --:--:--  114k
# Use wget to get the image:
wget "https://sitetoimage.com/api/screenshot?token=$token&width=$width&height=$height&fullPage=$fullPage&fileType=$fileType&quality=$quality&omitBackground=$omitBackground&loadedAutoDetect=$loadedAutoDetect&delayMs=$delayMs&ttl=$ttl&unique=$unique&url=$url" --output-document=screenshot.jpeg
--2019-08-06 14:20:21--  https://sitetoimage.com/api/screenshot?token=token-6a5e01c336dc5ec721668e2c862e43d22cce22acc6ed53b98466ee15b626d894&width=800&height=600&fullPage=false&fileType=jpeg&quality=50&omitBackground=true&url=https://example.com
Resolving sitetoimage.com (sitetoimage.com)... 35.236.94.206
Connecting to sitetoimage.com (sitetoimage.com)|35.236.94.206|:443... connected.HTTP request sent, awaiting response... 200 OK
Length: 15723 (15K) [image/jpeg]
Saving to: ‘screenshot.jpeg’

screenshot.jpeg     100%[===================>]  15.35K  --.-KB/s    in 0s

2019-08-06 14:20:21 (35.7 MB/s) - ‘screenshot.jpeg’ saved [15723/15723]
# The screenshot is now saved in screenshot.jpeg
file screenshot.jpeg
screenshot.jpeg: JPEG image data, JFIF standard 1.01, aspect ratio, density 1x1, segment length 16, baseline, precision 8, 800x600, components 3

const querystring = require('querystring');
const https = require('https');
const path = require('path');
const url = require('url');
const fs = require('fs');
const os = require('os');

(async () => {
    try {
        console.info("Making request for screenshot...");
        const imageData = await sitetoimage({
            // Find your API token at https://sitetoimage.com/account
            token: "token-6a5e01c336dc5ec721668e2c862e43d22cce22acc6ed53b98466ee15b626d894",
            // The URL you want to take a screenshot of:
            url: "http://example.com",
            // The width of the resulting image:
            width: 800,
            // The height of the resulting image:
            height: 600,
            // Whether to capture the full page of content, regardless of the height parameter:
            fullPage: false,
            // The format to save the image in:
            fileType: "jpeg",
            // The quality of the resulting JPEG:
            quality: 50,
            // Use a transparent background instead of a white one:
            omitBackground: true,
            // Controls how a page is determined to be "loaded":
            loadedAutoDetect: 2,
            // How long to wait after load before taking the screenshot in milliseconds:
            delayMs: 1000,
            // How long the image should be cached for in seconds:
            ttl: 60 * 5,
            // Change this to force a new screenshot to be generated:
            unique: ""
        });
        console.info("Successfully received screenshot!");

        console.info("Writing to disk...");
        const filePath = path.join(os.tmpdir(), 'screenshot-' + Date.now() + '.jpeg');
        fs.writeFileSync(filePath, imageData);
        console.info("Successfully wrote screenshot to " + filePath);
    } catch(e) {
        console.error("Failed to download image.");
        console.error(e);
    }

    console.info("Done.");
})();

/**
 * Returns a Promise for a Buffer containing the screenshot:
 *
 * @param {Object} opts Options for your Site to Image screenshot.
 * @param {String} opts.token Site to Image API token. Find your API token at https://sitetoimage.com/account
 * @param {String} opts.url The URL you want to take a screenshot of.
 * @param {Number} [opts.width] The width of the resulting image.
 * @param {Number} [opts.height] The height of the resulting image.
 * @param {Boolean} [opts.fullPage] Whether to capture the full page of content, regardless of the height parameter.
 * @param {"jpeg" | "png"} [opts.fileType] The format to save the image in.
 * @param {Number} [opts.quality] The quality of the resulting JPEG.
 * @param {Boolean} [opts.omitBackground] Use a transparent background instead of a white one.
 * @param {Number} [opts.loadedAutoDetect] Controls how a page is determined to be "loaded".
 * @param {Number} [opts.delayMs] How long to wait after load before taking the screenshot in milliseconds.
 * @param {Number} [opts.ttl] How long the image should be cached for in seconds.
 * @param {String} [opts.unique] Change this to force a new screenshot to be generated.
 * @param {Boolean} [opts.redirectRequest] If true, request opts.url directly because we got it from a redirect.
 * @returns {Promise<Buffer>}
 */
function sitetoimage(opts) {
    return new Promise((resolve, reject) => {
        let urlForRequest = "https://sitetoimage.com/api/screenshot?" + querystring.encode(opts);

        if (opts.redirectRequest) {
            urlForRequest = opts.url;
        }

        const options = url.parse(urlForRequest);
        options.method = "GET";

        const req = https.request(options, (res) => {
            // Follow any redirects:
            if (res.statusCode >= 300 && res.statusCode < 400) {
                sitetoimage({
                    url: res.headers['location'],
                    token: opts.token,
                    redirectRequest: true
                }).then(resolve, reject);
                return;
            }

            const chunks = [];

            res.on('data', (chunk) => {
                chunks.push(chunk);
            });

            res.on('error', (e) => {
                console.error("Error occurred while receiving data:");
                console.error(e);
                reject(e);
            });

            res.on('end', () => {
                const data = Buffer.concat(chunks);

                if (res.statusCode === 200) {
                    resolve(data);
                } else {
                    reject(new Error("Received non-success status " + res.statusCode + " from server. Error was: " + data.toString()));
                }
            });
        });

        req.on("error", (e) => {
            console.error("Error occurred while making request:");
            console.error(e);
            reject(e);
        });

        req.end();
    });
}