Prosopo Procaptcha

View full price

Attention!

CapMonster Cloud uses built-in proxies by default — their cost is already included in the service. You only need to specify your own proxies in cases where the website does not accept the token or access to the built-in services is restricted.

If you are using a proxy with IP authorization, make sure to whitelist the address 65.21.190.34.

The token-based automatic CAPTCHA solving method Prosopo Procaptcha.

Request parameters

type<string>required

ProsopoTask

---

websiteURL<string>required

The full URL of the CAPTCHA page.

---

websiteKey<string>required

The value of the siteKey parameter found on the page.

---

proxyType<string>optional

http - 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>optional

IPv4/IPv6 proxy IP address. Not allowed:

• using transparent proxies (where you can see the client's IP);
• using proxies on local machines.

---

proxyPort<integer>optional

Proxy port.

---

proxyLogin<string>optional

Proxy-server login.

---

proxyPassword<string>optional

Proxy-server password.

Create task method

ProsopoTask (without proxy)

POST

https://api.capmonster.cloud/createTask

Request

{
	"clientKey": "API_KEY",
	"task": 
	{
		"type": "ProsopoTask",
		"websiteURL": "https://www.example.com",
		"websiteKey": "5EZU3LG31uzq1Mwi8inwqxmfvFDpj7VzwDnZwj4Q3syyxBwV"
	}
}

Response

{
	"errorId":0,
	"taskId":407533077
}

ProsopoTask (with proxy)

POST

https://api.capmonster.cloud/createTask

Request

{
	"clientKey": "API_KEY",
	"task": 
	{
		"type": "ProsopoTask",
		"websiteURL": "https://www.example.com",
		"websiteKey": "5EZU3LG31uzq1Mwi8inwqxmfvFDpj7VzwDnZwj4Q3syyxBwV",
		"proxyType":"http",
		"proxyAddress":"8.8.8.8",
		"proxyPort":8080,
		"proxyLogin":"proxyLoginHere",
		"proxyPassword":"proxyPasswordHere"
	}
}

Response

{
	"errorId":0,
	"taskId":407533077
}

Get task result method

Use the method getTaskResult to obtain the Prosopo solution.

POST

https://api.capmonster.cloud/getTaskResult

Request

{
	"clientKey":"API_KEY",
	"taskId": 407533077
}

Response

{
	"errorId":0,
	"status":"ready",
	"solution": 
	{
		"token": "0x00016c68747470733a2f2f70726f6e6f6465332e70726f736f706f2e696fc0354550516f4d5a454463354c704e376774784d4d7a5950547a4136..."
	}
}

How to find the websiteKey

1. Open the site where the Prosopo captcha is triggered.

2. Go to Developer Tools (DevTools) → Network, reload the page, and look for a request that loads an image (for example, an API request like https://example.prosopo.io/v1/prosopo/provider/client/captcha/image).

3. In Request Headers, find the Prosopo-Site-Key parameter, copy its value, and use it when creating the request.

Use the SDK library

JavaScript

Show code (for browser)

// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, ProsopoRequest } from '@zennolab_com/capmonstercloud-client';

const API_KEY = "YOUR_API_KEY"; // Specify your CapMonster Cloud API key

document.addEventListener("DOMContentLoaded", async () => {
  const client = CapMonsterCloudClientFactory.Create(
      new ClientOptions({ clientKey: API_KEY })
  );

  // Basic example without proxy
  // CapMonster Cloud automatically uses its own proxies
  let prosopoRequest = new ProsopoRequest({
      websiteURL: "https://www.example.com",       // URL of the page with ProCaptcha
      websiteKey: "5EZU3LG31uzq1Mwi8inwqxmfvFDpj7VzwDnZwj4Q3syyxBwV" // Your ProCaptcha sitekey (public key)
  });

  // Example of using your own proxy
  // Uncomment this block if you want to use your own proxy
  /*
  const proxy = {
      proxyType: "http",
      proxyAddress: "123.45.67.89",
      proxyPort: 8000,
      proxyLogin: "username",
      proxyPassword: "password"
  };

  prosopoRequest = new ProsopoRequest({
      websiteURL: "https://www.example.com",      
      websiteKey: "5EZU3LG31uzq1Mwi8inwqxmfvFDpj7VzwDnZwj4Q3syyxBwV",
      proxy,
      userAgent: "userAgentPlaceholder"
  });
  */

  // Optionally, you can check the balance
  const balance = await client.getBalance();
  console.log("Balance:", balance);

  const result = await client.Solve(prosopoRequest);
  console.log("Solution:", result);
});

Show code (Node.js)

// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, ProsopoRequest } from '@zennolab_com/capmonstercloud-client';

const API_KEY = "YOUR_API_KEY"; // Specify your CapMonster Cloud API key

async function solveProCaptcha() {
    const client = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: API_KEY })
    );

    // Basic example without proxy
    // CapMonster Cloud automatically uses its own proxies
    let prosopoRequest = new ProsopoRequest({
        websiteURL: "https://www.example.com",       // URL of the page with ProCaptcha
        websiteKey: "5EZU3LG31uzq1Mwi8inwqxmfvFDpj7VzwDnZwj4Q3syyxBwV" // Your ProCaptcha sitekey (public key)
    });

    // Example of using your own proxy
    // Uncomment this block if you want to use your own proxy
    /*
    const proxy = {
        proxyType: "http",
        proxyAddress: "123.45.67.89",
        proxyPort: 8000,
        proxyLogin: "username",
        proxyPassword: "password"
    };

    prosopoRequest = new ProsopoRequest({
        websiteURL: "https://www.example.com",      
        websiteKey: "5EZU3LG31uzq1Mwi8inwqxmfvFDpj7VzwDnZwj4Q3syyxBwV",
        proxy,
        userAgent: "userAgentPlaceholder"
    });
    */

    // Optionally, you can check the balance
    const balance = await client.getBalance();
    console.log("Balance:", balance);

    const result = await client.Solve(prosopoRequest);
    console.log("Solution:", result);
}

