EverySolve CAPTCHA API
reCAPTCHA v2 API
EverySolve's reCAPTCHA v2 API returns a token for your challenge workflow. Send POST /api/v1/captcha with type set to recaptcha_v2 and the inputs listed below.
reCAPTCHA v2 is the classic checkbox or invisible v2 widget loaded through api.js and configured with a site key. It returns gRecaptchaResponse for the target form. v3 is score-based and Enterprise loads enterprise.js with Enterprise-specific context.
- Endpoint
- POST /api/v1/captcha
- Type
- recaptcha_v2
- Per 1,000 successful solutions
- $1.11 per 1,000 successful solutions
Request parameters
Provide website_url and website_key. Optional parameters are invisible, data_s, page_action, and api_domain.
Required parameters
website_urlwebsite_keyOptional parameters
invisibledata_spage_actionapi_domaincurl -X POST https://api.everyinfra.com/api/v1/captcha \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type":"recaptcha_v2","website_url":"<website_url>","website_key":"<website_key>"}'
How to recognize reCAPTCHA v2
reCAPTCHA v2 is the classic checkbox or invisible v2 widget loaded through api.js and configured with a site key.
What makes reCAPTCHA v2 different
It returns gRecaptchaResponse for the target form. v3 is score-based and Enterprise loads enterprise.js with Enterprise-specific context.
Where the reCAPTCHA v2 parameters come from
Copy website_key from data-sitekey or the render call; invisible, data_s, page_action, and api_domain are optional only when present in that v2 integration.
website_urlRequired- The exact page where this challenge appears, including the relevant path rather than only the site home page.
website_keyRequired- The public site or widget key copied from this exact target integration; it is not a secret key.
invisibleOptional- Whether the target widget uses its invisible mode; do not infer it from the absence of an image alone.
data_sOptional- The data-s value exposed by a reCAPTCHA v2 integration when that deployment uses it.
page_actionOptional- The action string used by the target reCAPTCHA execution; preserve its exact case and spelling.
api_domainOptional- The API hostname used by the target widget when it differs from the standard domain.
What the API returns
The reCAPTCHA v2 API returns a token in gRecaptchaResponse. Its solution format is token. Submit the token in the field or verification request expected by the target workflow.
- Solution shape
- token
- Solution fields
gRecaptchaResponse
How to use the reCAPTCHA v2 API
- 01Read GET /api/v1/captcha/types and select the
recaptcha_v2entry. - 02Send
type: "recaptcha_v2"and the required parameters to POST /api/v1/captcha. - 03Read a token from
gRecaptchaResponse. - 04Submit the token in the field or verification request expected by the target workflow.
Billing and availability
EverySolve charges only when a solution is delivered successfully. Unsuccessful attempts are refunded automatically. Read available and the price fields from GET /api/v1/captcha/types at request time rather than treating them as static page content.
reCAPTCHA v2 integration questions
How can I identify reCAPTCHA v2 before choosing a type?
reCAPTCHA v2 is the classic checkbox or invisible v2 widget loaded through api.js and configured with a site key. Use recaptcha_v2 only after those signals match the target challenge.
Which target-page values belong in a reCAPTCHA v2 request?
Copy website_key from data-sitekey or the render call; invisible, data_s, page_action, and api_domain are optional only when present in that v2 integration. Provide website_url and website_key. Optional parameters are invisible, data_s, page_action, and api_domain.
What does reCAPTCHA v2 return, and what should not be confused with it?
The reCAPTCHA v2 API returns a token in gRecaptchaResponse. Its solution format is token. It returns gRecaptchaResponse for the target form. v3 is score-based and Enterprise loads enterprise.js with Enterprise-specific context.
Which external source explains the reCAPTCHA v2 integration?
Google documents v2 checkbox and invisible widget rendering. [Open the reCAPTCHA v2 reference](https://developers.google.com/recaptcha/docs/display). EverySolve-specific fields and live availability still come from the type catalog.