PHPackages solvercaptcha/solvecaptcha-php - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Authentication & Authorization](/categories/authentication) 4. / 5. solvercaptcha/solvecaptcha-php ActiveLibrary[Authentication & Authorization](/categories/authentication) solvercaptcha/solvecaptcha-php ============================== PHP package for easy integration with solvecaptcha API. v1.0.0(1y ago)12322MITPHPPHP >=7.3 Since Apr 10Pushed 2mo agoCompare [ Source](https://github.com/solvercaptcha/solvecaptcha-php)[ Packagist](https://packagist.org/packages/solvercaptcha/solvecaptcha-php)[ RSS](/packages/solvercaptcha-solvecaptcha-php/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (1)Versions (5)Used By (0) [![php](https://private-user-images.githubusercontent.com/200132420/432357518-dbb4d41a-3de3-422a-8791-35fd81809b06.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8yMDAxMzI0MjAvNDMyMzU3NTE4LWRiYjRkNDFhLTNkZTMtNDIyYS04NzkxLTM1ZmQ4MTgwOWIwNi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwMzMwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDMzMFQwODQ0MTBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0zY2JmMmU3YTg3ODk2ZDFhMmJkZmFhOTMxODdjZjVmMWY5MmE3OTQzM2U0NWJhOTdmZDUwMWJjYmVkOWM4ZTc0JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.hYN5lBAN_uhOtKAbYVR-c_lwT0_kZ2pWAHC1GK1gqJ4)](https://private-user-images.githubusercontent.com/200132420/432357518-dbb4d41a-3de3-422a-8791-35fd81809b06.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8yMDAxMzI0MjAvNDMyMzU3NTE4LWRiYjRkNDFhLTNkZTMtNDIyYS04NzkxLTM1ZmQ4MTgwOWIwNi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwMzMwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDMzMFQwODQ0MTBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0zY2JmMmU3YTg3ODk2ZDFhMmJkZmFhOTMxODdjZjVmMWY5MmE3OTQzM2U0NWJhOTdmZDUwMWJjYmVkOWM4ZTc0JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.hYN5lBAN_uhOtKAbYVR-c_lwT0_kZ2pWAHC1GK1gqJ4) [![](https://private-user-images.githubusercontent.com/38065632/351749209-37e1d860-033b-4cf3-a158-468fc6b4debc.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8zODA2NTYzMi8zNTE3NDkyMDktMzdlMWQ4NjAtMDMzYi00Y2YzLWExNTgtNDY4ZmM2YjRkZWJjLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzMwVDA4NDQxMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTJjY2UzMDU5NmMyMDdiOWM0MDQ2YjEzMzI2MmNhOGFlNzg5NjQ1NTllZjNjMjY0MjI0YTQyZWQ0ZDY4MGI0ODQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.YIsp7NT4yskYk82fIHBXJZql24cH3SMBAqyZJ71NfVw)](https://github.com/solvercaptcha/solvecaptcha-python)[![](https://private-user-images.githubusercontent.com/38065632/351642427-4d3b4541-34b2-4ed2-a687-d694ce67e5a6.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8zODA2NTYzMi8zNTE2NDI0MjctNGQzYjQ1NDEtMzRiMi00ZWQyLWE2ODctZDY5NGNlNjdlNWE2LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzMwVDA4NDQxMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTEzZmM3MTQ0NDAxOTVjMzVhMzdhYzI4MzQ2YWJhMGQxYTM1N2RmZDdjMTQxNjM4M2UyZjAzMjkyNzgyMzQyMTUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.1C-vbAVHGp6yBqnRYYXN-PTET-Y9xTFIlCsjviRRO74)](https://github.com/solvercaptcha/solvecaptcha-javascript)[![](https://private-user-images.githubusercontent.com/38065632/351642571-ab22182e-6cb2-41fa-91f4-d5e89c6d7c6f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8zODA2NTYzMi8zNTE2NDI1NzEtYWIyMjE4MmUtNmNiMi00MWZhLTkxZjQtZDVlODljNmQ3YzZmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzMwVDA4NDQxMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTBkNjVjN2ExZmFkOGM0ZGE1OGViZGZjZGU3YWNiOGJlNWMwYTZlOTFiNWE5OGY3NWUyNDg2NTBmZWMyMjFkMjMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.pnUuKgsUkaH66ANkjLBd10uayGf3DBDpqgNJEy2tt0k)](https://github.com/solvercaptcha/solvecaptcha-go)[![](https://private-user-images.githubusercontent.com/38065632/351642711-0270d56f-79b0-4c95-9b09-4de89579914b.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8zODA2NTYzMi8zNTE2NDI3MTEtMDI3MGQ1NmYtNzliMC00Yzk1LTliMDktNGRlODk1Nzk5MTRiLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzMwVDA4NDQxMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWVmYzcwYzlhMmJjYjk4ZTdiZmM0NDVjMTg2YTkzNzIzZDEyYTBmNmM1ZDRkYzUxMjgxZmU0MzQ0NjQ0ZTQ1Y2EmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.4uXjAVyeC1gOYLZdMll8LX5bzGkZwNnOrI6uelexPb0)](https://github.com/solvercaptcha/solvecaptcha-ruby)[![](https://private-user-images.githubusercontent.com/38065632/351642824-36de8512-acfd-44fb-bb1f-b7c793a3f926.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8zODA2NTYzMi8zNTE2NDI4MjQtMzZkZTg1MTItYWNmZC00NGZiLWJiMWYtYjdjNzkzYTNmOTI2LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzMwVDA4NDQxMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTk3ZWYxMTNiMjQ4OTI0OTE5ZWE3ZTkxMWFjMzQyMGNmOTIwNzE5MzkxM2QwNmUxYTcxOTQzMGM5YWZkMWEzOGEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0._fJpMmVHkC3OEGryqpmmvEbiBFLLHStGsjeQqz5DsMU)](https://github.com/solvercaptcha/solvecaptcha-cpp)[![](https://private-user-images.githubusercontent.com/38065632/351767412-c27d7db5-c20f-47c1-b252-96ee76503b9e.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8zODA2NTYzMi8zNTE3Njc0MTItYzI3ZDdkYjUtYzIwZi00N2MxLWIyNTItOTZlZTc2NTAzYjllLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzMwVDA4NDQxMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTliZDYyNmVjNmU2NjYwYmYwOGY1OWRiNDUwMTlmYWMzODlmNDk0Mzg1ZmJhMjFlM2MzNmUxZDJkNGM4ODU2YjgmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.gcBlzILUfdmlU6F880X9YXIo37FLJR281Qh5GfCnHqY)](https://github.com/solvercaptcha/solvecaptcha-php)[![](https://private-user-images.githubusercontent.com/38065632/351643626-a3d923f6-4fec-4c07-ac50-e20da6370911.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8zODA2NTYzMi8zNTE2NDM2MjYtYTNkOTIzZjYtNGZlYy00YzA3LWFjNTAtZTIwZGE2MzcwOTExLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzMwVDA4NDQxMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTZlYmQzYTRjN2QyNGQyZjEwNTNmY2ViOWY3MDE1OWEwNTk5ODg2OTYwOWNhN2M0ZTJiNjJiZmVkMzkzZGU4MmQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.5XSYKji_fpmmXea69wB0UtAZoIxkkoWttz49TC8DVGg)](https://github.com/solvercaptcha/solvecaptcha-java)[![](https://private-user-images.githubusercontent.com/38065632/351643852-f4d449de-780b-49ed-bb0a-b70c82ec4b32.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8zODA2NTYzMi8zNTE2NDM4NTItZjRkNDQ5ZGUtNzgwYi00OWVkLWJiMGEtYjcwYzgyZWM0YjMyLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzMwVDA4NDQxMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTExMjg1NzVkMGQ1NWZhOTE0Yzg3YzFlNGFjODhiYjdmMGU4N2ExYTZjMjJkZThlNzg2ODllZTI1NmYyNDY3YTYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.T9WBcUAl4pfrGSMjprQY5VnxC0-IvaiOjBBWKJ81DZc)](https://github.com/solvercaptcha/solvecaptcha-csharp) PHP Captcha Solver: Bypass reCAPTCHA, Cloudflare, Amazon and more ================================================================= [](#php-captcha-solver-bypass-recaptcha-cloudflare-amazon-and-more) Use the [PHP captcha solver](https://solvecaptcha.com/captcha-solver/php-captcha-solver-bypass) to automatically bypass any captcha — including reCAPTCHA v2, Invisible, v3, Enterprise, Cloudflare Turnstile, GeeTest, sliders, Amazon AWS WAF, FunCaptcha, and both image and text based captchas. ✅ Supported captcha solvers --------------------------- [](#-supported-captcha-solvers) To get started quickly, check out the [Captcha Solver API](https://solvecaptcha.com/captcha-solver-api) documentation. Helpful links: - [reCAPTCHA v2 solver](https://solvecaptcha.com/captcha-solver/recaptcha-v2-solver-bypass) - [reCAPTCHA v3 solver](https://solvecaptcha.com/captcha-solver/recaptcha-v3-solver-bypass) - [Text and image captcha solver](https://solvecaptcha.com/captcha-solver/image-captcha-solver-bypass) - [Cloudflare captcha solver (Turnstile)](https://solvecaptcha.com/captcha-solver/cloudflare-captcha-solver-bypass) - [Amazon captcha solver (AWS WAF)](https://solvecaptcha.com/captcha-solver/amazon-captcha-solver-bypass) - [GeeTest solver](https://solvecaptcha.com/captcha-solver/slider-captcha-solver-bypass) - [FunCaptcha (Arkose Labs) solver](https://solvecaptcha.com/captcha-solver/funcaptcha-solver-bypass) - Other types ### 🛠️ Features [](#️-features) - Fast and fully automated captcha bypass - Native support for **PHP 7.4+ / 8.x** - Works with **cURL**, **Guzzle**, **Symfony HTTP client**, and any - REST-compatible tool - Easy integration with frameworks like **Laravel**, **Symfony**, **CodeIgniter** - Clean, promise-like async handling via callbacks or jobs - Pay only for successful solves - 99.9% uptime - 24/7 developer support ### 📦 Use cases [](#-use-cases) - Accesability - Web scraping - Automating form submissions in Laravel or other PHP apps - Captcha solving in background workers or job queues - QA testing of protected flows - Security research Need help integrating with your PHP application? [Open an issue](https://github.com/solvercaptcha/solvecaptcha-php/issues) or fork this repo to contribute. - [PHP Captcha Solver: Bypass reCAPTCHA, Cloudflare, Amazon and more](#php-captcha-solver-bypass-recaptcha-cloudflare-amazon-and-more) - [Installation](#installation) - [Composer](#composer) - [Manual](#manual) - [Configuration](#configuration) - [SolveCaptcha instance options](#solvecaptcha-instance-options) - [Solve captcha](#solve-captcha) - [Captcha options](#captcha-options) - [Normal Captcha](#normal-captcha) - [Text Captcha](#text-captcha) - [reCAPTCHA v2](#recaptcha-v2) - [reCAPTCHA v3](#recaptcha-v3) - [FunCaptcha](#funcaptcha) - [GeeTest](#geetest) - [GeeTest V4](#geetest-v4) - [KeyCaptcha](#keycaptcha) - [Capy](#capy) - [Grid](#grid) - [Canvas](#canvas) - [ClickCaptcha](#clickcaptcha) - [Rotate](#rotate) - [Audio Captcha](#audio) - [Yandex](#yandex) - [Lemin Cropped Captcha](#lemin-cropped-captcha) - [Cloudflare Turnstile](#cloudflare-turnstile) - [Amazon WAF](#amazon-waf) - [Tencent](#tencent) - [MTCaptcha](#mtcaptcha) - [Cutcaptcha](#cutcaptcha) - [Friendly Captcha](#friendly-captcha) - [atbCAPTCHA](#atbcaptcha) - [DataDome](#datadome) - [CyberSiARA](#cybersiara) - [Other methods](#other-methods) - [send / getResult](#send--getresult) - [balance](#balance) - [report](#report) - [Proxies](#proxies) - [Error handling](#error-handling) - [Examples](#examples) - [Get in touch](#get-in-touch) - [License](#license) Installation ------------ [](#installation) This package can be installed via composer or manually - Download composer from to your project directory - Run `php composer.phar install` ### Composer [](#composer) ``` composer require solvecaptcha/solvecaptcha ``` ### Manual [](#manual) Clone it manually: ``` git clone https://github.com/solvercaptcha/solvecaptcha-php.git ``` Copy `src` directory to your project and then `require` autoloader (`src/autoloader.php`) where needed: ``` require 'path/to/solvecaptcha-php/src/autoloader.php'; ``` Configuration ------------- [](#configuration) `SolveCaptcha` instance can be created like this: ``` $solver = new \SolveCaptcha\SolveCaptcha('YOUR_API_KEY'); ``` Also there are few options that can be configured: ``` $solver = new \SolveCaptcha\SolveCaptcha([ 'server' => 'https://solvecaptcha.com', 'apiKey' => 'YOUR_API_KEY', 'defaultTimeout' => 120, 'recaptchaTimeout' => 600, 'pollingInterval' => 10, 'json' => 1, ]); ``` ### SolveCaptcha instance options [](#solvecaptcha-instance-options) OptionDefault valueDescriptiondefaultTimeout120Polling timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from `res.php` API endpointrecaptchaTimeout600Polling timeout for reCAPTCHA in seconds. Defines how long the module tries to get the answer from `res.php` API endpointpollingInterval10Interval in seconds between requests to `res.php` API endpoint, setting values less than 5 seconds is not recommendedjson0Json or String format response from `res.php` API endpoint, json = 1 returns JSON format responseTo get the answer manually use [getResult method](#send--getresult) Solve captcha ------------- [](#solve-captcha) When you submit any image-based captcha use can provide additional options to help solvecaptcha workers to solve it properly. ### Captcha options [](#captcha-options) OptionDefault ValueDescriptionnumeric0Defines if captcha contains numeric or other symbols [see more info in the API docs](https://solvecaptcha.com/captcha-solver-api#normal_post)minLength0minimal answer lengthmaxLength0maximum answer lengthphrase0defines if the answer contains multiple words or notcaseSensitive0defines if the answer is case sensitivecalc0defines captcha requires calculationlang-defines the captcha language, see the [list of supported languages](https://solvecaptcha.com/captcha-solver-api#language)hintImg-an image with hint shown to workers with the captchahintText-hint or task text shown to workers with the captchaBelow you can find basic examples for every captcha type. Check out [examples directory](/examples) to find more examples with all available options. ### Normal Captcha [](#normal-captcha) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_normal_captcha) To bypass a normal captcha (distorted text on image) use the following method. This method also can be used to recognize any text on the image. ``` $result = $solver->normal('path/to/captcha.jpg'); ``` ### Text Captcha [](#text-captcha) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_text_captcha) This method can be used to bypass a captcha that requires to answer a question provided in clear text. ``` $result = $solver->text('If tomorrow is Saturday, what day is today?'); ``` ### reCAPTCHA v2 [](#recaptcha-v2) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_recaptchav2_new) Use this method to solve reCAPTCHA V2 and obtain a token to bypass the protection. ``` $result = $solver->recaptcha([ 'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-', 'url' => 'https://mysite.com/page/with/recaptcha', ]); ``` ### reCAPTCHA v3 [](#recaptcha-v3) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_recaptchav3) This method provides reCAPTCHA V3 solver and returns a token. ``` $result = $solver->recaptcha([ 'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-', 'url' => 'https://mysite.com/page/with/recaptcha', 'version' => 'v3', ]); ``` ### FunCaptcha [](#funcaptcha) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_funcaptcha_new) FunCaptcha (Arkoselabs) solving method. Returns a token. ``` $result = $solver->funcaptcha([ 'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-', 'url' => 'https://mysite.com/page/with/funcaptcha', ]); ``` ### GeeTest [](#geetest) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_geetest) Method to solve GeeTest puzzle captcha. Returns a set of tokens as JSON. ``` $result = $solver->geetest([ 'gt' => 'f1ab2cdefa3456789012345b6c78d90e', 'challenge' => '12345678abc90123d45678ef90123a456b', 'url' => 'https://www.site.com/page/', ]); ``` ### GeeTest V4 [](#geetest-v4) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_geetest_v4) Method to solve GeeTest V4 puzzle captcha. Returns a set of tokens as JSON. ``` $result = $solver->geetest_v4([ 'captchaId' => '72bf15796d0b69c43867452fea615052', 'url' => 'https://mysite.com/captcha.html', ]); ``` ### KeyCaptcha [](#keycaptcha) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_keycaptcha) Token-based method to solve KeyCaptcha. ``` $result = $solver->keycaptcha([ 's_s_c_user_id' => 10, 's_s_c_session_id' => '493e52c37c10c2bcdf4a00cbc9ccd1e8', 's_s_c_web_server_sign' => '9006dc725760858e4c0715b835472f22-pz-', 's_s_c_web_server_sign2' => '2ca3abe86d90c6142d5571db98af6714', 'url' => 'https://www.keycaptcha.ru/demo-magnetic/', ]); ``` ### Capy [](#capy) Token-based method to bypass Capy puzzle captcha. ``` $result = $solver->capy([ 'sitekey' => 'PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v', 'url' => 'http://mysite.com/', 'api_server' => 'https://jp.api.capy.me/', ]); ``` ### Grid [](#grid) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_grid) Grid method is originally called Old reCAPTCHA V2 method. The method can be used to bypass any type of captcha where you can apply a grid on image and need to click specific grid boxes. Returns numbers of boxes. ``` $result = $solver->grid('path/to/captcha.jpg'); ``` ### Canvas [](#canvas) [API method description.](https://solvecaptcha.com/captcha-solver-api#canvas) Canvas method can be used when you need to draw a line around an object on image. Returns a set of points' coordinates to draw a polygon. ``` $result = $solver->canvas('path/to/captcha.jpg'); ``` ### ClickCaptcha [](#clickcaptcha) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_clickcaptcha) ClickCaptcha method returns coordinates of points on captcha image. Can be used if you need to click on particular points on the image. ``` $result = $solver->coordinates('path/to/captcha.jpg'); ``` ### Rotate [](#rotate) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_rotatecaptcha) This method can be used to solve a captcha that asks to rotate an object. Mostly used to bypass FunCaptcha. Returns the rotation angle. ``` $result = $solver->rotate('path/to/captcha.jpg'); ``` ### Audio [](#audio) This method can be used to solve a audio captcha ``` $result = $solver->audio('path/to/audio.mp3'); ``` ### Yandex [](#yandex) Use this method to solve Yandex and obtain a token to bypass the protection. ``` $result = $solver->yandex([ 'sitekey' => 'Y5Lh0tiycconMJGsFd3EbbuNKSp1yaZESUOIHfeV', 'url' => 'https://rutube.ru', ]); ``` ### Lemin Cropped Captcha [](#lemin-cropped-captcha) Use this method to solve Lemin and obtain a token to bypass the protection. ``` $result = $solver->lemin([ 'captchaId' => 'CROPPED_d3d4d56_73ca4008925b4f83a8bed59c2dd0df6d', 'apiServer' => 'api.leminnow.com', 'url' => 'https://www.site.com/page/', ]); ``` ### Cloudflare Turnstile [](#cloudflare-turnstile) [API method description.](https://solvecaptcha.com/captcha-solver-api#solving_cloudflare_turnstile) Use this method to solve Turnstile and obtain a token to bypass the protection. ``` $result = $solver->turnstile([ 'sitekey' => '0x4AAAAAAAChNiVJM_WtShFf', 'url' => 'https://ace.fusionist.io', ]); ``` ### Amazon WAF [](#amazon-waf) Use this method to solve Amazon WAF and obtain a token to bypass the protection. ``` $result = $solver->amazon_waf([ 'sitekey' => 'AQIDAHjcYu/GjX+QlghicBgQ/7bFaQZ+m5FKCMDnO+vTbNg96AF5H1K/siwSLK7RfstKtN5bAAAAfjB8BgkqhkiG9w0BBwagbzBtAgEAMGgGCSqGSIb3DQEHATAeBglg', 'url' => 'https://non-existent-example.execute-api.us-east-1.amazonaws.com', 'iv' => 'test_iv', 'context' => 'test_context' ]); ``` ### Tencent [](#tencent) Use this method to bypass Tencent. ``` $result = $solver->tencent([ 'sitekey' => '123456789', 'url' => 'https://www.site.com/page/', ]); ``` ### MTCaptcha [](#mtcaptcha) Use this method to bypass MTCaptcha. ``` $result = $solver->mt_captcha([ 'sitekey' => 'MTPublic-KzqLY1cKH', 'url' => 'https://solvecaptcha.com/demo/mtcaptcha', ]); ``` ### Cutcaptcha [](#cutcaptcha) Use this method to bypass Cutcaptcha. ``` $result = $solver->cutcaptcha([ 'misery_key' => 'a1488b66da00bf332a1488993a5443c79047e752', 'api_key' => 'SAb83IIB', 'url' => 'https://example.cc/foo/bar.html', ]); ``` ### Friendly Captcha [](#friendly-captcha) Use this method to bypass Friendly Captcha. ``` $result = $solver->friendly_captcha([ 'sitekey' => '2FZFEVS1FZCGQ9', 'url' => 'https://example.com/', ]); ``` ### atbCAPTCHA [](#atbcaptcha) Use this method to bypass atbCAPTCHA. ``` $result = $solver->atb_captcha([ 'sitekey' => 'af23e041b22d000a11e22a230fa8991c', 'api_server' => 'https://cap.aisecurius.com', 'url' => 'https://example.com/', ]); ``` ### DataDome [](#datadome) Use this method to bypass DataDome. Important To solve the DataDome captcha, you must use a proxy. It is recommended to use residential proxies. ``` $result = $solver->datadome([ 'captcha_url' => 'https://geo.captcha-delivery.com/captcha/?initialCid=AHrlqAAA...P~XFrBVptk&t=fe&referer=https%3A%2F%2Fhexample.com&s=45239&e=c538be..c510a00ea', 'userAgent' => 'https://cap.aisecurius.com', 'url' => 'https://example.com/', 'proxy' => [ 'type' => 'HTTPS', 'uri' => 'username:str0ngP@$$W0rd@1.2.3.4:4321', ], ]); ``` ### CyberSiARA [](#cybersiara) Use this method to bypass CyberSiARA. ``` $result = $solver->cybersiara([ 'master_url_id' => 'tpjOCKjjpdzv3d8Ub2E9COEWKt1vl1Mv', 'pageurl' => 'https://demo.mycybersiara.com/', 'userAgent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36', ]); ``` Other methods ------------- [](#other-methods) ### send / getResult [](#send--getresult) These methods can be used for manual captcha submission and answer polling. ``` $id = $solver->send(['file' => 'path/to/captcha.jpg', ...]); sleep(20); $code = $solver->getResult($id); ``` ### balance [](#balance) [API method description.](https://solvecaptcha.com/captcha-solver-api#additional) Use this method to get your account's balance ``` $balance = $solver->balance(); ``` ### report [](#report) [API method description.](https://solvecaptcha.com/captcha-solver-api#complain) Use this method to report good or bad captcha answer. ``` $solver->report($id, true); // captcha solved correctly $solver->report($id, false); // captcha solved incorrectly ``` Proxies ------- [](#proxies) You can pass your proxy as an additional argument for methods: recaptcha, funcaptcha, geetest, geetest v4, keycaptcha, capy puzzle, lemin, turnstile, amazon waf and etc. The proxy will be forwarded to the API to solve the captcha. Example solving reCAPTCHA V2 using proxy: ``` $result = $solver->recaptcha([ 'sitekey' => '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-', 'url' => 'https://mysite.com/page/with/recaptcha', 'proxy' => [ 'type' => 'HTTPS', 'uri' => 'login:password@IP_address:PORT', ], ]); ``` Error handling -------------- [](#error-handling) If case of an error captch solver throws an exception. It's important to properly handle these cases. We recommend to use `try catch` to handle exceptions. ``` try { $result = $solver->text('If tomorrow is Saturday, what day is today?'); } catch (\SolveCaptcha\Exception\ValidationException $e) { // invalid parameters passed } catch (\SolveCaptcha\Exception\NetworkException $e) { // network error occurred } catch (\SolveCaptcha\Exception\ApiException $e) { // api respond with error } catch (\SolveCaptcha\Exception\TimeoutException $e) { // captcha is not solved so far } ``` Examples -------- [](#examples) Examples of solving all supported captcha types are located in the [examples](/examples) directory. Get in touch ------------ [](#get-in-touch) [![](https://private-user-images.githubusercontent.com/38065632/351619983-539df209-7c85-4fa5-84b4-fc22ab93fac7.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8zODA2NTYzMi8zNTE2MTk5ODMtNTM5ZGYyMDktN2M4NS00ZmE1LTg0YjQtZmMyMmFiOTNmYWM3LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzMwVDA4NDQxMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTExNDBiZGI3ZTFhNmRiNWJhNDk1YWVmMjdjODM4OTA1MDQ2MzU4NGUyMWRiMTMxNjNmNTRjYmFmNzQ5MWQ0OTMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.4AzZvIwPDlSJPcYQGUVCbpL_jN5GzheGl8lOJl0fymg)](mailto:info@solvecaptcha.com)[![](https://private-user-images.githubusercontent.com/38065632/351620509-be044db5-2e67-46c6-8c81-04b78bd99650.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ4NjA1NTAsIm5iZiI6MTc3NDg2MDI1MCwicGF0aCI6Ii8zODA2NTYzMi8zNTE2MjA1MDktYmUwNDRkYjUtMmU2Ny00NmM2LThjODEtMDRiNzhiZDk5NjUwLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzMwVDA4NDQxMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWFiY2JmYzQ2NmVlODliZmI4ZmMzYmY0YWZkM2IwMGIxOWIzNGI0OGJhMzRmYTI2NDYzZmZiOWE4NzY1NWM0YTMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.nABl5WMpPPLiEycuJVtrLD92HR7UDDdYZNXt68mTPcQ)](https://solvecaptcha.com/support/faq#create-ticket) License ------- [](#license) The code in this repository is licensed under the MIT License. See the [LICENSE](./LICENSE) file for more details. ### Health Score 36 — LowBetter than 82% of packages Maintenance68 Regular maintenance activity Popularity24 Limited adoption so far Community8 Small or concentrated contributor base Maturity35 Early-stage or recently created project Bus Factor1 Top contributor holds 94.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~5 days Total 3 Last Release 391d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/5baead5dd05ac7196e2647b323f0c52b6ec2bf8da9eeb11b9a86dba286fd9bba?d=identicon)[solvecaptcha](/maintainers/solvecaptcha) --- Top Contributors [![solvecaptcha-com](https://avatars.githubusercontent.com/u/200132420?v=4)](https://github.com/solvecaptcha-com "solvecaptcha-com (36 commits)")[![victorkowalski](https://avatars.githubusercontent.com/u/23631937?v=4)](https://github.com/victorkowalski "victorkowalski (2 commits)") --- Tags bypass-captchabypass-captcha-seleniumbypass-recaptchabypass-recaptcha-phpcaptcha-bypasscaptcha-solvercaptcha-solver-seleniumcloudflare-captcha-bypasscloudflare-captcha-solverfuncaptcha-solvergeetest-solvermtcaptcha-solverphp-bypass-cloudflarephp-captcha-solverphp-curl-captcha-bypassrecaptcha-bypassrecaptcha-solverselenium-captcha-bypassselenium-captcha-solverrecaptchacaptcharecaptcha v3decaptchatencentkeycaptchafuncaptchaanticaptchageetestdatadomereCAPTCHA V2bypass captchasolve captchacaptcha solverfriendly captchalemincloudflare turnstileamazon wafaudio captchaMTCaptchaCutcaptchaatbCAPTCHAhcaptchasolvecaptchasolvecaptcha.com ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/solvercaptcha-solvecaptcha-php/health.svg) ``` [![Health](https://phpackages.com/badges/solvercaptcha-solvecaptcha-php/health.svg)](https://phpackages.com/packages/solvercaptcha-solvecaptcha-php) ``` ### Alternatives [2captcha/2captcha PHP package for easy integration with 2captcha API 86430.0k3](/packages/2captcha-2captcha)[google/recaptcha Client library for reCAPTCHA, a free service that protects websites from spam and abuse. 3.6k89.1M222](/packages/google-recaptcha)[anhskohbo/no-captcha No CAPTCHA reCAPTCHA For Laravel. 1.8k8.5M33](/packages/anhskohbo-no-captcha)[albertcht/invisible-recaptcha Invisible reCAPTCHA For Laravel. 6031.6M6](/packages/albertcht-invisible-recaptcha)[josiasmontag/laravel-recaptchav3 Recaptcha V3 for Laravel package 2641.6M2](/packages/josiasmontag-laravel-recaptchav3)[arcanedev/no-captcha No CAPTCHA (new Google reCAPTCHA) with Laravel support 370730.4k6](/packages/arcanedev-no-captcha) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)