Saved logins
Read pages that your own subscription or account covers, such as member-only articles. Save the cookies of a site you are signed in to, and Webclaw sends them whenever it fetches that site for you through/v1/scrape, /v1/batch and the hosted MCP server. Your agents never see the cookies, and you never share a password. You can also manage saved logins in the dashboard under Saved logins.
Get your cookies
Sign in to the site in your browser, open DevTools, go to the Network tab and reload the page. Click the page request and copy the value of the Cookie request header. Paste the whole value; Webclaw splits it into name=value pairs.
Save a login
/v1/sessionsSave or replace the cookies for one site.
{
"domain": "medium.com",
"cookies": ["sid=...; uid=..."]
}| Field | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | The site's host name, without https:// or a path. A saved login for medium.com also applies to its subdomains, such as towardsdatascience.medium.com. |
cookies | string[] | Yes | Cookies as name=value strings, or a whole Cookie header pasted from the browser. Up to 100 pairs and 8 KB. Saving the same domain again replaces the cookies. |
The response lists the cookie names, never their values. Values are encrypted at rest and cannot be read back.
{
"domain": "medium.com",
"cookie_names": ["sid", "uid"],
"created_at": "2026-11-09T15:00:21Z",
"updated_at": "2026-11-09T15:00:21Z"
}List and delete
/v1/sessionsList your saved logins: domain, cookie names and dates.
/v1/sessions/{domain}Delete the saved login for one domain.
How it is used
- A scrape, batch or MCP request for a URL on that domain sends the saved cookies, and the result includes
"authenticated": true. - Cookies go only to that site. If the site redirects to another host, the cookies are not sent there.
- Logged-in results are never cached or shared with other requests, and request logs store cookies as [redacted].
- Pages that need a browser to render, screenshots and browser actions do not use saved logins.
- Signing out of the site, or the cookies expiring, ends the saved login. Save fresh cookies when that happens.
One-off cookies
To send cookies for a single request without saving them, passcookies to /v1/scrape. They override any saved login for that request.
curl -X POST https://api.webclaw.io/v1/scrape \
-H "Authorization: Bearer wc_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://medium.com/@author/article-id",
"cookies": ["sid=...; uid=..."]
}'