Skip to main content
GET
/
v1
/
sessions
/
{id}
/
cookies
Cookies
curl --request GET \
  --url https://api.example.com/v1/sessions/{id}/cookies \
  --header 'Content-Type: application/json' \
  --data '
{
  "cookies": "<string>",
  "format": "<string>",
  "merge": true
}
'

​
Cookies

Read cookies out of a live browser session or load cookies into one. Useful for persisting login state across sessions or seeding a session from a saved profile.

​
Export Cookies

GET /v1/sessions/{id}/cookies?format=json|netscape
​
format
string
default:"json"
json returns a JSON array of cookie objects. netscape returns a Netscape-format cookies.txt body (Content-Type: text/plain).
Response (format=json)
[
  {
    "name": "sid",
    "value": "abc123",
    "domain": "example.com",
    "path": "/",
    "expires": 1767225600,
    "httpOnly": true,
    "secure": true,
    "sameSite": "Lax"
  }
]

​
Import Cookies

POST /v1/sessions/{id}/cookies/import
​
cookies
string
required
Serialized cookie data (a JSON array string, or Netscape cookies.txt content).
​
format
string
default:"json"
json or netscape.
​
merge
boolean
default:"false"
When true, imported cookies are merged with the cookies already in the browser instead of being applied standalone.
Response
{ "data": { "imported": 12 } }

​
Errors

StatusMeaning
400Unknown format or unparseable cookie data.
404Session not found.
502Browser rejected the cookie operation.