Skip to main content
A profile keeps cookies and local storage under a name, so a later session starts signed in. It saves when the session closes. A scrape and a batch take the same profile field, so a login saved here also works there.
A name that does not exist is created. Sign in with Execute or your own CDP client, then close the session to save. Open the next session with the same name to load it. A profile also keeps the country it first used. A different location.country opens in the profile’s country and returns a warning.

Manage profiles

All profile calls are free.

Extensions

Upload a Chrome extension once, then load it into any session. Uploads, lists, reads and deletes are free. Send a Manifest V3 zip of up to 50 MiB, with manifest.json at its root, in a multipart field named file.
The answer is 201 with id, name and version, read from manifest.json. Keep id. There is no update: upload again for a new id. Open a session with "extensionIds": ["<id>"], up to 3, each once. They load before the first page opens and cannot change while the session runs. The answer lists each id, runtimeId and version in the order you sent them. Use runtimeId in chrome-extension://{runtimeId}/ addresses. An extension runs only in sessions that load it, and changes what sites can see. You can keep 100 extensions.

Errors

  • A second session saving to the same profile: 409 profileBusy, retryable. Wait for the first to close, or send saveChanges: false.
  • A profile too large to save: 413 profileTooLarge.
  • A taken name on create or rename, or a rename while a session saves: 409 invalidRequest. An unknown name: 404 notFound.
  • profile with zeroDataRetention: 400 invalidRequest.
  • A manifest with a key field, or the debugger, proxy, processes, dns, experimental or enterprise.* permission: 400 prohibitedPermission.
  • An unknown or deleted extension id: 404 notFound. More than 3 ids, or the same id twice: 400 invalidRequest.