For AI agents: a documentation index is available at /llms.txt
Skip to main content

Supported mobile devices

These are the Android devices you can select with the emulatedDevice query parameter when running a stealth or BQL session with emulationOs=android. Each slug maps to a real flagship phone, and picking one makes the session report that device's screen size, pixel ratio, and hardware identity coherently.

Prerequisites

Pass the slug exactly as listed — values are case-sensitive and matched exactly (pixel-8, not Pixel-8 or pixel8). Omit emulatedDevice entirely and Browserless picks a device for you and keeps it stable for the session. An unrecognized slug is not an error; it falls back to an automatically chosen device.

wss://production-sfo.browserless.io/stealth?token=YOUR_API_TOKEN_HERE&emulationOs=android&emulatedDevice=pixel-8-pro

Devices

SlugDeviceScreen (CSS px)Pixel ratio
pixel-8Google Pixel 8412 × 9152.625
pixel-8-proGoogle Pixel 8 Pro448 × 9983
galaxy-s23Samsung Galaxy S23360 × 7803
galaxy-s23-ultraSamsung Galaxy S23 Ultra384 × 8243.75
galaxy-s24Samsung Galaxy S24360 × 7803
galaxy-s24-plusSamsung Galaxy S24+384 × 8323.75
galaxy-s24-ultraSamsung Galaxy S24 Ultra384 × 8323.75
galaxy-s25Samsung Galaxy S25360 × 7803
galaxy-s25-plusSamsung Galaxy S25+412 × 8913.5
galaxy-s25-ultraSamsung Galaxy S25 Ultra412 × 8913.5
galaxy-s26Samsung Galaxy S26360 × 7803
galaxy-s26-plusSamsung Galaxy S26+412 × 8913.5
galaxy-s26-ultraSamsung Galaxy S26 Ultra412 × 8913.5
pixel-9Google Pixel 9412 × 9152.625
pixel-9-proGoogle Pixel 9 Pro427 × 9523
pixel-9-pro-xlGoogle Pixel 9 Pro XL448 × 9973

Android emulation uses Chrome's frozen Android User-Agent, so the exact model isn't in the User-Agent string. The device is conveyed through UA Client Hints instead. Every device reports portrait orientation and five touch points.

FAQ & Troubleshooting

My emulatedDevice value returned a 400 error

emulatedDevice only works alongside emulationOs=android on a stealth or BQL route. Sending it on its own returns emulatedDevice requires emulationOs=android on a stealth request (a /stealth/* route or a BQL route). Add emulationOs=android to the URL.

I passed a device slug but the session reports a different phone

Slugs are case-sensitive and matched exactly. A typo, wrong casing, or a slug not in the table above is silently ignored, and Browserless picks a device automatically. Copy the slug verbatim from the table.

Can I emulate an iPhone or another non-listed device?

No. Only the Android devices listed above are supported — there is no iPhone, iOS, or Safari emulation, and custom device profiles aren't accepted.

Next steps