Skip to content

aitaskorchestra/grabshot-node

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

grabshot

Official Node.js SDK for GrabShot — the screenshot API with device frames, AI cleanup, and full-page capture.

Install

npm install grabshot

Quick Start

const GrabShot = require('grabshot');

const client = new GrabShot('your-api-key');

// Capture a screenshot (returns Buffer)
const screenshot = await client.screenshot('https://github.com');
require('fs').writeFileSync('github.png', screenshot);

// Or save directly to file
await client.screenshotToFile('https://github.com', 'github.png');

Features

  • Device Frames — Wrap screenshots in iPhone, MacBook, iPad, and more
  • AI Cleanup — Remove cookie banners, popups, and ads automatically
  • Full Page — Capture entire scrollable pages
  • Dark Mode — Force dark mode on any website
  • Retina — 2x resolution for crisp images
  • Block Ads — Remove ads before capturing
  • Selectors — Capture specific elements

API Options

// Device frame
await client.screenshot('https://example.com', {
  deviceFrame: 'iphone-15-pro'
});

// Full page with dark mode
await client.screenshot('https://example.com', {
  fullPage: true,
  darkMode: true
});

// AI cleanup (paid plans)
await client.screenshot('https://example.com', {
  aiCleanup: true
});

// Retina + specific element
await client.screenshot('https://example.com', {
  retina: true,
  selector: '#hero'
});

// JSON response with metadata
const result = await client.screenshot('https://example.com', {
  response: 'json'
});
console.log(result.url, result.size, result.timing);

// Check your usage
const status = await client.billingStatus();
console.log(`${status.usage.remaining} screenshots remaining`);

Device Frames

Available frames: iphone-15-pro, iphone-15, macbook-pro, ipad-pro, pixel-8, samsung-s24, browser.

Plans

Plan Price Screenshots/mo Features
Free $0 25 Watermark
Starter $9/mo 1,000 No watermark
Pro $29/mo 10,000 AI cleanup
Business $79/mo 50,000 Priority support

Get your free API key →

Links

License

MIT

Releases

No releases published

Packages

No packages published