Skip to content

bakasa/snapshot-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Website Preview Tool / SnapShot API

Free website preview tool + screenshot API. Paste any URL, get instant screenshot + metadata (title, description, OG tags, favicon). No signup, no API key needed for the web tool.

Try it: https://snapshot-api-production-1374.up.railway.app

Deployed on Railway GitHub License Stack: Hono + Puppeteer

Web Tool

Preview any website instantly — one click, no signup:

1. Go to https://snapshot-api-production-1374.up.railway.app
2. Paste any URL
3. Get screenshot + page metadata (title, description, OG tags, favicon)
4. Download, share, or embed the preview

Bookmarklet: Drag "Preview This Page" from the site to your bookmarks bar for one-click previews of any page you visit.

API (for automation)

Need programmatic screenshots? SnapShot API gives you a free key in one curl call:

# Get a free API key in one request
curl https://snapshot-api-production-1374.up.railway.app/key

# Take a screenshot — returns PNG in 2-5 seconds
curl -H "Authorization: Bearer ss_YOUR_KEY" \
  "https://snapshot-api-production-1374.up.railway.app/screenshot?url=https://example.com" \
  -o screenshot.png

From zero to screenshot in under 10 seconds. No account, no dashboard, no bullshit.

Quick Start

# 1. Get your free API key (100 screenshots/month)
curl https://snapshot-api-production-1374.up.railway.app/key
# → {"api_key":"ss_xxx...","plan":"free","monthly_limit":100,...}

# 2. Take a screenshot
curl -H "Authorization: Bearer ss_xxx..." \
  "https://snapshot-api-production-1374.up.railway.app/screenshot?url=https://github.com" \
  -o github.png

# 3. Check your usage
curl -H "Authorization: Bearer ss_xxx..." \
  https://snapshot-api-production-1374.up.railway.app/usage

Features

  • Zero signup — get a key with a single curl, no email required
  • Fast renders — 2-5 second response time with full JavaScript execution
  • PNG & JPEG — choose your format with ?format=jpeg
  • Custom viewport?width=1920&height=1080 or ?width=1200 for OG images
  • Full page capture?fullPage=true for scrollable pages
  • Configurable delay?delay=2000 to wait for JS-rendered content
  • GitHub Actionsnapshot-action for CI/CD pipelines
  • Open source — MIT license, self-host friendly

API Reference

Endpoint Description
GET /key[?ref=CODE] Generate a free API key (optional referral code)
GET /screenshot?url=... Capture a webpage screenshot
GET /usage Check your current usage and remaining quota
GET /api/metadata?url=... Fetch page metadata (title, OG tags, favicon)
GET /health Health check

Screenshot Parameters

Param Default Description
url required Page to screenshot (must start with http(s)://)
width 1280 Viewport width in pixels
height auto Viewport height in pixels
format png png or jpeg
fullPage false Capture full scrollable page
delay 0 Milliseconds to wait before capture

Auth via Authorization: Bearer YOUR_KEY header or ?api_key=YOUR_KEY query param.

Pricing

Plan Price Screenshots Features
Free $0 100/mo (+50 per referral) PNG, 1280x720
Pro $15/mo 1,000/mo PNG+JPEG, custom viewport, full page
Business $49/mo 10,000/mo All formats, priority support, team keys

Referral Program

Share your referral link and both you and your friend get +50 free screenshots.

# Get your referral link
curl -H "Authorization: Bearer YOUR_KEY" \
  https://snapshot-api-production-1374.up.railway.app/usage

Use Cases

Use Case Description
Blog posts Add website preview images to your articles
Dashboards Embed live webpage previews anywhere
Monitoring Visual checks for website changes
AI/LLM Tools Feed webpage screenshots to vision models
CI/CD Visual regression tests with GitHub Action
OG Images Generate Open Graph preview images at ?width=1200
Documentation Auto-capture docs pages for manuals

Tech Stack

Node.js, TypeScript, Hono, Puppeteer, SQLite, Railway.

License

MIT — use it, fork it, self-host it.

About

Website Preview Tool — Free, no signup. Paste any URL, get screenshot + metadata instantly. Also available as an API.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors