Pular para o conteúdo principal
Está tendo problemas para obter o token?
Entre em contato com o suporte

DataDome

Ver preço completo

Este tipo de captcha geralmente exige que o usuário resolva um quebra-cabeça movendo um slider para verificação.

Atenção!

  • Para executar esta tarefa, utilize os seus próprios proxies.

  • Se o proxy usar autenticação por IP, é necessário adicionar o endereço 65.21.190.34 à lista de permissões (whitelist).

  • Após a resolução, você receberá cookies especiais, que devem ser adicionados ao navegador.

Parâmetros da solicitação​

type<string>required

CustomTask

class<string>required

DataDome

websiteURL<string>required

URL da página principal onde o captcha será resolvido.

captchaUrl (dentro de metadata)<string>required

"captchaUrl" - link para o captcha. Normalmente no formato: "https://geo.captcha-delivery.com/captcha/?initialCid=...".

datadomeCookie (dentro de metadata)<string>required

Seus cookies do DataDome. Podem ser obtidos na página usando document.cookie (se os cookies não tiverem a flag HttpOnly), no cabeçalho da requisição Set-Cookie: "datadome=...", ou diretamente do código HTML initialCid (veja exemplos de como encontrar datadomeCookie).

datadomeVersion (dentro de metadata)<string>optional

Versão do método de resolução do DataDome. Quando definido como "new", é utilizado o método de resolução atualizado, com suporte para os scripts i.js e c.js (veja mais detalhes abaixo). Se o parâmetro não for especificado, será utilizado o método antigo, que oferece suporte apenas ao i.js.

proxyType<string>required

http - proxy http/https padrão;
https - use apenas se "http" não funcionar (necessário para alguns proxies customizados);
socks4 - proxy socks4;
socks5 - proxy socks5.

proxyAddress<string>required

Endereço IPv4/IPv6 do proxy. Não permitido:

  • proxies transparentes (onde o IP do cliente é visível);
  • proxies em máquinas locais.

proxyPort<integer>required

Porta do proxy.

proxyLogin<string>required

Login do servidor proxy.

proxyPassword<string>required

Senha do servidor proxy.

userAgent<string>optional

User-Agent do navegador.
Transmita apenas o UA atual do sistema operacional Windows. No momento, o válido é: userAgentPlaceholder

Método para criar tarefa​

Importante

Durante o carregamento da página, o DataDome pode usar um de dois scripts: c.js ou i.js. Antes de resolver, verifique qual script está carregado (DevTools → Network / HTML).

Opção com c.js:

Opção com i.js:

POST
https://api.capmonster.cloud/createTask

Requisição

{
  "clientKey": "API_KEY",
  "task": {
    "type": "CustomTask",
    "class": "DataDome",
    "websiteURL": "https://example.com",
    "userAgent": "userAgentPlaceholder",
    "metadata": {
      "captchaUrl": "https://geo.captcha-delivery.com/interstitial/?initialCid=AHrlqAAAAAMA9UvsL58YLqIAXNLFPg%3D%3D&hash=C0705ACD75EBF650A07FF8291D3528&cid=7sfa5xUfDrR4bQTp1c2mhtiD7jj9TXExcQypjdNAxKVFyIi1S9tE0~_mqLa2EFpOuzxKcZloPllsNHjNnqzD9HmBA4hEv7SsEyPYEidCBvjZEaDyfRyzefFfolv0lAHM&referer=https%3A%2F%2Fwww.example.com.au%2F&s=6522&b=978936&dm=cm",
      "datadomeCookie": "datadome=VYUWrgJ9ap4zmXq8Mgbp...64emvUPeON45z",
      "datadomeVersion": "new"
    },
    "proxyType": "http",
    "proxyAddress": "123.45.67.89",
    "proxyPort": 8080,
    "proxyLogin": "proxyUsername",
    "proxyPassword": "proxyPassword"
  }
}

Resposta

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

Método para obter o resultado da tarefa​

Use o método getTaskResult para obter a solução do captcha DataDome.

POST
https://api.capmonster.cloud/getTaskResult

Requisição

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

