Install Botfighter

Paste one script tag on your site. That's it.

html

<script
  src="https://botfighter.dev/botfighter.js"
  data-site="YOUR-SITE-ID"
  data-api="https://api.botfighter.dev"
  data-honeypot="true"
  defer>
</script>

Finding your Site ID

Snippet attributes

Attribute	Required	Default	Description
`data-site`	Yes	—	Your unique site ID from the dashboard
`data-api`	No	`https://api.botfighter.dev`	API endpoint (change only if self-hosting)
`data-honeypot`	No	`false`	Render an invisible honeypot link to catch naive bots
`data-sample`	No	`1.0`	Sampling rate (0.0–1.0). Set to `0.1` to report 10% of visits
`data-privacy`	No	`false`	Strip IP and canvas fingerprint before sending — GDPR-friendly mode

Where to put it

Place the snippet before </body> on every page. The defer attribute means it loads after your content — no impact on page rendering.

html

  <!-- your page content -->

  <script
    src="https://botfighter.dev/botfighter.js"
    data-site="YOUR-SITE-ID"
    data-api="https://api.botfighter.dev"
    data-honeypot="true"
    defer>
  </script>
</body>

What the snippet does NOT do

Does not set cookies
Does not block or redirect any visitor
Does not slow down page load (defer + async signal POST)
Does not send any data to third parties

Verify it's working

Open your site in a browser
Open DevTools → Network tab → filter by signal
You should see a POST to https://api.botfighter.dev/signal returning {"ok":true}
Within a few seconds, the visit appears in your dashboard

Platform guides

Pick your platform for step-by-step instructions:

Need help? Open an issue on GitHub or check the dashboard for your live signal feed.

Install Botfighter ​

Snippet attributes ​

Where to put it ​

What the snippet does NOT do ​

Verify it's working ​

Platform guides ​