---
title: "Opens a new browser page and navigates to a specified URL."
method: POST
path: "/openPage"
---

# Opens a new browser page and navigates to a specified URL.

`POST /openPage`

This function is the entry point for most web scraping tasks. It initializes a new browser instance, creates a page, and navigates to the provided URL. The function allows customization of viewport dimensions, headless mode, and local execution settings.

## Request body

- object
  - `body` object — Body of the openPage sls call
    - `arguments` object, required — Configuration options for opening a new page
      - `url` string, required — The URL to navigate to
      - `defaultViewport` object — Viewport dimensions
        - `width` integer, required — The width of the viewport in pixels
        - `height` integer, required — The height of the viewport in pixels
      - `headless` boolean — Whether to run in headless mode

## Response `200`

Successfully opened page and navigated to URL

- object
  - `browser` object, required — Puppeteer Browser instance
  - `page` object, required — Puppeteer Page instance

## Other responses

- `400` — Bad request - invalid input parameters
- `500` — Internal server error

## Changes

- **2025-07-11** `b7199116b192` — 1 warning
  - removed the request property `body/arguments/isLocal`
- **2025-07-10** `d193868de840` — 1 info
  - added the new optional request property `body/arguments/isLocal`

[Change history](https://skmtc.dev/microfox-ai/apis/chrome-browser-use/changes/openPage/post.md)

---

[API](https://skmtc.dev/microfox-ai/apis/chrome-browser-use.md) · [All operations](https://skmtc.dev/microfox-ai/apis/chrome-browser-use/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microfox-ai/chrome-browser-use/revisions/b9d32be518ee/schema)
