{
 "kind": "api",
 "slug": "hcaptcha",
 "path": "apis/hcaptcha/",
 "name": "hCaptcha",
 "logo": "https://agentgid.com/media/avatars/hcaptcha.png",
 "maker": "Intuition Machines",
 "density": "full",
 "crumbs": [
  [
   "APIs",
   "apis/"
  ],
  [
   "Auth and user accounts",
   "apis/auth/"
  ]
 ],
 "lead": "Keep bots out of your own forms.",
 "chips": [
  {
   "label": "Auth and user accounts",
   "path": "apis/auth/"
  },
  {
   "label": "Up · live status",
   "live": true
  }
 ],
 "primary": {
  "label": "Copy prompt for your agent",
  "copy": "Protect my sign-up form with hCaptcha: add @hcaptcha/react-hcaptcha at a fixed version with my public sitekey, and on the server POST the h-captcha-response token with HCAPTCHA_SECRET from .env (form-encoded) to https://api.hcaptcha.com/siteverify, accepting the form only when success is true."
 },
 "links": [
  {
   "label": "Website",
   "href": "https://www.hcaptcha.com"
  },
  {
   "label": "Pricing",
   "href": "https://www.hcaptcha.com/pricing"
  },
  {
   "label": "GitHub",
   "href": "https://github.com/hCaptcha/react-hcaptcha"
  }
 ],
 "track": "Outages, price changes and new versions on your dashboard",
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free credits",
   "status": "cond",
   "sub": "One-time or needs a card",
   "quote": "You've Unlocked a Free 14-Day Trial with hCaptcha Pro! No payment is required. Experience the benefits of frictionless 99.9% passive mode and custom themes .",
   "note": "Free tier: Basic plan is free ($0); no request cap stated on the pricing page. As reported on the official pricing page, checked Nov 10, 2026.",
   "src": "https://www.hcaptcha.com/pricing"
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "With conditions",
   "status": "cond",
   "sub": null,
   "quote": "The maximum number of requests per month permitted under the hCaptcha Publisher (free) tier is ten thousand (10,000) for Integrators, aside from use of the hCaptcha Services in a web application firewall.",
   "note": "Allowed on your own sites and apps; the free plan is capped at 10,000 requests a month, above that you need Pro or a written agreement.",
   "src": "https://www.hcaptcha.com/terms"
  },
  {
   "key": "key",
   "label": "Key & sign-up",
   "value": "API key, server only",
   "status": "info",
   "sub": "Env var HCAPTCHA_SECRET (and HCAPTCHA_SITEKEY), as named in the official Node.js guide",
   "quote": "Set HCAPTCHA_SECRET and HCAPTCHA_SITEKEY in your server environment using your dashboard credentials.",
   "note": "Two keys: a public sitekey in the page, and a secret sent from your server with each token to the siteverify address (form-encoded POST)",
   "src": "https://docs.hcaptcha.com/integrations/node"
  },
  {
   "key": "agent",
   "label": "Agent access",
   "value": "Docs for agents",
   "status": "info",
   "sub": "llms.txt · SDK",
   "quote": null,
   "note": " Our agent check: 4 of 6 (Nov 13, 2026).",
   "src": "https://www.hcaptcha.com/llms.txt"
  }
 ],
 "vfoot": "Checked against the maker's official pages, pricing on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What hCaptcha does",
   "parts": [
    {
     "t": "prose",
     "text": "hCaptcha is a protection a site owner adds to their own sign-up, login or contact forms to keep out bots and spam. A small check appears in the form, and your server asks hCaptcha whether the visitor passed before it accepts the form. There is a free plan and a paid Pro plan."
    },
    {
     "t": "list",
     "items": [
      "hCaptcha is one of 19 APIs in the Auth and user accounts category on AgentGid.",
      "Its cheapest paid plan ($139 a month) is the 11th cheapest of the 14 here with a monthly plan.",
      "It is one of 19 that can be started for free.",
      "3 of them ship an official MCP server; hCaptcha does not.",
      "Its official SDK is the 2nd most downloaded in the category (1.9M a week)."
     ],
     "muted": true
    },
    {
     "t": "h3",
     "text": "What people build with it"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Stop fake sign-ups",
       "text": "Add the check to your sign-up form so scripts cannot create piles of fake accounts.",
       "idea": false
      },
      {
       "title": "Check the form on your server",
       "text": "Before saving a sign-up or sending a message, your server asks hCaptcha whether the visitor's pass is real and fresh.",
       "idea": false
      },
      {
       "title": "Protect a WordPress site",
       "text": "Add the free WordPress plugin, paste your two keys, and switch protection on for your login, comment or contact forms.",
       "idea": false
      },
      {
       "title": "Move off Google reCAPTCHA",
       "text": "Swap the script address, the field name and the check address; everything else in your form keeps working.",
       "idea": false
      },
      {
       "title": "Check only when the button is pressed",
       "text": "Use the invisible mode so most visitors see no checkbox; the check runs when they press Submit.",
       "idea": false
      },
      {
       "title": "Guard a newsletter form",
       "text": "Put the check on your newsletter or waitlist form so bots cannot fill your list with junk or other people's addresses.",
       "idea": true
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "hCaptcha popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "1.9M",
       "l": "SDK downloads a week",
       "d": "+39.1% on the 4-week average",
       "up": true
      },
      {
       "n": "10",
       "l": "public agent repos use its SDK"
      },
      {
       "n": "668",
       "l": "GitHub stars, hCaptcha/react-hcaptcha"
      }
     ]
    },
    {
     "t": "small",
     "text": "SDK downloads from npm and PyPI, weekly. Numbers as of Nov 17, 2026."
    }
   ]
  },
  {
   "id": "pricing",
   "nav": "Pricing and limits",
   "h2": "Pricing",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Free tier",
       "v": "Basic plan is free ($0); no request cap stated on the pricing page"
      },
      {
       "l": "Cheapest plan",
       "v": "$139 a month"
      },
      {
       "l": "Usage price",
       "v": "Pro $139/month billed monthly or $99/month billed yearly, incl. 100K monthly evals, then $0.99 per 1K evals"
      },
      {
       "l": "Plans",
       "v": "Pro has a 14-day free trial (a trial, not a free tier). Enterprise is quote-only."
      }
     ]
    },
    {
     "t": "h3",
     "text": "What one action costs"
    },
    {
     "t": "table",
     "head": [
      "Action",
      "Price"
     ],
     "num": true,
     "rows": [
      [
       "1,000 checks above the 100K included in Pro",
       "$0.99"
      ],
      [
       "Pro plan, a month billed monthly (100K checks included)",
       "$139"
      ]
     ]
    },
    {
     "t": "more",
     "items": [
      {
       "title": "Price history",
       "items": [
        "A year of the pricing page in the Internet Archive (13 months): the lowest monthly figure went from $99 (2025-10) to $99 (2026-10).",
        "1 change in our catalog since Oct 20, 2026, last on Nov 13, 2026."
       ]
      }
     ]
    },
    {
     "t": "small",
     "text": "As reported on the official pricing page, checked Nov 10, 2026. Prices change: confirm before you buy.",
     "link": "hcaptcha.com/pricing",
     "href": "https://www.hcaptcha.com/pricing"
    }
   ]
  },
  {
   "id": "limits",
   "nav": null,
   "spy_as": "pricing",
   "h2": "Limits",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Basic (free, called Publisher in the terms)",
       "v": "10,000 requests a month for sites that add hCaptcha (outside web application firewalls)",
       "src": "https://www.hcaptcha.com/terms"
      },
      {
       "l": "Pro",
       "v": "100,000 checks a month included, then $0.99 per 1,000",
       "src": "https://www.hcaptcha.com/pricing"
      },
      {
       "l": "All plans",
       "v": "Peak 1,000 requests per second per account unless a contract says otherwise",
       "src": "https://www.hcaptcha.com/terms"
      },
      {
       "l": "All plans",
       "v": "A token can be checked once and expires after 120 seconds by default",
       "src": "https://docs.hcaptcha.com/"
      }
     ]
    },
    {
     "t": "small",
     "text": "From the official docs.",
     "link": "hcaptcha.com/terms",
     "href": "https://www.hcaptcha.com/terms"
    }
   ]
  },
  {
   "id": "status",
   "nav": "Status",
   "h2": "Status and incidents",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Right now",
       "v": "Up",
       "status": "yes",
       "sub": "All Systems Operational"
      },
      {
       "l": "Last 30 days",
       "v": "0 incidents, 0 of them major"
      }
     ]
    },
    {
     "t": "small",
     "text": "From the official status page, checked Nov 19, 2026.",
     "link": "hcaptchastatus.com",
     "href": "https://www.hcaptchastatus.com/"
    }
   ]
  },
  {
   "id": "access",
   "nav": "Access and terms",
   "h2": "Key and access",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "How it signs in",
       "v": "Two keys: a public sitekey in the page, and a secret sent from your server with each token to the siteverify address (form-encoded POST)"
      },
      {
       "l": "Environment variable",
       "v": "HCAPTCHA_SECRET (and HCAPTCHA_SITEKEY), as named in the official Node.js guide",
       "code": true
      },
      {
       "l": "Safe in browser code",
       "v": "No, keep it on your server",
       "status": "no"
      },
      {
       "l": "Card at sign-up",
       "v": "No"
      }
     ]
    },
    {
     "t": "h3",
     "text": "Steps only a person can do"
    },
    {
     "t": "list",
     "items": [
      "Create an hCaptcha account, add your site in Sites to get a sitekey, and copy the secret from Settings. Put HCAPTCHA_SITEKEY and HCAPTCHA_SECRET in .env (the secret kept out of git and out of browser code).",
      "Choose the difficulty mode for the sitekey, and Pro if you need the 99.9% Passive mode. No code change; the same keys keep working.",
      "Add a note about hCaptcha to the site's privacy policy (hCaptcha offers sample text; check it with your legal adviser). Add the \"protected by hCaptcha\" line near invisible-mode forms."
     ]
    }
   ]
  },
  {
   "id": "terms",
   "nav": null,
   "spy_as": "access",
   "h2": "Commercial use and your data",
   "parts": [
    {
     "t": "prose",
     "text": "hCaptcha is a hosted service under its own terms, free on the Basic plan up to the monthly limit and paid on Pro. The official React component is open source under the MIT license."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "With conditions",
       "status": "cond",
       "sub": "Allowed on your own sites and apps; the free plan is capped at 10,000 requests a month, above that you need Pro or a written agreement.",
       "quote": "The maximum number of requests per month permitted under the hCaptcha Publisher (free) tier is ten thousand (10,000) for Integrators, aside from use of the hCaptcha Services in a web application firewall.",
       "src": "https://www.hcaptcha.com/terms"
      },
      {
       "l": "redistribute-files",
       "v": "With conditions",
       "status": "cond",
       "sub": "The React component is MIT (keep its license notice); the hCaptcha script itself is loaded from hCaptcha and not redistributed.",
       "quote": "\"license\":\"MIT\"",
       "src": "https://registry.npmjs.org/@hcaptcha/react-hcaptcha/latest"
      },
      {
       "l": "client-work",
       "v": "With conditions",
       "status": "cond",
       "sub": "Fine for client sites; one account may cover many domains, and the client should name hCaptcha in its privacy policy.",
       "quote": "The number of domains is not restricted: some customers need to use many domains per sitekey.",
       "src": "https://docs.hcaptcha.com/faq"
      },
      {
       "l": "Trains on what you send",
       "v": "“Information collected as a result of End-Users answering prompts through the Service (\"Labeled Data\"), such as image labeling data, text converted from audio files played to those End-Users, answers to questions, and other prompts generated by the Service for purposes of labeling data for use in machine learning applications.”",
       "quote": null,
       "src": "https://www.hcaptcha.com/privacy"
      },
      {
       "l": "Where data is stored",
       "v": "“please be aware that your personal data will be transferred to, processed, and stored in the United States.”",
       "quote": null,
       "src": "https://www.hcaptcha.com/privacy"
      }
     ]
    }
   ]
  },
  {
   "id": "errors",
   "nav": null,
   "spy_as": "access",
   "h2": "Errors to handle",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "missing-input-secret / invalid-input-secret",
       "v": "Your secret key is missing, invalid or malformed.",
       "sub": "Check HCAPTCHA_SECRET on the server; generate a new secret in the dashboard settings if it was rotated."
      },
      {
       "l": "invalid-input-response / missing-input-response",
       "v": "The token from the form is missing or not valid.",
       "sub": "Reject the form and ask the visitor to try again; do not retry the same token."
      },
      {
       "l": "expired-input-response",
       "v": "The token is older than its lifetime (120 seconds by default).",
       "sub": "Reset the widget and get a fresh token before the next submit."
      },
      {
       "l": "already-seen-response",
       "v": "The same token was already checked once.",
       "sub": "Get a new token after every submission, expiry or error; tokens are single-use."
      },
      {
       "l": "sitekey-secret-mismatch",
       "v": "The sitekey in the page does not belong to the account of the secret.",
       "sub": "Use the sitekey and secret from the same hCaptcha account."
      }
     ]
    }
   ]
  },
  {
   "id": "agent",
   "nav": "For agents",
   "h2": "Use it from an agent",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Our agent check",
       "v": "4 of 6: llms.txt yes, OpenAPI no, SDK yes, MCP no, status page yes, AI assistants allowed yes",
       "sub": "Checked Nov 13, 2026."
      },
      {
       "l": "MCP server",
       "v": "None found",
       "sub": null
      },
      {
       "l": "npm",
       "v": "npm install @hcaptcha/react-hcaptcha",
       "code": true
      }
     ]
    },
    {
     "t": "h3",
     "text": "Instructions in its docs to check first"
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "The docs say",
       "v": "“Using Codex, Claude Code, or another agent? Add Agent Skills for Docs to make your agent an expert.”",
       "sub": "The linked page gives a skill file to install into the agent's folders with shell commands; ask the person before installing anything into their agent setup."
      },
      {
       "l": "The docs say",
       "v": "“Copy this into your agent skill instructions.”",
       "sub": "Instructions written for agents to install themselves; read the docs pages directly instead and ask the person before adding skills."
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "hCaptcha",
       "me": true,
       "facts": [
        "$0.99 / 1k requests",
        "Free tier"
       ]
      },
      {
       "name": "Clerk",
       "why": "Pick Clerk when you want the whole sign-up and sign-in flow handled for you, not only a bot check in your own form.",
       "path": "apis/clerk/",
       "facts": [
        "from $0.012/mo",
        "Free tier"
       ]
      }
     ],
     "more": "All auth and user accounts APIs",
     "more_path": "apis/auth/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Protect my sign-up form with hCaptcha: add @hcaptcha/react-hcaptcha at a fixed version with my public sitekey, and on the server POST the h-captcha-response token with HCAPTCHA_SECRET from .env (form-encoded) to https://api.hcaptcha.com/siteverify, accepting the form only when success is true."
    },
    {
     "t": "steps",
     "items": [
      {
       "text": "Create an hCaptcha account, copy the public sitekey from Sites and the secret from Settings; the secret stays on your server.",
       "code": null,
       "src": "https://docs.hcaptcha.com/"
      },
      {
       "text": "Load the script and put the check inside your form.",
       "code": "<script src=\"https://js.hcaptcha.com/1/api.js\" async defer></script>\n<div class=\"h-captcha\" data-sitekey=\"your_site_key\"></div>",
       "src": "https://docs.hcaptcha.com/"
      },
      {
       "text": "On the server, send the h-captcha-response token and your secret to the siteverify address and continue only when success is true.",
       "code": "curl https://api.hcaptcha.com/siteverify \\\n  -X POST \\\n  -d \"secret=YOUR-SECRET&remoteip=CLIENT-IP&response=CLIENT-RESPONSE\"",
       "src": "https://docs.hcaptcha.com/"
      }
     ]
    },
    {
     "t": "h3",
     "text": "First request"
    },
    {
     "t": "tabs",
     "label": "First request",
     "items": [
      {
       "tab": "Request",
       "code": "curl https://api.hcaptcha.com/siteverify \\\n  -X POST \\\n  -d \"secret=YOUR-SECRET&remoteip=CLIENT-IP&response=CLIENT-RESPONSE\"",
       "intro": "A form-encoded POST from your server with your secret and the token from the form; response shape trimmed from the developer guide (the score fields are Enterprise only)."
      },
      {
       "tab": "Response",
       "code": "{\n  \"success\": true|false,\n  \"challenge_ts\": timestamp,\n  \"hostname\": string,\n  \"error-codes\": [...]\n}"
      }
     ]
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Trusting the onVerify callback in the browser and skipping the server check.",
       "fix": "Send the token to your server and call siteverify there; accept only when success is true.",
       "why": "The docs say a frontend callback alone does not authorize the request."
      },
      {
       "dont": "Posting JSON to siteverify, or passing the secret in the address with GET.",
       "fix": "Use a form-encoded POST body (URLSearchParams in Node, data= in Python requests).",
       "why": "The endpoint expects a standard form POST; GET or JSON may fail."
      },
      {
       "dont": "Reusing one token for a retry after an error or a second submit.",
       "fix": "Reset the widget (resetCaptcha through a ref in React) and get a fresh token for each attempt.",
       "why": "Tokens are single-use and expire."
      },
      {
       "dont": "Leaving the test sitekey and secret in production.",
       "fix": "Use test keys only on a test site; put real keys in the production environment before launch.",
       "why": "Test keys always pass and give no protection."
      },
      {
       "dont": "Not sending the sitekey to siteverify.",
       "fix": "Pass the sitekey you expect along with the secret and token.",
       "why": "Otherwise a token from an easier sitekey could be accepted on a harder one."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Is hCaptcha free?",
       "a": "The Basic plan is $0; the terms cap it at 10,000 requests a month for sites. Pro costs $139 a month, or $99 a month billed yearly.",
       "evidence": {
        "url": "https://www.hcaptcha.com/terms",
        "quote": "The maximum number of requests per month permitted under the hCaptcha Publisher (free) tier is ten thousand (10,000) for Integrators, aside from use of the hCaptcha Services in a web application firewall."
       }
      },
      {
       "q": "Can visitors skip the checkbox?",
       "a": "Yes, the invisible mode runs the check when they submit the form and shows a puzzle only to suspicious visitors. Fully passive modes need Pro or Enterprise.",
       "evidence": {
        "url": "https://docs.hcaptcha.com/invisible",
        "quote": "This option is available to all users."
       }
      },
      {
       "q": "Do I need to change my privacy policy?",
       "a": "hCaptcha recommends it, and gives sample text describing what it processes; this is not legal advice.",
       "evidence": {
        "url": "https://docs.hcaptcha.com/faq",
        "quote": "We also recommend integrating a notice into your Privacy Policy similar to the one directly below this answer."
       }
      },
      {
       "q": "How hard is it to switch from reCAPTCHA?",
       "a": "hCaptcha works the same way as reCAPTCHA v2; you change the script, the field name and the check address.",
       "evidence": {
        "url": "https://docs.hcaptcha.com/switch",
        "quote": "hCaptcha is API-compatible with reCAPTCHA."
       }
      },
      {
       "q": "Is it accessible to people with disabilities?",
       "a": "hCaptcha says it offers email verification and text-based challenges, and recommends checking your own setup.",
       "evidence": {
        "url": "https://docs.hcaptcha.com/faq",
        "quote": "We offer both an email-verification system and optional text-based challenges, available in over 100 languages."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Maker",
   "Intuition Machines"
  ],
  [
   "Category",
   "Auth and user accounts"
  ],
  [
   "Status",
   "Up · 0 incidents in 30 days"
  ],
  [
   "Price",
   "$0.99 / 1k requests"
  ],
  [
   "Plans from",
   "$139/mo"
  ],
  [
   "Official SDK",
   "npm @hcaptcha/react-hcaptcha"
  ],
  [
   "Latest SDK",
   "2.2.0 on npm"
  ],
  [
   "Agent check",
   "4 of 6"
  ],
  [
   "Pricing checked",
   "Nov 10, 2026"
  ]
 ],
 "good": [
  "The check in the page alone protects nothing; your server must ask hCaptcha about every token and refuse the form when the answer is not a success.",
  "The free plan allows 10,000 checks a month under the terms; past that, hCaptcha may end the service unless you upgrade.",
  "The published test keys always pass and give no protection; use them only on a test site and switch to your real keys before launch."
 ],
 "checked_line": "Read by AgentGid from 17 official pages, card checked Nov 10, 2026; usage numbers update daily."
}