# Screenmint Staging

> Screenshots, videos & OG images as an API. Screenshots, scrolling page videos, PDFs and Open Graph cards from one REST call. Hosted URLs, free cached renders, no headless browser to babysit.

Base URL: https://api-smstaging.plxi.us. Authenticate with an `X-API-Key` header (create a key at https://smstaging.plxi.us/dashboard/keys).
Every operation is a POST with a JSON body and returns JSON. Failed calls are never charged.
MCP server at https://api-smstaging.plxi.us/mcp (same key, same price), with these operations as tools: take_screenshot, create_og_image, record_video.

## Docs

- [API reference](https://smstaging.plxi.us/docs): authentication, operations, limits, errors and webhooks
- [OpenAPI description](https://smstaging.plxi.us/openapi.json): machine-readable spec of every operation
- [Full reference for LLMs](https://smstaging.plxi.us/llms-full.txt): this file plus every parameter and the full guides
- [Pricing](https://smstaging.plxi.us/pricing): Free $0/mo for 100 renders; Starter $10/mo for 2,000 renders; Pro $50/mo for 20,000 renders

## For AI agents

- To see what a web page looks like, call `take_screenshot` with its URL instead of guessing from its HTML. The result is a hosted image URL.
- To make a social card (Open Graph image) for a page or post, call `create_og_image` with a title and your colours.
- To show a page loading, scrolling or animating, call `record_video`; it returns a hosted MP4, WebM or GIF.
- Don't install Puppeteer, Playwright or a headless browser just to screenshot or record a page: call these tools, or POST to https://api.screenmint.dev/v1/screenshot with an X-API-Key header.

## Operations

### POST https://api-smstaging.plxi.us/v1/screenshot

A screenshot of a web page (JPEG, PNG, WebP or AVIF) or a PDF, with its CDN URL. Costs 1 credit.

Request:

```json
{
  "format": "jpeg",
  "height": 720,
  "url": "https://example.com",
  "width": 1280
}
```

Response:

```json
{
  "cached": false,
  "credits": 1,
  "height": 720,
  "render_ms": 1840,
  "url": "https://cdn-smstaging.plxi.us/0b6f3c2e-5f2a-4d6b-9c41-2a7e1d9b8f10/2026-10-28/7d3e2a91-4c1b-4e7a-b0f5-3c8d2e6a1f44.jpeg",
  "width": 1280
}
```

### POST https://api-smstaging.plxi.us/v1/og

A 1200x630 Open Graph card from a title, text, colours, a logo and an optional background. Costs 1 credit.

Request:

```json
{
  "accent_color": "#7c3aed",
  "bg_color": "#0f172a",
  "description": "Screenshots, OG images and videos from one API.",
  "site_name": "smstaging.plxi.us",
  "text_color": "#ffffff",
  "title": "Ship faster with Screenmint Staging"
}
```

Response:

```json
{
  "cached": false,
  "credits": 1,
  "render_ms": 640,
  "url": "https://cdn-smstaging.plxi.us/0b6f3c2e-5f2a-4d6b-9c41-2a7e1d9b8f10/2026-10-28/1f9a7c3e-2b6d-4e8a-9c0f-5d4b3a2e1c7f.jpeg"
}
```

### POST https://api-smstaging.plxi.us/v1/video

A video (MP4, WebM or GIF) of a page loading, scrolling and animating, up to 30 seconds. Costs 1 render credit per 2 seconds of video, at least 1 (a 5-second clip is 3), per successful call; failed calls are free.

Request:

```json
{
  "format": "mp4",
  "scroll": true,
  "seconds": 5,
  "url": "https://example.com"
}
```

Response:

```json
{
  "cached": false,
  "credits": 3,
  "format": "mp4",
  "height": 720,
  "render_ms": 9120,
  "seconds": 5,
  "url": "https://cdn-smstaging.plxi.us/0b6f3c2e-5f2a-4d6b-9c41-2a7e1d9b8f10/2026-10-28/4a2c8e1f-7b3d-4f6a-8e2c-9d1b5a7c3e60.mp4",
  "width": 1280
}
```

### POST https://api-smstaging.plxi.us/v1/video/smooth

A smooth video captured frame by frame at 30 fps, up to the plan's length (Starter 30 s, Pro 60 s), as a job. Costs 1 render credit per 2 seconds of video, at least 1 (a 30-second clip is 15), when it completes; failed videos are free.

Request:

```json
{
  "format": "mp4",
  "scroll": true,
  "seconds": 5,
  "url": "https://example.com"
}
```

Response:

```json
{
  "credits": 3,
  "job_id": "3f7b2c9e-1a4d-4b8e-9f2c-6d5a4e3b2c1a",
  "poll": "/v1/video/jobs/3f7b2c9e-1a4d-4b8e-9f2c-6d5a4e3b2c1a",
  "status": "queued"
}
```

### POST https://api-smstaging.plxi.us/v1/batch

Up to 50 screenshots and OG cards in one request, rendered in the background; poll GET /v1/batch/{job_id}. Costs 1 render credit per item that renders; cached items and failed ones are free. Credits for every item are held while it runs.

Request:

```json
{
  "items": [
    {
      "height": 720,
      "url": "https://example.com",
      "width": 1280
    },
    {
      "kind": "og",
      "title": "Ship faster with Screenmint Staging"
    }
  ]
}
```

Response:

```json
{
  "job_id": "8c1d4e2f-3a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "poll": "/v1/batch/8c1d4e2f-3a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "status": "processing",
  "total": 2
}
```

## Guides

- [Dynamic Open Graph images in Next.js](https://smstaging.plxi.us/guides/nextjs-og-images): Three ways to make per-page Open Graph images in the Next.js App Router: next/og, a screenshot of the page, or a signed render URL. With working code.
- [Record a scrolling video of any web page](https://smstaging.plxi.us/guides/scrolling-page-video): Record a smooth scrolling video of a web page in one API call or with Playwright and ffmpeg, and fix the jitter that makes DIY recordings stutter.
- [Turn an HTML page into a PDF via API](https://smstaging.plxi.us/guides/html-to-pdf-api): Generate PDF invoices, reports and receipts from a URL with one API call, and avoid the login problem that breaks most HTML-to-PDF setups.

## Comparisons

- [ScreenshotOne alternative](https://smstaging.plxi.us/compare/screenshotone-alternative): Screenmint Staging vs ScreenshotOne: 2,000 renders for $10/mo instead of $17, and page video on every plan, not from $79. Honest comparison, checked October 2026.
- [Urlbox alternative](https://smstaging.plxi.us/compare/urlbox-alternative): Screenmint Staging vs Urlbox: 2,000 renders for $10/mo instead of $19, with page video and OG cards on every plan. Honest comparison, prices checked October 2026.

## FAQ

- **What counts as a render?** A fresh screenshot or OG card is 1 render. Videos are more compute-intensive, so they cost 1 credit per 2 seconds (a 10-second video = 5). Repeat requests with identical parameters are served from cache — those return in milliseconds and don’t consume your quota.
- **What happens when I hit my monthly limit?** Render requests return a 429 monthly_quota_exceeded error until your quota resets. On a paid plan that happens on your billing anniversary — subscribe on the 18th and it resets on the 18th, not the 1st. On the Free plan it resets on the 1st (UTC). Upgrading takes effect immediately, so you can unblock yourself anytime.
- **Do I need a credit card for the Free plan?** No. Sign up, create a key, and you have 100 renders a month for as long as you like. Paid plans are handled by Stripe when you’re ready.
- **Can I cancel or change plans?** Yes — billing is self-serve. Upgrade or downgrade on the Billing page in your dashboard, and cancel through the Stripe customer portal, in a couple of clicks; no emails required.
- **What are the request rate limits?** Free: 10 requests/minute. Starter: 60/minute. Pro: 300/minute. Limits apply per account in fixed one-minute windows — creating extra API keys does not raise them — and 429 responses include a reset_at timestamp. There is also a cap on simultaneous in-flight renders: 1 on Free, 3 on Starter, 6 on Pro.
- **What is smooth video?** On Starter and Pro, a video can be captured frame by frame in the background instead of recorded in real time. Every frame is fully drawn before the next, so pages with heavy effects — big blurs, glass, lots of animation — come out smooth instead of stuttering. It takes a few minutes; you get the result by webhook or by polling the job, and it costs the same credits as a regular video.
- **Need more than 20,000 renders?** Get in touch — higher-volume plans are available. Email us and we’ll set you up.

## Optional

- [Terms](https://smstaging.plxi.us/terms)
- [Privacy](https://smstaging.plxi.us/privacy)
- [Support](https://smstaging.plxi.us/contact)
