node.js library for url2png
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

url2png =======

node.js library for url2png

Get your account at


$ npm install url2png


var url2png = require('url2png')('API_KEY', 'PRIVATE_KEY');

var screenshotUrl = url2png.buildURL(url, options);

var screenshotStream = url2png.readURL(url, options);



The target url as a non-escaped string.


Name type default description
viewport string 1280x1024 The viewport for the browser. Max is 4000x4000
fullpage boolean false Capture the entire page, even what is outside of the viewport.
thumbnail_max_width pixels - Maximum width of image returned. If not specified image return will be 1:1.
delay seconds - EXTRA delay in seconds to handle flash animation.
You probably don't need this!
We work hard to detect the right time to take the screenshot.
force boolean false Shall we use the cached version if it already exists?
protocol string - The protocol to use, can be 'https' or 'http' (blank to use protocol relative urls).


var url2png = require('url2png')('API_KEY', 'PRIVATE_KEY');

var options = {
  viewport : '900x600',
  thumbnail_max_width : 400,
  protocol: 'http'

//Get the URL
var url = url2png.buildURL('', options);

//...or download the image to a file
var fs = require('fs');
url2png.readURL('', options).pipe(fs.createWriteStream('google.png'));

//...or send the image in the http response
var http = require('http');
http.createServer(function (req, res) {
  if (req.url === '/google.png') {
    url2png.readURL('', options).pipe(res)