webclaw

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.

Note
Use this only for sites and content you are allowed to access. Webclaw sends your cookies as they are; it does not log in for you or get past a paywall.

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

POST/v1/sessions

Save or replace the cookies for one site.

json
{
  "domain": "medium.com",
  "cookies": ["sid=...; uid=..."]
}
FieldTypeRequiredDescription
domainstringYesThe 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.
cookiesstring[]YesCookies 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.

json
{
  "domain": "medium.com",
  "cookie_names": ["sid", "uid"],
  "created_at": "2026-11-09T15:00:21Z",
  "updated_at": "2026-11-09T15:00:21Z"
}

List and delete

GET/v1/sessions

List your saved logins: domain, cookie names and dates.

DELETE/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
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=..."]
  }'

Get started

Ready to build? Start extracting.

Cancel anytime. One key for every format and endpoint.

View on GitHub