# Allscreenshots Agent Reference

Allscreenshots is a hosted screenshot and browser rendering API. It is useful
for agents that need visual evidence of a web page, full-page screenshots,
responsive screenshots, PDFs, link-preview debugging, visual regression
artifacts, compliance evidence, or extracted page outputs.

## Service URLs

- Website: https://allscreenshots.com
- Dashboard: https://dashboard.allscreenshots.com
- API base: https://api.allscreenshots.com
- Documentation: https://docs.allscreenshots.com
- OpenAPI: https://allscreenshots.com/openapi.json
- API catalog: https://allscreenshots.com/.well-known/api-catalog
- Auth instructions: https://allscreenshots.com/auth.md

## Authentication

Use an API key from the Allscreenshots dashboard.

HTTP header:

```http
Authorization: Bearer ALLSCREENSHOTS_API_KEY
Content-Type: application/json
```

## Capture a Screenshot

```bash
curl -X POST "https://api.allscreenshots.com/v1/screenshots" \
  -H "Authorization: Bearer $ALLSCREENSHOTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "fullPage": true,
    "viewport": {
      "width": 1280,
      "height": 800
    },
    "format": "png",
    "responseType": "url"
  }'
```

## Common Workflows

### Full-page capture

Set `fullPage: true` to capture the whole scrollable page.

### Mobile capture

Use a mobile viewport:

```json
{
  "viewport": {
    "width": 390,
    "height": 844
  },
  "deviceScaleFactor": 3
}
```

### PDF output

Set `format: "pdf"`.

### Clean screenshots

Use `blockAds: true` and `blockCookieBanners: true`.

### Dark mode

Set `darkMode: true`.

### Shareable result

Set `responseType: "url"` and return the resulting storage URL to the user.

## Agent Skill

The agent skill index is available at:

https://allscreenshots.com/.well-known/agent-skills/index.json