{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Cloud Browser","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cloud-browser","__idx":0},"children":["Cloud Browser"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start, stop, connect to, and manage cloud browser environments programmatically through the MoreLogin API."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Cloud Browser API runs a MoreLogin browser profile on a remote host. After you start an environment, you connect to it over the Chrome DevTools Protocol (CDP) and drive it with automation frameworks such as Puppeteer, Playwright, or Selenium."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cloud Browser supports two API access methods:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Base URL"},"children":["Base URL"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Use Case"},"children":["Use Case"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Open API"]}," (Remote)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.morelogin.com"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access from anywhere, OAuth2 authentication"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Local API"]}," (Local)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["http://127.0.0.1:40000"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access from the machine running MoreLogin client"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Open API"]}," if you need remote access or server-to-server integration."," ","Choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Local API"]}," if you are running automation on the same machine as the MoreLogin client."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For authentication details, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/getting-started/authentication"},"children":["Authentication"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"capabilities","__idx":2},"children":["Capabilities"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Start a cloud browser environment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Stop"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stop a running environment, optionally forcing release"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Page"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query environments by page with filters for name, group, and keyword"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get the CDP address for a running environment to attach automation tools"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"typical-workflow","__idx":3},"children":["Typical Workflow"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start"]}," the environment with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envId"]},". The environment enters the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STARTING"]}," state."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Poll"]}," the paginated list until ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cloudBrowserStatus"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RUNNING"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]}," to retrieve the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdpUrl"]},", then attach Puppeteer / Playwright / Selenium over CDP."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Stop"]}," the environment when the automation finishes."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"environment-status","__idx":4},"children":["Environment Status"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STARTING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Starting up"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RUNNING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Running"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLOSED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Closed"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connection-details","__idx":5},"children":["Connection Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The connect endpoint returns two addresses:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 0,\n  \"msg\": null,\n  \"data\": {\n    \"cdpUrl\": \"https://runtime1.morelogin.com:16167?token=c62fedaaac524e41a0f02fc4345d41cb\",\n    \"accessUrl\": \"https://official-website.morelogin.com/browser-remote?token=eyJkZXNrdG9wVXJsIjoi...ZW52SWQiOiIyMDczMzk1NDg5NzM4OTE5OTM2In0%3D&envName=P-1267&lang=en-US\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdpUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CDP endpoint with the access ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token"]},". Pass it to Puppeteer, Playwright, or Selenium."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accessUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Browser-based remote desktop page for viewing and controlling the session. Empty if not configured."]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accessUrl"]}," token is a Base64-encoded payload carrying the desktop URL, desktop token, expiry, and team, user, member, and environment IDs. Treat both URLs as credentials and do not share them."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-reference","__idx":6},"children":["API Reference"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API"},"children":["API"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/cloud-browser/open-api"},"children":["Cloud Browser Open API"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remote access via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.morelogin.com"]},", OAuth2 authentication"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/cloud-browser/local-api"},"children":["Cloud Browser Local API"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Local access via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["http://127.0.0.1:40000"]},", token authentication"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note"]},": Both APIs expose the same operations. Local API paths use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/cloudbrowser/..."]}," prefix, while Open API paths use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/cloudbrowser/..."]},". Always refer to the specific API reference for exact paths and parameters."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-guides","__idx":7},"children":["Related Guides"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Guide"},"children":["Guide"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/getting-started/authentication"},"children":["Authentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth2 token setup (Open API) and token auth (Local API)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/getting-started/quickstart"},"children":["Quickstart"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run your first MoreLogin API call"]}]}]}]}]}]},"headings":[{"value":"Cloud Browser","id":"cloud-browser","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Capabilities","id":"capabilities","depth":2},{"value":"Typical Workflow","id":"typical-workflow","depth":2},{"value":"Environment Status","id":"environment-status","depth":2},{"value":"Connection Details","id":"connection-details","depth":2},{"value":"API Reference","id":"api-reference","depth":2},{"value":"Related Guides","id":"related-guides","depth":2}],"frontmatter":{"seo":{"title":"Cloud Browser"}},"lastModified":"2026-08-05T03:07:19.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/cloud-browser","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}