Quickstart

Submit a job and read its token in two requests.

Before you start

You need:

• An API token. See Authentication.
• The URL of a page on your site that runs reCAPTCHA v3.
• The public site key of that page.

Each job makes real requests to Google for the page you name. Use your own site.

1. Submit a job

   Send the page URL, the site key and the action that your page uses.

   curl https://api.bapsolver.xyz/v1/jobs \
     -H "Authorization: Bearer $BAPSOLVER_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "kind": "recap_v3",
       "url": "https://www.example.com/login",
       "siteKey": "YOUR_SITE_KEY",
       "action": "login"
     }'
   

   The API answers with 202 Accepted. The Location header and data.id give the job ID.

   {
     "ok": true,
     "requestId": "0f6c1d2e-8a4b-4c3d-9e1f-2a3b4c5d6e7f",
     "data": {
       "id": "3b1f7c9a-2d4e-4f6a-8b0c-1d2e3f4a5b6c",
       "kind": "recap_v3",
       "url": "https://www.example.com/login",
       "siteKey": "YOUR_SITE_KEY",
       "action": "login",
       "status": "queued",
       "createdAt": "2026-10-25T09:30:00.000Z"
     }
   }
   
2. Wait for the result

   Read the job with wait=20. The request returns when the job finishes, or after 20 seconds.

   curl "https://api.bapsolver.xyz/v1/jobs/JOB_ID?wait=20" \
     -H "Authorization: Bearer $BAPSOLVER_TOKEN"
   

   Repeat the request while status is queued or running.

3. Read the token

   When status is done, data.result holds the token:

   {
     "ok": true,
     "requestId": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
     "data": {
       "id": "3b1f7c9a-2d4e-4f6a-8b0c-1d2e3f4a5b6c",
       "kind": "recap_v3",
       "url": "https://www.example.com/login",
       "siteKey": "YOUR_SITE_KEY",
       "action": "login",
       "status": "done",
       "createdAt": "2026-10-25T09:30:00.000Z",
       "startedAt": "2026-10-25T09:30:00.012Z",
       "finishedAt": "2026-10-25T09:30:03.400Z",
       "result": {
         "token": "03AFcWeA...",
         "expiresAt": "2026-10-25T09:32:00.000Z",
         "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36",
         "acceptLanguage": "en-US,en;q=0.9",
         "secUa": "\"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\", \"Not.A/Brand\";v=\"99\"",
         "secUaMobile": "?0",
         "secUaPlatform": "\"Windows\""
       }
     }
   }
   

   When status is failed, data.error gives a code and a message. See Errors.

Full example

Node.js

const API = 'https://api.bapsolver.xyz';
const headers = {
  Authorization: `Bearer ${process.env.BAPSOLVER_TOKEN}`,
  'Content-Type': 'application/json',
};

async function getToken({ url, siteKey, action }) {
  const submit = await fetch(`${API}/v1/jobs`, {
    method: 'POST',
    headers,
    body: JSON.stringify({ kind: 'recap_v3', url, siteKey, action }),
  });
  if (!submit.ok) throw new Error((await submit.json()).error.code);
  let job = (await submit.json()).data;

  while (job.status === 'queued' || job.status === 'running') {
    const poll = await fetch(`${API}/v1/jobs/${job.id}?wait=20`, { headers });
    if (!poll.ok) throw new Error((await poll.json()).error.code);
    job = (await poll.json()).data;
  }
  if (job.status === 'failed') throw new Error(job.error.code);
  return job.result;
}

Next steps

Use the token

Send the token with the same browser identity.

Job kinds and proxies

Choose Enterprise, or send the job through your proxy.