# WebsiteScreen.com Reference

WebsiteScreen.com provides a free online website screenshot interface and a free account-based API. The browser interface does not require registration. API users create an account at `/signup/` and retrieve a personal key from `/dashboard/`.

## Screenshot API

Endpoint: `GET https://websitescreen.com/api/`

Required query parameters:

- `url`: public HTTP or HTTPS URL.
- `userkey`: active client API key.

Optional query parameters:

- `width`: viewport width from 240 to 2000 pixels; default 1280.
- `height`: viewport height up to 20000 pixels; default 1280; zero selects full-page capture.
- `zoom`: percentage from 100 to 500; default 100.
- `scaled_width`: output width from 24 to 2000 pixels.
- `full_size`: set to 1 for full-page capture.
- `format`: PNG or JPEG.
- `response_type`: image or json.

The default response is the screenshot image. A JSON response contains a base64 data URL and applied screenshot parameters. Invalid API keys receive HTTP 401. Invalid target URLs receive HTTP 400.

## Accounts

Accounts, password hashes, API keys, status, and capture metadata are stored in protected TSV flat files. Administrators use `/admin/`; first-run setup is `/admin/setup.php`.

## Assistance and ownership

Client Assistance: `https://clientassistance.com/`

WebsiteScreen.com is a property of Dot Coms, Inc. - Virtual Business Solutions Worldwide: `https://dotcomsinc.com/`