CAPTCHA 해결 API
EverySolve는 카탈로그에 52가지 챌린지 유형을 갖춘 CAPTCHA 해결 API입니다. 챌린지 유형과 필수 입력값을 담아 POST /api/v1/captcha로 요청을 보내면 됩니다. 결과 형식은 유형에 따라 다르며, 솔루션이 성공적으로 전달된 경우에만 비용을 지불합니다.
52 types성공적으로 해결된 CAPTCHA 1,000개당 $0.14–$4.589 솔루션 형식
챌린지 유형을 식별하는 방법
페이지에서 가장 확실한 단서부터 확인하세요. 대부분의 통합 방식은 요청을 보내기 전에 로드된 스크립트와 컨테이너 속성만으로 식별할 수 있습니다.
- 01페이지에 로드된 스크립트를 확인합니다. 챌린지 전용 스크립트 URL이 대개 가장 확실한 단서입니다.
- 02챌린지 컨테이너의 데이터 속성을 확인합니다.
data-sitekey같은 이름은 여러 위젯에서 공통으로 쓰이므로 스크립트에서 얻은 단서와 함께 판단하세요. - 03스크립트가 번들링되거나 난독화되어 있다면, 브라우저 런타임에 노출된 챌린지 전용 전역 객체를 확인합니다.
- 04대상 페이지가 로드되기 전에 전체 화면 차단 페이지가 나타난다면 챌린지 페이지 유형을 사용합니다. 이 유형은 보통 폼 토큰 대신 쿠키 값을 반환합니다.
- 05대상 페이지 없이 이미지나 질문만 있다면, 필요한 답변 형식에 따라 이미지, 텍스트, 좌표, 박스 또는 숫자 작업을 선택합니다.
curl -X POST https://api.everyinfra.com/api/v1/captcha \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type":"turnstile","website_url":"https://example.com","website_key":"SITE_KEY"}'
브랜드 챌린지 위젯
페이지나 폼에 삽입된 위젯으로, 보통 토큰이나 이름이 지정된 필드를 반환합니다.
Alibaba CAPTCHA
Alibaba Cloud CAPTCHA는 클릭, 슬라이더, 퍼즐 또는 기타 위험도 적응형 위젯 형태로 나타날 수 있습니다. Alibaba의 별도 페이지 수준 보호 기능과는 다릅니다. 반환된 토큰은 위젯 검증 플로우에 속하므로, 페이지 접근 쿠키로 취급하면 안 됩니다.
CaptchaFox
CaptchaFox는 사이트 키 기반 위젯입니다. 키를 복사하기 전에 해당 스크립트나 위젯 설정을 확인하십시오. 위젯 토큰을 반환하며, 페이지 접근 쿠키가 아닙니다. DOM에 sitekey라고 적혀 있다는 이유만으로 reCAPTCHA나 Turnstile 키를 재사용하지 마십시오.
Capy Puzzle CAPTCHA
Capy Puzzle CAPTCHA는 사이트 키를 사용하며, 배포별 API 서버를 가리킬 수 있습니다. 응답에는 captchakey, challengekey, answer 필드가 있으며 함께 읽어야 합니다. 단일 토큰이 아닙니다.
Friendly Captcha
Friendly Captcha는 작업 증명(proof-of-work) 방식 위젯으로, 자체 사이트 키와 선택적인 클라이언트 라이브러리 엔드포인트를 사용합니다. 위젯 토큰을 반환합니다. 사용자 조작이 거의 없다는 이유만으로 ALTCHA, MTCaptcha, invisible reCAPTCHA로 간주하면 안 됩니다.
Arkose Labs FunCaptcha
Arkose Labs FunCaptcha는 보통 Arkose 스크립트나 data-pkey/public-key 값으로 드러나며, 인터랙티브 3D 또는 시각적 과제를 제시할 수 있습니다. Arkose 세션 토큰을 반환하며, 보통 fc-token 필드로 사용됩니다. reCAPTCHA Enterprise 페이로드가 아닙니다.
GeeTest CAPTCHA
GeeTest는 CAPTCHA ID/사이트 키를 사용하며 적응형, 슬라이드, 클릭 등 다양한 형태의 챌린지를 표시할 수 있습니다. 결과는 하나의 일반 토큰이 아니라 captcha_id, lot_number, pass_token, gen_time, captcha_output 5개 필드로 구성된 검증 세트입니다.
hCaptcha
hCaptcha는 자체 data-sitekey가 있는 h-captcha 위젯이나 명시적인 hcaptcha.render 호출로 확인할 수 있습니다. API는 hCaptcha 응답을 gRecaptchaResponse에 담아 반환합니다. 필드 이름 때문에 위젯이 Google reCAPTCHA가 되는 것은 아닙니다.
Lemin CAPTCHA
Lemin CAPTCHA는 박스형 또는 invisible 모드로 렌더링되며, 사이트 키와 함께 선택적으로 컨테이너와 API 서버를 사용합니다. answer와 challenge_id를 함께 반환합니다. MTCaptcha나 Turnstile이 반환하는 단일 토큰처럼 다루지 마십시오.
MTCaptcha
MTCaptcha는 독자적인 위젯으로, 보통 MTCaptcha 사이트 키로 설정됩니다. 이름이 비슷하지만 Yandex SmartCaptcha와는 다릅니다. MTCaptcha 토큰을 반환합니다. Yandex SmartCaptcha는 Yandex Cloud 스크립트를 로드하고 smart-token을 사용하므로, 두 사이트 키는 서로 바꿔 쓸 수 없습니다.
Prosopo Procaptcha
Prosopo Procaptcha는 사이트 키 기반 위젯으로, 배포 설정에 따라 작업 증명 또는 시각적 챌린지를 제시할 수 있습니다. Procaptcha 토큰을 반환합니다. data-sitekey 속성이 있다는 것만으로 reCAPTCHA, hCaptcha, Turnstile이 되는 것은 아닙니다.
reCAPTCHA 이미지 그리드
reCAPTCHA 그리드 작업은 이미 추출된 이미지 질문을 해결합니다. 페이지를 탐색하거나 reCAPTCHA 사이트 토큰을 생성하지 않습니다. 일치하는 타일 인덱스를 objects에 담아 반환합니다. 인덱스는 왼쪽 위 타일을 0으로 하여 왼쪽에서 오른쪽으로, 한 행씩 차례로 셉니다. 위젯 토큰 전체 워크플로에는 recaptcha_v2를 사용하십시오.
reCAPTCHA v2
reCAPTCHA v2는 api.js로 로드되고 사이트 키로 설정되는 기존 체크박스형 또는 invisible v2 위젯입니다. 대상 폼에 사용할 gRecaptchaResponse를 반환합니다. v3는 점수 기반이며, Enterprise는 Enterprise 전용 컨텍스트와 함께 enterprise.js를 로드합니다.
reCAPTCHA v2 Enterprise
reCAPTCHA v2 Enterprise는 enterprise.js와 grecaptcha.enterprise로 로드되는 체크박스형 또는 정책 기반 Enterprise 키입니다. 이 경우에도 gRecaptchaResponse를 반환하지만, Enterprise 식별자와 페이로드를 기존 v2 api.js 값이나 점수 기반 v3 키와 섞어 쓰면 안 됩니다.
reCAPTCHA v3
reCAPTCHA v3는 점수 기반이며, 보통 v2 체크박스를 표시하지 않고 grecaptcha.execute로 실행됩니다. EverySolve는 Google의 평가 점수가 아니라 gRecaptchaResponse를 반환합니다. 토큰과 액션은 보호 대상 사이트의 백엔드가 평가합니다.
reCAPTCHA v3 Enterprise
reCAPTCHA v3 Enterprise는 enterprise.js와 grecaptcha.enterprise.execute를 통해 점수 기반 Enterprise 키를 사용합니다. Enterprise 평가용 gRecaptchaResponse를 반환합니다. v2 체크박스가 없으며, 둘 다 보이지 않는다는 이유만으로 기존 v3 api.js와 같은 것으로 보면 안 됩니다.
Tencent Tendi CAPTCHA
Tencent Tendi CAPTCHA는 captchaAppId/사이트 키를 사용하며, 인터랙티브 챌린지가 끝나면 ticket과 randstr을 반환할 수 있습니다. ticket과 randstr 파라미터는 함께 사용해야 합니다. reCAPTCHA 응답 토큰이나 페이지 접근 쿠키가 아닙니다.
Cloudflare Turnstile
Cloudflare Turnstile은 Turnstile 사이트 키로 설정하는 삽입형 위젯입니다. 관리형(managed), 비대화형(non-interactive), 비표시(invisible) 모드로 동작할 수 있습니다. cf-turnstile-response에 사용할 토큰을 반환합니다. 반면 Cloudflare 챌린지 페이지는 페이지 이동을 차단하고 clearance 쿠키 데이터를 반환합니다.
NetEase Yidun CAPTCHA
NetEase Yidun(NECaptcha라고도 함)은 자체 captchaId로 초기화되며 슬라이더, 클릭 또는 위험도에 따라 조정되는 챌린지를 제시할 수 있습니다. Yidun 토큰을 반환합니다. Yidun의 captchaId와 콜백 값은 Tencent의 ticket/randstr이나 GeeTest의 5개 필드 결과와 다릅니다.
전체 페이지 접근 챌린지
쿠키 값이나 요청 헤더 데이터로 해결되는 페이지 단위 차단입니다.
모바일 SDK용 Akamai Bot Manager
모바일 SDK 플로우입니다. 대상은 웹 페이지 위젯이 아니라 iOS 또는 Android 앱 패키지입니다. 센서 데이터, 사용자 에이전트, 기기 ID가 짝을 이룬 세트를 반환합니다. 이 세 값은 함께 사용해야 하며, Akamai 웹 플로우에서 반환되는 쿠키와는 다릅니다.
Akamai sec-cpt
sec-cpt 응답은 차단된 응답에 포함된 챌린지 쿠키와 JSON 페이로드로 구성된 Akamai 중간 챌린지입니다. 이 작업은 챌린지에 정의된 대기 시간이 지난 후 챌린지 토큰을 반환합니다. URL만 사용하는 Akamai 웹 쿠키 작업과는 별개입니다.
웹용 Akamai Bot Manager
브라우저 측 Akamai Bot Manager 플로우로, 삽입된 체크박스가 아니라 _abck나 bm_sz 같은 쿠키로 식별되는 경우가 많습니다. 결과는 같은 브라우저 워크플로에서 사용할 쿠키 문자열이며, 모바일 센서 데이터나 sec-cpt 토큰이 아닙니다.
Anubis
Anubis는 전체 페이지 방식의 작업 증명 게이트웨이로, 폼 위젯이 아니라 anubis_challenge 데이터와 진행 상황 페이지로 식별할 수 있습니다. 삽입형 위젯 토큰이 아닌 게이트웨이 쿠키를 반환합니다. 쿠키 유효 기간과 수락 여부는 여전히 보호 대상 사이트가 결정합니다.
AWS WAF CAPTCHA
AWS WAF CAPTCHA는 페이지 또는 애플리케이션 단위 챌린지로, 챌린지를 완료하면 브라우저 토큰을 발급합니다. 이 작업은 이후 요청에 사용할 쿠키 데이터를 반환합니다. aws_waf_classify는 챌린지 이미지 안의 위치만 식별하며 챌린지 통과 상태를 설정하지 않습니다.
Basilisk
Basilisk(FaucetPay CAPTCHA로도 알려짐)는 사이트 키 기반 위젯으로, 응답이 사용자 에이전트와 짝을 이룹니다. captcha_response는 user_agent와 함께 읽어야 합니다. reCAPTCHA나 Turnstile이 반환하는 단일 토큰이 아닙니다.
Castle
Castle은 위험 및 디바이스 인텔리전스 흐름으로, 눈에 보이는 이미지 퍼즐 대신 대상이 구조화된 메타데이터를 제공합니다. 토큰 세트를 반환합니다. 이 세트를 하나의 토큰으로 합치거나, 제품 이름만 보고 시각적 CAPTCHA라고 추정하지 마십시오.
Cloudflare 챌린지 페이지
Cloudflare 챌린지 페이지는 대상 페이지가 로드되기 전에 접근을 차단하며, 페이지에 삽입된 Turnstile 위젯과는 다릅니다. 결과는 clearance 자격 증명 같은 쿠키 데이터입니다. Turnstile은 이와 달리 사이트 키를 사용하고 폼 토큰을 반환합니다.
CyberSiARA
CyberSiARA는 대상 페이지와 마스터 URL 식별자로 삽입된 SiARA 챌린지를 식별합니다. 해당 SiARA 세션의 토큰을 반환하며, 일반적인 페이지 단위 봇 차단막을 통과하는 쿠키가 아닙니다.
DataDome CAPTCHA
DataDome CAPTCHA 작업은 차단된 세션에 이미 발급된 captcha_url에서 시작합니다. 해당 흐름에 묶인 쿠키 데이터를 반환합니다. datadome_interstitial은 CAPTCHA URL 대신 보호 대상 웹사이트 URL에서 시작합니다.
DataDome 인터스티셜
DataDome 인터스티셜은 보호 대상 URL에 접근할 때 나타나는 페이지 단위 차단이며, 독립적인 captcha_url 작업이 아닙니다. 쿠키 데이터를 반환합니다. 진행 중인 DataDome captcha_url이 이미 있다면 datadome을 사용하십시오.
F5 Shape
F5 Shape는 눈에 보이는 이미지 인식 작업이 아니라 보호 대상 페이지를 둘러싼 브라우저 보호 흐름입니다. 페이지 흐름에 사용할 쿠키 데이터를 반환합니다. f5_tspd는 별도의 TS 쿠키 계열이므로 이름만 보고 선택하면 안 됩니다.
F5 TS 보호
F5 TS 보호는 TS로 시작하는 쿠키와 BIG-IP 보호 모듈 관련 페이지 동작으로 알아볼 수 있습니다. 결과는 TS 계열 쿠키 데이터이며, F5 Shape 헤더나 삽입형 위젯 토큰이 아닙니다.
Imperva 챌린지
Imperva(이전 명칭 Incapsula)는 독립형 이미지 위젯이 아니라 브라우저 및 엣지 검사로 페이지를 보호합니다. 보호된 워크플로에 사용할 쿠키 데이터를 반환하며, 위젯 토큰이나 페이지 리소스 목록이 아닙니다.
Kasada
Kasada의 브라우저 흐름은 보호 대상 페이지에서 발생하는 x-kpsdk 요청과 관련 응답 헤더로 알아볼 수 있습니다. 브라우저 쿠키 문자열이 아니라 x-kpsdk-ct, x-kpsdk-cd, x-kpsdk-v, x-kpsdk-r, x-kpsdk-st 필드를 반환합니다.
Kasada 챌린지 데이터
Kasada 챌린지 데이터 생성은 보호 대상 URL로 이동하는 대신 구조화된 platform_inputs에서 시작합니다. x-kpsdk-cd와 함께 관련 ct, st 값을 반환합니다. URL과 프록시를 사용하는 브라우저 흐름에는 kasada를 사용하십시오.
PerimeterX 챌린지
PerimeterX(현재 HUMAN Security 소속)는 삽입형 체크박스가 아니라 페이지 단위 애플리케이션 보호 흐름입니다. 폼 토큰이나 보호 대상 사이트의 매물 정보가 아니라, 보호된 세션을 통과하기 위한 쿠키를 반환합니다.
이미지 및 질문 작업
입력이 이미 이미지나 프롬프트이고, 출력이 텍스트, 좌표, 박스 또는 숫자인 경우에 사용합니다.
오디오 CAPTCHA
이 작업은 오디오 CAPTCHA 페이로드를 텍스트로 변환합니다. 페이지에서 오디오를 가져오거나 이미지 챌린지를 해결하지는 않습니다. 텍스트를 반환합니다. 정지 이미지 속 문자는 image를, 글로 된 질문은 text_captcha를 사용하십시오.
AWS WAF 챌린지 분류
AWS WAF CAPTCHA 중 이미지 분류 부분으로, 챌린지 이미지와 화면에 표시된 지시문을 사용합니다. box 필드에 클릭 위치를 반환하며, AWS WAF 통과 쿠키는 반환하지 않습니다. 브라우저 상호작용은 여전히 호출하는 쪽에서 제어합니다.
BotDeflector
여기서 BotDeflector는 이미지 선택 작업입니다. icons로 보낸 아이콘을 body로 보낸 이미지에서 순서대로 찾아냅니다. 폼 토큰이나 브라우저 쿠키가 아닌 points를 반환하므로, 위치를 실제로 적용하는 것은 호출하는 쪽의 책임입니다.
바운딩 박스 CAPTCHA
바운딩 박스 작업은 하나의 원본 이미지에서 조건에 맞는 객체를 둘러싸는 사각형을 요구합니다. 사각형 좌표가 담긴 bounding_boxes를 반환합니다. 클릭 지점은 coordinates를, 타일이나 객체 선택은 recaptcha_grid를 사용하십시오.
좌표 클릭 CAPTCHA
좌표 작업은 이미지 안의 클릭 위치 하나 이상을 나타내며, 특정 CAPTCHA 업체에 종속되지 않습니다. 사각형, 텍스트, 드래그 거리가 아닌 좌표 지점을 반환합니다. 호출하는 쪽에서 이 지점을 원본 이미지 크기에 맞춰 적용합니다.
이미지 CAPTCHA
image 작업은 이미지 페이로드에서 문자를 인식합니다. 특정 브랜드 위젯 연동이 아닙니다. 인식된 텍스트를 반환합니다. 소리는 audio를, 글로 된 질문은 text_captcha를, 공간적인 답은 좌표 또는 박스 작업을 사용하십시오.
회전 CAPTCHA
회전 작업은 바로 세워야 하는 이미지 한 장을 받습니다. 범용 시각 작업입니다. angle을 숫자로 반환합니다. 드래그 거리는 slider를, 클릭은 coordinates를, 사각형은 bounding_box를 사용하십시오.
SHEIN CAPTCHA
SHEIN 작업은 일반 바운딩 박스 작업이 아니라 사이트 전용 아이콘 위치 인식 모델입니다. 일치하는 영역의 rects를 반환합니다. 다른 사이트의 이미지에는 적절한 범용 좌표 또는 박스 작업을 사용하십시오.
슬라이더 CAPTCHA
슬라이더 작업은 배경 이미지와 별도의 퍼즐 조각을 사용해 퍼즐 조각을 얼마나 이동해야 하는지 계산합니다. 좌표, 백분율, 토큰, 드래그 궤적이 아닌 픽셀 단위 distance를 반환합니다. 상호작용 경로는 호출하는 쪽에서 만듭니다.
Temu CAPTCHA
Temu 작업은 순서가 있는 parts 배열을 메인 챌린지 이미지와 대조합니다. parts의 후보 이미지와 같은 순서로 좌표를 반환합니다. 단일 이미지 좌표 작업과는 다르며, 사이트 토큰을 반환하지 않습니다.
텍스트 CAPTCHA
텍스트 CAPTCHA는 글로 된 질문과 답변 형식의 프롬프트로, 호스팅 위젯 업체보다는 포럼이나 CMS에서 제공하는 경우가 많습니다. 답변 텍스트를 반환합니다. 그림 속 문자는 image를, 음성 챌린지는 audio를 사용하십시오.
기타 챌린지 유형
고유한 요청 파라미터와 솔루션 필드를 가진 추가 챌린지입니다.
ALTCHA
ALTCHA는 작업 증명(proof-of-work) 위젯으로, 보통 이미지 그리드가 아닌 altcha-widget 요소로 노출됩니다. 작업 증명 챌린지로 생성된 폼 토큰을 반환하며, 시각적 답이나 페이지 접근 쿠키가 아닙니다.
ATB CAPTCHA
atbCAPTCHA는 appId와 apiServer로 초기화되며, 클릭, 슬라이더 또는 위험도 적응형 챌린지를 표시할 수 있습니다. 결과는 atbCAPTCHA 토큰입니다. 다른 브랜드의 위젯이 비슷한 모양이라도 식별자를 서로 바꿔 쓸 수 없습니다.
Binance CAPTCHA
Binance 작업은 일반 이미지나 reCAPTCHA 사이트 키가 아니라 챌린지의 validate_id에서 시작합니다. 해당 검증 세션의 챌린지 토큰을 반환합니다. 오래된 식별자나 다른 흐름의 식별자는 바꿔 쓸 수 없습니다.
Cutcaptcha
Cutcaptcha는 토큰을 생성하는 챌린지에 Misery 키와 별도의 CAPTCHA API 키를 노출합니다. 토큰을 반환합니다. 두 키 모두 일반 사이트 키가 아니며, 각 키의 역할을 하나로 합치면 안 됩니다.
Hunt CAPTCHA
Hunt는 URL 기반 토큰 작업으로 등록되어 있지만, 안정적인 공개 업체 식별 특징은 아직 문서화되지 않았습니다. 토큰을 반환합니다. 검증된 공개 식별 특징이 없으므로 카탈로그 항목을 따르십시오. 이 페이지는 업체별 DOM 선택자를 제시하지 않습니다.
Yandex SmartCaptcha
Yandex SmartCaptcha는 Yandex Cloud 위젯으로, SmartCaptcha 스크립트로 로드되며 자체 위젯 API를 통해 완료됩니다. smart-token 필드에 사용할 토큰을 반환합니다. MTCaptcha는 스크립트와 서버 검증 방식이 다른 별개의 제품입니다.
솔루션 형식과 활용 방법
solution 객체는 지원되는 9가지 응답 형식 중 하나를 사용합니다. 형식이 같은 유형끼리는 응답 파싱 코드를 공유할 수 있지만, 요청 파라미터는 다를 수 있습니다.
| 솔루션 형식 | 반환 값 | 활용 방법 | 유형 |
|---|---|---|---|
boxes | 바운딩 박스 | 각 박스의 좌표로 원본 이미지에서 영역을 식별하거나 선택합니다. | 2 |
cookie | 쿠키 값 | 반환된 쿠키 필드를 같은 워크플로의 이후 요청에 첨부합니다. | 10 |
fields | 명명된 필드 | 선언된 필드를 함께 읽어야 합니다. 대상 워크플로에서 전체 세트가 필요할 수 있습니다. | 8 |
indices | 그리드 셀 인덱스 | 나열된 셀을 클릭합니다. 왼쪽 위 셀이 0이며, 번호는 각 행에서 왼쪽에서 오른쪽 순으로 이어집니다. 목록이 비어 있으면 일치하는 셀이 없다는 뜻입니다. | 1 |
number | 숫자 | 반환된 숫자 값을 챌린지가 요구하는 답으로 사용합니다. | 2 |
points | 좌표점 | 반환된 픽셀 위치를 주어진 순서대로 원본 이미지나 클릭 워크플로에 적용합니다. | 4 |
text | 텍스트 | 반환된 텍스트를 챌린지의 답으로 사용합니다. | 3 |
token | 토큰 | 대상 워크플로가 요구하는 필드나 검증 요청에 토큰을 제출합니다. | 21 |
tokens | 토큰 세트 | 반환된 토큰을 대상 사이트의 요청 형식에 맞춰 한꺼번에 제출합니다. | 1 |
CAPTCHA API 관련 자주 묻는 질문
페이지에서 사용하는 CAPTCHA는 어떻게 식별하나요?
먼저 로드된 스크립트를 확인한 다음 챌린지 컨테이너의 데이터 속성을 살펴보고, 마지막으로 챌린지 전용 브라우저 전역 객체를 확인하세요. 대상 페이지가 로드되기 전에 전체 화면 차단 페이지가 나타난다면 삽입형 위젯 유형 대신 챌린지 페이지 유형을 사용하세요.
해결에 실패해도 비용이 청구되나요?
아니요. EverySolve는 성공적으로 전달된 경우에만 과금합니다. 실패하거나 빈 결과에는 최종 비용이 청구되지 않으며, 보류된 금액은 원래 계정 잔액으로 자동 반환됩니다.
CAPTCHA 유형이 바뀌면 코드를 얼마나 수정해야 하나요?
엔드포인트는 그대로 POST /api/v1/captcha입니다. type 값을 바꾸고 해당 유형에 정의된 파라미터를 전달하면 됩니다. 두 유형이 9가지 응답 형식 중 같은 형식을 사용한다면 응답 파싱 코드도 공유할 수 있습니다.
available 필드는 무엇을 의미하나요?
GET /api/v1/captcha/types는 52가지 유형 전체를 나열하고, 각 유형을 현재 시점에 제공할 수 있는지 알려 줍니다. 요청을 보내기 전에 현재 사용 가능 여부를 확인하세요. 캐시된 값만으로는 사용 가능 여부가 보장되지 않습니다.