Resposta

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "domains": {
      "www.example.com": {
        "cookies": {
          "datadome": "P1w0VnjFcTFslfps0J4FaPpY_QPbPBW4MeYxj4LW~pztIfJiSSuBPr8oQTUHzdrfgv137FbOBd3kCUOOgny7LhIkhm5e1qdtzYM4s2e46U_qfERK4KiCy22MOSIDsDyh"
        },
        "localStorage": null
      }
    },
    "url": null,
    "fingerprint": null,
    "headers": null,
    "data": null
  }
}

Como encontrar datadomeCookie​

Usando DevTools​

Opção 1:

  1. Abra o site protegido pelo DataDome no navegador (Chrome, Firefox).

  2. Pressione F12 → vá para a aba Application → Cookies.

  3. Encontre o domínio do site (ex.: www.example.com).

Entre os cookies, procure a chave datadome — este é o parâmetro datadomeCookie necessário.

Opção 2:

  1. Abra o site onde o captcha DataDome é ativado.

  2. Vá para DevTools → Network, recarregue a página e encontre a requisição que carrega a página com initialCid.

Exemplo de URL:

https://geo.captcha-delivery.com/interstitial/?initialCid=...&hash=...&cid=...

ou:

  1. Abra a Response dessa requisição. No código HTML, encontre o objeto:

var ddm = { ... };

  1. Dentro deste objeto, localize o parâmetro cid. Seu valor é o datadomeCookie atual.

Opção 3:

  1. Abra o site onde o captcha DataDome é ativado.

  2. Vá para DevTools → Network, recarregue a página e encontre uma requisição com status 403.

  3. Vá para a aba Headers → Response Headers. Nos cabeçalhos, encontre Set-Cookie: e copie o valor do parâmetro datadome (datadome=<valor>).

Exemplo de solução automática do DataDome​

Atenção!

Os exemplos abaixo são fornecidos apenas para fins informativos e para demonstrar a lógica geral.

Como os sites diferem em seus mecanismos de proteção, estrutura de requisições e parâmetros, as soluções podem exigir adaptação adicional e testes para um recurso específico.

Mostrar código
// npm install axios cheerio https-proxy-agent

import axios from "axios";
import * as cheerio from "cheerio";
import { URL } from "url";
import { HttpsProxyAgent } from "https-proxy-agent";

// ======================================================
// CONFIGURAÇÕES
// ======================================================

// Ativa/desativa logs detalhados
// Usado apenas para conveniência durante o desenvolvimento e depuração
const DEBUG = true; 

const CAPMONSTER_API_KEY = "YOUR_API_KEY"; // Especifique sua chave de API do CapMonster Cloud
const PAGE_URL = "https://www.example.com/"; // Especifique a URL da página onde o DataDome é acionado

const USER_AGENT =
  "userAgentPlaceholder";

const PROXY_URL = "http://login:pass@address:port";

const CREATE_TASK = "https://api.capmonster.cloud/createTask";
const GET_RESULT = "https://api.capmonster.cloud/getTaskResult";

const MAX_WAIT = 120000;

// ======================================================
// LOGGER DE DEPURAÇÃO
// ======================================================

function log(title, data = null) {
  if (!DEBUG) return;

  console.log(`\n${"=".repeat(25)} ${title} ${"=".repeat(25)}`);

  if (typeof data === "object") console.log(JSON.stringify(data, null, 2));
  else if (data) console.log(data);

  console.log("=".repeat(70));
}

// ======================================================
// EXTRAÇÃO DO OBJETO DD
// ======================================================

