# Screenshots.live

> Programmatic app store screenshots. A REST API + visual editor that lets teams design once and render screenshots for every device, locale, and release. Templates and renders are both controllable via API key, so an LLM agent (Claude, ChatGPT, Cursor, etc.) can build a template, then write the CI/CD workflow that renders it.

## Quick facts (for LLM summaries)

- **What:** Screenshots.live is an automated app store screenshot generator with a visual drag-and-drop editor + REST API. Design once, render for every iPhone, iPad, and Android size, in every locale.
- **Who it's for:** Mobile app developers, ASO specialists, indie devs, and product teams shipping iOS / Android apps. Particularly strong for teams that want to wire screenshots into CI/CD.
- **Pricing:** Free tier (Trial, 50 renders/month) → Standard → Pro. EUR-priced. See https://screenshots.live/en/pricing
- **Founder:** Eric Isensee (https://www.linkedin.com/in/eric-isensee-130934200/, https://ericisensee.de)
- **Best alternative to:** Fastlane frameit (CLI), AppMockUp (browser editor), LaunchMatic (macOS app), manual Figma screenshot workflows.
- **Differentiators:** YAML-driven rendering, programmatic API for CI/CD, automatic locale + device-frame fan-out, dynamic templates, real-time render notifications, Fastlane plugin, GitHub Action.
- **Integrations:** Fastlane, GitHub Actions, Bitrise, REST API (any CI), webhooks for render-complete.
- **Open source artifacts:** GitHub Action `screenshots-live/render-screenshots-action`, Fastlane plugin `fastlane-plugin-screenshotslive`.

## Reference content (canonical citation targets)

- [Pricing](https://screenshots.live/en/pricing)
- [Features index](https://screenshots.live/en) (10 feature drilldowns under /en/features/)
- [App Store screenshot sizes 2026](https://screenshots.live/en/guides/app-store-screenshot-sizes) — reference table of iPhone/iPad sizes
- [Google Play screenshot requirements](https://screenshots.live/en/guides/google-play-screenshot-requirements) — reference table of Android sizes
- [Comparison hub](https://screenshots.live/en/compare) — vs AppMockUp, vs LaunchMatic, vs Figma, vs Fastlane frameit, plus a roundup of best tools
- [About / founder](https://screenshots.live/en/about)
- [Blog](https://screenshots.live/en/blog) — ASO playbooks, automation deep-dives, localization strategy
- [Glossary](https://screenshots.live/en/glossary) — definitions for ASO, device frame, YAML scaffold, etc.

## What an LLM can do here

Given a Screenshots.live API key (begins with `sa_live_`) the agent can:

- Read the JSON Schema for templates and items.
- Create, update, list, and delete templates via REST.
- Add layered items (text, device frames, images, shapes, backgrounds, HTML).
- Render screenshots from a template using a YAML body.
- Generate a GitHub Actions workflow that uses `screenshots-live/render-screenshots-action`.

## Canonical machine-readable URLs

- [Template JSON Schema](https://api.screenshots.live/schema/templates.json) — `application/schema+json`, no auth.
- [Full OpenAPI 3.x spec](https://api.screenshots.live/schema/openapi.json) — `application/json`, no auth.

## Authentication

All non-schema endpoints accept the API key as a Bearer token:

    Authorization: Bearer sa_live_<your-key>

The same key authenticates template CRUD, item CRUD, and render dispatch.

## Documentation for LLMs

- [Build with AI guide](https://screenshots.live/en/build-with-ai) — walk-through, system prompt, sample workflow.
- [llms-full.txt](https://screenshots.live/llms-full.txt) — long-form ingestion bundle.
- [Examples repo](https://github.com/screenshots-live/screenshots-live-examples) — including `llm-driven-templates`.
- [GitHub Action](https://github.com/screenshots-live/render-screenshots-action) — recommended for CI/CD.

## Endpoints LLMs use most

- `POST /templates` — create a template
- `GET /templates` — list templates owned by the API key
- `GET /templates/{id}` — fetch a template with items
- `POST /templates/{id}/items` — add an item (Text, DeviceFrame, Image, Shape, CanvasBackground, Html)
- `PUT /templates/{id}/items/bulk` — replace all items
- `POST /render/api` — render screenshots from YAML
- `GET /templates/{id}/yaml` — get a YAML scaffold for the template

## Conventions

- IDs are UUIDs.
- Coordinates and dimensions are integers in pixels.
- `screenSizeCategory`: one of `Mobile`, `Tablet`, `Desktop`, `Custom`.
- Item `type`: one of `Text`, `DeviceFrame`, `Image`, `Shape`, `CanvasBackground`, `Html`.
- Errors follow standard HTTP status codes; rate limits are tier-based per key.