Cookies

Persistent profiles save cookies by default. You only need the cookie endpoints when transferring cookies between a profile and another system. For ordinary login reuse, start the same persistent profile. Use these endpoints on a stopped profile. To inspect or change cookies in a running browser, use your framework’s cookie API in the existing context.

Export

curl --fail-with-body \
  "$SURFSKY_API_BASE_URL/profiles/PROFILE_UUID/cookies?export_format=json" \
  -H "X-Cloud-Api-Token: $SURFSKY_API_TOKEN"

JSON export returns an array in data.cookies; export_format=netscape returns cookie-file text. Example JSON export, with a redacted value:

{
  "success": true,
  "msg": "Cookies were exported",
  "data": {
    "cookies": [
      {
        "domain": ".example.com",
        "name": "session",
        "value": "REDACTED",
        "path": "/",
        "secure": true,
        "httpOnly": true
      }
    ]
  }
}

cookies_not_found means there are no stored cookies to export. cookies_disabled means cookie storage is disabled for the profile.

Import

Send the cookies as a string, either a serialized JSON array or Netscape text:

curl --fail-with-body \
  "$SURFSKY_API_BASE_URL/profiles/PROFILE_UUID/cookies" \
  -H "X-Cloud-Api-Token: $SURFSKY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cookies": "[{\"domain\":\".example.com\",\"name\":\"session\",\"value\":\"YOUR_COOKIE_VALUE\",\"path\":\"/\",\"secure\":true}]"}'

Importing an expired cookie does not renew the website’s session. At profile creation, cookies also accepts an array:

{
  "title": "my profile",
  "fingerprint": { "os": "win" },
  "cookies": [
    {
      "domain": ".example.com",
      "name": "session",
      "value": "YOUR_COOKIE_VALUE",
      "path": "/"
    }
  ]
}

Cookie values can grant access to signed-in accounts. Store exports securely and redact them from logs and support requests.

Sessions that will not stay logged in

Check the state restored by the next run:

Check	What to do
The profile is one-time	Create a persistent profile and reuse its saved UUID.
The profile was still running	A start request on a running profile returns that session and ignores new settings. Stop it, then start again.
The site stores authentication in local storage	Enable `storage_options.localstorage` before signing in again.
The previous session ended in a crash or failure	State after the last saved stop is lost. Sign in again and wait for the stop response before restarting.
The cookie has expired or been revoked	Authenticate again; restoring the cookie cannot extend its validity.
The site asks to verify a new device or location	Check for changes to the fingerprint or proxy IP.

Service workers can also hold application state. Enable storage_options.serviceworkers if the site needs it. The storage options table lists all defaults.

Get started

Connect your tools

Browser sessions

Browser actions

CAPTCHA guides

Debugging

Performance and limits

About Surfsky

Export

Import

Sessions that will not stay logged in

​Export

​Import

​Sessions that will not stay logged in

Export

Import

Sessions that will not stay logged in