function extractDD(html) {
  const $ = cheerio.load(html);
  const scripts = $("script").toArray();

  for (const s of scripts) {
    const text = $(s).html();
    if (text && text.includes("var dd=")) {
      try {
        const raw = text.split("var dd=")[1].split(";")[0].replace(/'/g, '"');
        return JSON.parse(raw);
      } catch (e) {
        return null;
      }
    }
  }

  return null;
}

// ======================================================
// MONTAGEM DA CAPTCHA URL
// ======================================================

function buildCaptchaUrl(dd) {
  const base = `https://${dd.host}/captcha/`;

  const params = new URLSearchParams({
    initialCid: dd.cid,
    hash: dd.hsh,
    cid: dd.cookie,
    t: dd.t,
    referer: PAGE_URL,
    s: dd.s,
    dm: "cd",
  });

  if (dd.e) params.append("e", dd.e);

  return base + "?" + params.toString();
}

// ======================================================
// TRABALHANDO COM CAPMONSTER CLOUD
// ======================================================

async function createTask(payload) {
  log("CREATE TASK REQUEST", payload);

  const { data } = await axios.post(CREATE_TASK, payload);

  log("CREATE TASK RESPONSE", data);

  return data.taskId;
}

async function waitResult(taskId) {
  const start = Date.now();

  while (true) {
    if (Date.now() - start > MAX_WAIT) throw new Error("CapMonster timeout");

    await new Promise((r) => setTimeout(r, 3000));

    const { data } = await axios.post(GET_RESULT, {
      clientKey: CAPMONSTER_API_KEY,
      taskId,
    });

    if (data.status === "processing") {
      console.log("... solving");
      continue;
    }

    if (data.status === "ready") return data.solution;

    if (data.errorId) throw new Error(JSON.stringify(data));
  }
}

// ======================================================
// SOLVER PRINCIPAL
// ======================================================

async function solveDataDome() {
  console.log("\nDataDome → CapMonster solver started (HTTP mode)\n");

  let agent = null;
  let parsedProxy = null;

  if (PROXY_URL) {
    parsedProxy = new URL(PROXY_URL);
    agent = new HttpsProxyAgent(PROXY_URL);
  }

  // 1. Primeira requisição
  console.log("Opening page...");

  const response = await axios.get(PAGE_URL, {
    headers: {
      "User-Agent": USER_AGENT,
      Accept:
        "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
      "Accept-Language": "en-US,en;q=0.9",
      "Cache-Control": "no-cache",
      Pragma: "no-cache",
      "Upgrade-Insecure-Requests": "1",
    },
    httpsAgent: agent,
    proxy: false, // importante ao usar httpsAgent
    validateStatus: () => true,
  });

  const html = response.data;

  log("STATUS", response.status);

  const dd = extractDD(html);

  if (!dd) {
    console.log("No DataDome detected.");
    return;
  }

  log("DD OBJECT", dd);

  if (dd.t === "bv") {
    console.log("Proxy banned. Change proxy.");
    return;
  }

  // 2. Montagem da captcha URL
  const captchaUrl = buildCaptchaUrl(dd);
  log("CAPTCHA URL", captchaUrl);

  //  3. Criação da tarefa no CapMonster Cloud
  const task = {
    type: "CustomTask",
    class: "DataDome",
    websiteURL: PAGE_URL,
    userAgent: USER_AGENT,
    metadata: {
      captchaUrl,
      datadomeCookie: `datadome=${dd.cookie}`,
      datadomeVersion: "new",
    },
  };

  if (PROXY_URL) {
    task.proxyType = "http";
    task.proxyAddress = parsedProxy.hostname;
    task.proxyPort = parseInt(parsedProxy.port);
    task.proxyLogin = parsedProxy.username;
    task.proxyPassword = parsedProxy.password;
  }

  const payload = {
    clientKey: CAPMONSTER_API_KEY,
    task,
  };

  const taskId = await createTask(payload);

  if (!taskId) {
    console.log("Failed to create task.");
    return;
  }

  const solution = await waitResult(taskId);

  log("SOLUTION", solution);

  console.log("\nDataDome solved successfully.\n");
}

solveDataDome().catch(console.error);
Mostrar código (Node.js + Playwright)
// npm install axios cheerio playwright

import axios from "axios";
import * as cheerio from "cheerio";
import { chromium } from "playwright";
import { URL } from "url";

// ======================================================
// CONFIGURAÇÕES
// ======================================================

// Ativa/desativa saída detalhada de logs
// Usado apenas para conveniência no desenvolvimento e depuração
const DEBUG = true;

const CAPMONSTER_API_KEY = "YOUR_API_KEY"  // Informe sua chave de API do CapMonster Cloud
const PAGE_URL = "https://www.example.com/" // Informe a URL da página onde o DataDome é acionado

const USER_AGENT =
  "userAgentPlaceholder";

const PROXY_URL = "http://login:pass@address:port" // Informe seu proxy

const CREATE_TASK = "https://api.capmonster.cloud/createTask";
const GET_RESULT = "https://api.capmonster.cloud/getTaskResult";

const MAX_WAIT = 120000;

// ======================================================
// LOGGER DE DEPURAÇÃO
// ======================================================

function log(title, data = null) {
  if (!DEBUG) return;

  console.log(`\n${"=".repeat(25)} ${title} ${"=".repeat(25)}`);

  if (typeof data === "object") console.log(JSON.stringify(data, null, 2));
  else if (data) console.log(data);

  console.log("=".repeat(70));
}

// ======================================================
// EXTRAÇÃO DO OBJETO DD
// ======================================================

function extractDD(html) {
  const $ = cheerio.load(html);
  const scripts = $("script").toArray();

  for (const s of scripts) {
    const text = $(s).html();
    if (text && text.includes("var dd=")) {
      try {
        const raw = text.split("var dd=")[1].split(";")[0].replace(/'/g, '"');
        return JSON.parse(raw);
      } catch (e) {
        return null;
      }
    }
  }

  return null;
}

// ======================================================
// MONTAGEM DA URL DA CAPTCHA
// ======================================================

function buildCaptchaUrl(dd) {
  const base = `https://${dd.host}/captcha/`;

  const params = new URLSearchParams({
    initialCid: dd.cid,
    hash: dd.hsh,
    cid: dd.cookie,
    t: dd.t,
    referer: PAGE_URL,
    s: dd.s,
    dm: "cd",
  });

  if (dd.e) params.append("e", dd.e);

  return base + "?" + params.toString();
}

// ======================================================
// TRABALHANDO COM CAPMONSTER CLOUD
// ======================================================

async function createTask(payload) {
  log("CREATE TASK REQUEST", payload);

  const { data } = await axios.post(CREATE_TASK, payload);

  log("CREATE TASK RESPONSE", data);

  return data.taskId;
}

async function waitResult(taskId) {
  const start = Date.now();

  while (true) {
    if (Date.now() - start > MAX_WAIT) throw new Error("CapMonster timeout");

    await new Promise((r) => setTimeout(r, 3000));

    const { data } = await axios.post(GET_RESULT, {
      clientKey: CAPMONSTER_API_KEY,
      taskId,
    });

    if (data.status === "processing") {
      console.log("... resolvendo");
      continue;
    }

    if (data.status === "ready") return data.solution;

    if (data.errorId) throw new Error(JSON.stringify(data));
  }
}

// ======================================================
// SOLVER PRINCIPAL (PLAYWRIGHT)
// ======================================================

async function solveDataDome() {
  console.log("\nDataDome → CapMonster solver iniciado\n");

  let proxyConfig = null;
  let parsedProxy = null;

  if (PROXY_URL) {
    parsedProxy = new URL(PROXY_URL);

    proxyConfig = {
      server: `http://${parsedProxy.hostname}:${parsedProxy.port}`,
      username: parsedProxy.username,
      password: parsedProxy.password,
    };
  }

  const browser = await chromium.launch({
    headless: false,
    proxy: proxyConfig,
  });

  const context = await browser.newContext({
    userAgent: USER_AGENT,
  });

  const page = await context.newPage();

  console.log("Abrindo página...");
  await page.goto(PAGE_URL, { waitUntil: "domcontentloaded" });

  const html = await page.content();
  const dd = extractDD(html);

  if (!dd) {
    console.log("DataDome não detectado.");
    await browser.close();
    return;
  }

  log("DD OBJECT", dd);

  if (dd.t === "bv") {
    console.log("Proxy banido. Troque o proxy.");
    await browser.close();
    return;
  }

  const captchaUrl = buildCaptchaUrl(dd);
  log("CAPTCHA URL", captchaUrl);

  const task = {
    type: "CustomTask",
    class: "DataDome",
    websiteURL: PAGE_URL,
    userAgent: USER_AGENT,
    metadata: {
      captchaUrl,
      datadomeCookie: `datadome=${dd.cookie}`,
      datadomeVersion: "new",
    },
  };

  if (PROXY_URL) {
    task.proxyType = "http";
    task.proxyAddress = parsedProxy.hostname;
    task.proxyPort = parseInt(parsedProxy.port);
    task.proxyLogin = parsedProxy.username;
    task.proxyPassword = parsedProxy.password;
  }

  const payload = {
    clientKey: CAPMONSTER_API_KEY,
    task,
  };

  const taskId = await createTask(payload);

  if (!taskId) {
    console.log("Falha ao criar tarefa.");
    await browser.close();
    return;
  }

  const solution = await waitResult(taskId);
  log("SOLUTION", solution);

  await browser.close();
}

solveDataDome().catch(console.error);

Usar biblioteca SDK​

Mostrar Código (para navegador)
// https://github.com/ZennoLab/capmonstercloud-client-js

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

const API_KEY = "YOUR_API_KEY"; // Insira sua chave de API do CapMonster Cloud

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

    // Se necessário, você pode verificar o saldo 
    const balance = await client.getBalance();
    console.log("Balance:", balance);

    // DataDome é resolvido apenas com seus proxies
    const proxy = {
        proxyType: "http",
        proxyAddress: "123.45.67.89",
        proxyPort: 8080,
        proxyLogin: "username",
        proxyPassword: "password"
    };

    const datadomeRequest = new DataDomeRequest({
        _class: 'DataDome',
        websiteURL: "https://example.com/", // URL da página com a captcha
        userAgent: "userAgentPlaceholder",
        proxy,
        metadata: {
            captchaUrl: "https://geo.captcha-delivery.com/interstitial/?initialCid=AHrlqAAAAAMA9UvsL58YLqIAXNLFPg%3D%3D&hash=C0705ACD75EBF650A07FF8291D3528&cid=7sfa5xUfDrR4bQTp1c2mhtiD7jj9TXExcQypjdNAxKVFyIi1S9tE0~_mqLa2EFpOuzxKcZloPllsNHjNnqzD9HmBA4hEv7SsEyPYEidCBvjZEaDyfRyzefFfolv0lAHM&referer=https%3A%2F%2Fwww.example.com.au%2F&s=6522&b=978936&dm=cm",
            datadomeCookie: "datadome=VYUWrgJ9ap4zmXq8Mgbp...64emvUPeON45z"
        }
    });

    const result = await client.Solve(datadomeRequest);
    console.log("Solution:", result);
});
Mostrar Código (Node.js)
// https://github.com/ZennoLab/capmonstercloud-client-js

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

