Proton Captcha
Proton Captcha is a security system used on Proton services to verify legitimate user activity and protect against automated actions. Proxy is required to solve this captcha type.
Request parameters
type<string>requiredCustomTask
class<string>requiredproton
websiteURL<string>requiredThe address of the main page where the captcha is located.
HumanVerificationToken (inside metadata)<string>requiredToken from the response.
pageAction (inside metadata)<string>requiredAction on the site: login or signup
userAgent<string>optionalBrowser User-Agent. Use the current value supported by CapMonster Cloud: userAgentPlaceholder
You can get the latest value at: https://capmonster.cloud/api/useragent/actual.
proxyType<string>requiredhttp - regular http/https proxy;
https - try this option only if "http" doesn't work (required for some custom proxies);
socks4 - socks4 proxy;
socks5 - socks5 proxy.
proxyAddress<string>requiredIPv4/IPv6 proxy IP address. Not allowed:
- using transparent proxies (where you can see the client's IP);
- using proxies on local machines.
proxyPort<integer>requiredProxy port.
proxyLogin<string>requiredProxy server login.
proxyPassword<string>requiredProxy server password.
Create task method
https://api.capmonster.cloud/createTask
Request example
{
"clientKey": "API_KEY",
"task": {
"type": "CustomTask",
"class": "proton",
"websiteURL": "https://yourwebsite.com/",
"userAgent": "userAgentPlaceholder",
"metadata": {
"HumanVerificationToken": "your-verification-token",
"pageAction": "login"
},
"proxyType": "http",
"proxyAddress": "8.8.8.8",
"proxyPort": 8080,
"proxyLogin": "proxyLoginHere",
"proxyPassword": "proxyPasswordHere"
}
}
Response example
{
"errorId": 0,
"taskId": 407533072
}
Get task result method
Use the method getTaskResult to obtain the Proton Captcha solution.
https://api.capmonster.cloud/getTaskResult
Request example
{
"clientKey":"API_KEY",
"taskId": 407533072
}
Response example
{
"errorId": 0,
"cost": 0.001,
"status": "ready",
"solution": {
"data": {
"tokens": "TOKEN_VALUE_HERE....."
}
}
}
How to find the HumanVerificationToken
- Open the page with Proton Captcha.
- Open Developer Tools (F12 or right-click → Inspect).
- Go to the Network tab and perform the action that triggers the captcha.
- Look for a request that returns the
HumanVerificationTokenin the response body. - Copy the token value and pass it in the
metadata.HumanVerificationTokenfield.
How to find the pageAction
The pageAction parameter depends on the action being performed on the website:
- Use
loginwhen the user is logging in - Use
signupwhen the user is creating a new account
