API Reference

자동화 API

Selenium · Playwright · Puppeteer에서 핑거프린트 적용된 Chrome을 5분 만에 띄우세요.

호출당 ₩5 · 하루 300번 사용해도 ₩1,500. 마이페이지에서 API 키 발급 + 포인트 충전 (1만/3만/5만/10만원 단위).

₩5
호출당
₩1,500
하루 300호출
₩45,000
월 9,000호출

빠른 시작 (5분)

  1. Antidetect 데스크톱 앱 설치 + 로그인
  2. 마이페이지에서 API 키 발급
  3. 같은 마이페이지에서 포인트 충전 (최소 1만원 = 2,000 호출)
  4. 아래 예시 코드 실행

두 가지 사용 모드

MODE 1

Persistent — 고정 페르소나

같은 프로필을 반복 사용. 매번 같은 fingerprint + 쿠키 유지 → 사이트가 "같은 사용자"로 인식.

적합: 계정 운영, 단일 페르소나, SEO 모니터링 등 "같은 신원으로 반복 방문"이 필요한 작업

MODE 2

Burst — 일회용 신원

1회 호출 = Antidetect 앱이 새 fingerprint Chrome 1개 띄움. 사용자는 debug port 받아서 Selenium/Puppeteer attach. 프로필 저장 안 됨, 종료 시 흔적 자동 정리.

적합: 광고 검증, 다중 신원 트래픽 시뮬레이션, 자기 사이트 부하 테스트

Mode 1 · Python (Selenium)

pip install antidetect-sdk selenium
from antidetect_sdk import Antidetect
from selenium import webdriver
from selenium.webdriver.chrome.options import Options

client = Antidetect(api_key="sk_xxx...")

# 1. 프로필 생성 (또는 기존 프로필 사용)
profile = client.create_profile("my-store-1")

# 2. Antidetect 앱이 fingerprint Chrome 띄움 (debug port 포함)
session = client.start_browser(profile["id"], headless=False)
# session = { sessionId, profileId, balance, debugAddress, wsEndpoint }

# 3. Selenium을 이미 띄워진 fingerprint Chrome에 attach (새 Chrome X)
opts = Options()
opts.add_experimental_option("debuggerAddress", session["debugAddress"])
driver = webdriver.Chrome(options=opts)

driver.get("https://example.com")
print(driver.title)

# 4. 종료 — Antidetect가 Chrome 관리. driver.quit() 호출 X.
client.stop_browser(session["sessionId"])
print(f"남은 포인트: {session['balance']}")

Mode 1 · Node.js (Puppeteer)

npm install @antidetect/sdk puppeteer
import { Antidetect } from '@antidetect/sdk';
import puppeteer from 'puppeteer';

const client = new Antidetect({ apiKey: 'sk_xxx...' });

const profile = await client.createProfile('my-store-1');
// Antidetect 앱이 fingerprint Chrome 띄움 → wsEndpoint 반환
const session = await client.startBrowser(profile.id);

// Puppeteer를 이미 띄워진 fingerprint Chrome에 attach
const browser = await puppeteer.connect({
  browserWSEndpoint: session.wsEndpoint
});
const page = await browser.newPage();
await page.goto('https://example.com');
console.log(await page.title());

// 종료 — disconnect만, close X (Antidetect가 관리)
browser.disconnect();
await client.stopBrowser(session.sessionId);
console.log(`남은 포인트: ${session.balance}`);

Mode 2 · Burst — Python (Selenium)

1회 호출 = Antidetect 앱이 새 fingerprint Chrome 1개 띄우고 debug port 반환. 사용자는 그 port 에 Selenium attach 만 하면 됨. fingerprint/proxy 노출 X. 호출당 ₩5 차감.

from antidetect_sdk import Antidetect
from selenium import webdriver
from selenium.webdriver.chrome.options import Options

client = Antidetect(api_key="sk_xxx...")

# 100명의 다른 "신원"으로 사이트 방문 (순차 — 동시 실행은 PC 성능 몫)
for i in range(100):
    s = client.launch_ephemeral(os="windows")
    # s = { sessionId, debugAddress, wsEndpoint, balance, autoLocalized }

    opts = Options()
    opts.add_experimental_option("debuggerAddress", s["debugAddress"])
    driver = webdriver.Chrome(options=opts)

    driver.get("https://example.com")
    print(f"#{i+1} title:", driver.title)

    # 종료 — driver.quit() 호출 X, stop_browser 만 (Antidetect가 Chrome + 임시 dir 정리)
    client.stop_browser(s["sessionId"])
    print(f"  잔액: {s['balance']}원")

Mode 2 · Burst — Node.js (Puppeteer)

import { Antidetect } from '@antidetect/sdk';
import puppeteer from 'puppeteer';

const client = new Antidetect({ apiKey: 'sk_xxx...' });

for (let i = 0; i < 100; i++) {
  const s = await client.launchEphemeral({ os: 'windows' });
  // s = { sessionId, debugAddress, wsEndpoint, balance, autoLocalized }

  const browser = await puppeteer.connect({ browserWSEndpoint: s.wsEndpoint });
  const page = await browser.newPage();
  await page.goto('https://example.com');
  console.log(`#${i+1} ${await page.title()} · 잔액: ${s.balance}`);

  // 종료 — disconnect만, close X (Antidetect가 정리)
  browser.disconnect();
  await client.stopBrowser(s.sessionId);
}

Mode 2 · 프록시 옵션

기본: rotating proxy 자동

아무것도 안 넘기면 우리 rotating proxy 풀에서 매 호출 새 IP 할당. IP geo 에 맞춰 timezone/언어 자동 매칭(예: 일본 IP → Asia/Tokyo + ja-JP). 사용자가 따로 timezone 안 박아도 일관됨.

사용자 proxy 직접 사용

자기 proxy 풀이 있으면 proxy 옵션으로 전달. 이 경우 timezone 자동매칭 안 됨 — timezone 옵션도 같이 지정 권장.

# client = Antidetect(api_key="sk_xxx...")  # 위 예시처럼 먼저 초기화
s = client.launch_ephemeral(
    os="windows",
    proxy={"server": "http://proxy.example.com:8080", "username": "u", "password": "p"},
    timezone="Asia/Tokyo",
    accept_language="ja-JP,ja;q=0.9",
)

에러 코드

CodeHTTP의미
MISSING_API_KEY401X-API-Key 헤더 없음
INVALID_KEY401API 키 형식 오류 또는 없음
LICENSE_REVOKED401라이선스 정지됨 (API도 자동 비활성)
INTEGRITY_FAILED401클라이언트 변조 감지 — 재발급 필요
INSUFFICIENT_POINTS402포인트 부족. 마이페이지에서 충전
RATE_LIMITED429분당 200회 초과 (서버) / 분당 100회 (로컬)
CLOUD_UNREACHABLE503우리 서버 일시 장애 — 자동 복구

제한 사항 · 권장 사용

⚠ Acceptable Use Policy

합법적 목적 (SEO 모니터링 · 시장 조사 · 광고 검증 · 자기 사이트 부하 테스트)에만 사용. 광고 클릭 부풀리기 · 가짜 트래픽 생성 · 대량 계정 자동 생성 · 사이트 이용약관 위반에 사용 적발 시 즉시 키 회수 + 환불 X + 형사 고발 가능합니다.