solveProCaptcha().catch(console.error);

Python

Show code

# https://github.com/ZennoLab/capmonstercloud-client-python

import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import ProsopoTaskRequest
# from capmonstercloudclient.requests.baseRequestWithProxy import ProxyInfo  # Uncomment if you plan to use a proxy

API_KEY = "YOUR_API_KEY"  # Specify your CapMonster Cloud API key

async def solve_prosopo_captcha():
    client_options = ClientOptions(api_key=API_KEY)
    cap_monster_client = CapMonsterClient(options=client_options)

    # Basic example without proxy
    # CapMonster Cloud automatically uses its own proxies
    prosopo_request = ProsopoTaskRequest(
        websiteUrl="https://www.example.com",  
        websiteKey="5EZU3LG31uzq1Mwi8inwqxmfvFDpj7VzwDnZwj4Q3syyxBwV"
    )

    # Example of using your own proxy
    # Uncomment this block if you want to use your own proxy
    # proxy = ProxyInfo(
    #     proxyType="http",
    #     proxyAddress="123.45.67.89",
    #     proxyPort=8080,
    #     proxyLogin="username",
    #     proxyPassword="password"
    # )
    #
    # prosopo_request = ProsopoTaskRequest(
    #     websiteUrl="https://www.example.com",
    #     websiteKey="5EZU3LG31uzq1Mwi8inwqxmfvFDpj7VzwDnZwj4Q3syyxBwV",
    #     proxy=proxy
    # )

    # Optionally, you can check the balance
    balance = await cap_monster_client.get_balance()
    print("Balance:", balance)

    result = await cap_monster_client.solve_captcha(prosopo_request)
    print("Solution:", result)

asyncio.run(solve_prosopo_captcha())

C#

Show code

// https://github.com/ZennoLab/capmonstercloud-client-dotnet

using System;
using System.Threading.Tasks;
using Zennolab.CapMonsterCloud;
using Zennolab.CapMonsterCloud.Requests;

class Program
{
    static async Task Main(string[] args)
    {
        // Specify your CapMonster Cloud API key
        var clientOptions = new ClientOptions
        {
            ClientKey = "YOUR_API_KEY"
        };

        var cmCloudClient = CapMonsterCloudClientFactory.Create(clientOptions);

        // Basic example without proxy
        // CapMonster Cloud automatically uses its own proxies
        var prosopoRequest = new ProsopoTaskRequest
        {
            WebsiteUrl = "https://www.example.com",      // URL of the page with ProCaptcha
            WebsiteKey = "5DCKg3w9AvDW92uBzRWrvTiWsu573bTzYmFny8EkXQZxsBib", // Your ProCaptcha sitekey (public key)

            UserAgent = "userAgentPlaceholder"
        };

        // Example of using your own proxy
        // Uncomment this block if you want to use your own proxy
        /*
        prosopoRequest = new ProsopoTaskRequest
        {
            WebsiteUrl = "https://www.example.com",
            WebsiteKey = "5DCKg3w9AvDW92uBzRWrvTiWsu573bTzYmFny8EkXQZxsBib",
            UserAgent = "userAgentPlaceholder",

            Proxy = new ProxyContainer(
                "123.45.67.89",   
                8080,             
                ProxyType.Http,  
                "username", 
                "password"
            )
        };
        */

        // Optionally, you can check the balance
        var balance = await cmCloudClient.GetBalanceAsync();
        Console.WriteLine("Balance: " + balance);

        var prosopoResult = await cmCloudClient.SolveAsync(prosopoRequest);

        Console.WriteLine("ProCaptcha Solution: " + prosopoResult.Solution.Value);
    }
}