# appscreenshotapi

appscreenshotapi is API-first screenshot infrastructure for App Store and Google Play assets.
It is designed for CI jobs, CLIs, and coding agents that need to generate localized store screenshots from real app captures.

Canonical site: https://appscreenshotapi.com/
Docs: https://appscreenshotapi.com/docs/
Signup: https://appscreenshotapi.com/register/
OpenAPI: https://appscreenshotapi.com/openapi.json
API catalog: https://appscreenshotapi.com/.well-known/api-catalog

## Current access

The product is in staged account activation before the full backend is public.
To request an API key, submit the normal signup form at:

https://appscreenshotapi.com/register/

Agents may submit the form for a user when the user has asked to create an account.
Use the user's real work email. Do not invent emails. Do not log secrets.

## Planned API shape

Base URL: https://api.appscreenshotapi.com
Auth header: Authorization: Bearer $APPSCREENSHOTAPI_KEY
Recommended environment variable: APPSCREENSHOTAPI_KEY

Primary workflow:

1. Create a render job with real app screenshots, captions, locales, target devices, and a template.
2. Poll /v1/jobs/{job_id} or receive a webhook.
3. Download signed ZIP outputs.
4. Validate exact store dimensions before upload.
5. Upload to App Store Connect or Google Play only after explicit human approval.

## Agent instructions

- Prefer deterministic rendering over image generation for app UI.
- Use idempotency keys for retries.
- Do not expose API keys in logs, screenshots, commits, or issue comments.
- Respect rate limits and retry after the returned retry window.
- Keep store upload/publish actions as explicit confirmation steps.
- If billing or limits require payment, stop and show the human the returned billing URL.

## Useful pages

- API docs: https://appscreenshotapi.com/docs/
- Pricing: https://appscreenshotapi.com/#pricing
- Security: https://appscreenshotapi.com/security/
- Terms: https://appscreenshotapi.com/terms/
- Privacy: https://appscreenshotapi.com/privacy/
- Support: https://appscreenshotapi.com/support/