reCAPTCHA v3 API Documentation

import axios from 'axios';

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://api.capresolve.com';

interface SolveRequest {
  site_url: string;
  site_key: string;
  action: string;
  kind: string;
  proxy?: string;
  referral?: string;
}

interface TaskResponse {
  task_id: string;
}

interface TokenResponse {
  token: string;
  status: string;
  user_agent: string;
  sec_ch_ua: string;
}

async function createSolveTask(request: SolveRequest): Promise<string> {
  const response = await axios.post<TaskResponse>(
    `${BASE_URL}/solve`,
    request,
    {
      headers: {
        'Content-Type': 'application/json',
        'api-key': API_KEY,
      },
    }
  );
  return response.data.task_id;
}

async function getResult(taskId: string): Promise<TokenResponse> {
  const response = await axios.get<TokenResponse>(
    `${BASE_URL}/solve/${taskId}`,
    {
      headers: {
        'api-key': API_KEY,
      },
    }
  );
  return response.data;
}

async function solveRecaptchaV3() {
  // Step 1: Create solve task
  const taskId = await createSolveTask({
    site_url: 'https://example.com',
    site_key: '6Le-wvkSAAAAAPBMRTvw0Q...',
    action: 'login',
    kind: 'recap_v3',
  });

  console.log('Job created:', taskId);

  // Step 2: Poll for result (with retry logic)
  let result: TokenResponse | null = null;
  for (let i = 0; i < 60; i++) {
    await new Promise(resolve => setTimeout(resolve, 1000));
    try {
      result = await getResult(taskId);
      if (result.token) break;
    } catch (e) {
      // Token not ready yet, continue polling
    }
  }

  if (result?.token) {
    console.log('Token received:', result.token);
    console.log('User-Agent:', result.user_agent);
  }
}

solveRecaptchaV3();

{
  "task_id": "abc123-def456-ghi789"
}