const API_KEY = "YOUR_API_KEY"; // Insira sua chave de API do CapMonster Cloud

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

    // Se necessário, você pode verificar o saldo 
    const balance = await client.getBalance();
    console.log("Balance:", balance);

    // DataDome é resolvido apenas com seus proxies
    const proxy = {
        proxyType: "http",
        proxyAddress: "123.45.67.89",
        proxyPort: 8080,
        proxyLogin: "username",
        proxyPassword: "password"
    };

    const datadomeRequest = new DataDomeRequest({
        _class: 'DataDome',
        websiteURL: "https://example.com/", // URL da página com a captcha
        userAgent: "userAgentPlaceholder",
        proxy,
        metadata: {
            captchaUrl: "https://geo.captcha-delivery.com/interstitial/?initialCid=AHrlqAAAAAMA9UvsL58YLqIAXNLFPg%3D%3D&hash=C0705ACD75EBF650A07FF8291D3528&cid=7sfa5xUfDrR4bQTp1c2mhtiD7jj9TXExcQypjdNAxKVFyIi1S9tE0~_mqLa2EFpOuzxKcZloPllsNHjNnqzD9HmBA4hEv7SsEyPYEidCBvjZEaDyfRyzefFfolv0lAHM&referer=https%3A%2F%2Fwww.example.com.au%2F&s=6522&b=978936&dm=cm",
            datadomeCookie: "datadome=VYUWrgJ9ap4zmXq8Mgbp...64emvUPeON45z"
        }
    });

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

solveDataDome().catch(console.error);
O artigo foi útil?
Confira os preços do solucionador de CAPTCHA com IA