Skip to main content
GET
Screenshot
Capture a screenshot from the phone’s current screen. This is an inspection endpoint: the Mac app reads the current phone screen and returns image data. It does not send input to the phone or change phone state.

Request

Path Parameters

Query Parameters

Synchronous Response

Returns PNG image data directly with Content-Type: image/png.

Asynchronous Response

When ?async=true:
Retrieve the screenshot via GET /jobs/{job_id}/download.

Examples

Sync Screenshot (curl)

Sync Screenshot (Python)

Async Screenshot

Errors

Mac App Not Running

Timeout

HTTP Status: 408 Request Timeout