Bot Butcher

Bot Butcher is an AI-powered spam detection API that uses a fine-tuned large language model to classify contact form submissions as spam or legitimate messages. The service analyzes messages within the context of what each website is about, providing context-aware classification with 99% reported accuracy against the provider's own human-graded benchmark. It supports multi-tenant architectures and is designed for enterprise scalability across vertical SaaS and website builder platforms. The API has two operations — classify a message, retrieve a message by id — authenticated with a per-form x-api-key header, and is sold on a single usage-based plan whose first ten requests each month are free. Bot Butcher is operated by Hillside Lab Inc, a Delaware corporation based in Pasadena, California.

Bot Butcher publishes 1 API on the APIs.io network: Classification API. Tagged areas include Bots, Spam Detection, Contact Forms, AI Classification, and Security.

Bot Butcher’s developer surface includes documentation, API reference, getting-started guide, signup flow, pricing, authentication, and 16 more developer resources.

🌐 Visit website 📡 Source on GitHub

36.2/100 thin ▬ flat Agent 29/100 agent ready Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0

AccessSelf serveFree trial⚡ Free to try

1 APIs

BotsSpam DetectionContact FormsAI ClassificationSecurity

Kin Score

Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0

Composite quality — 36.2/100 · thin

Contract Quality 3.4 / 23

Developer Ergonomics 8.5 / 18

Access Clarity 13.3 / 18

Operational Transparency 0.0 / 12

Contract Governance 2.0 / 11

Discoverability 6.2 / 9

Create-or-Update Ergonomics 0.0 / 10

Agent readiness — 29/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/bot-butcher: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

Bot Butcher Classification API

Submit contact form data to Bot Butcher and receive a JSON classification result indicating whether the message is spam or legitimate. The AI model classifies each message withi...

Open Collections 3

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

Bot Butcher Classification API

OPEN COLLECTION

Bot Butcher Classification API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Bot Butcher Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Bot Butcher Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Bot Butcher Finops

FINOPS

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Bot Butcher Authentication

apiKey · 1 scheme

SECURITY

Bot Butcher Domain Security

TLSv1.3

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Bot Butcher Agentic Access

2 operations · 1 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

GettingStarted

GettingStarted

SignUp

SignUp

Login

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

LLMsTxt

LLMsTxt

AgentSkill

AgentSkill

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Conventions

ErrorCatalog

Lifecycle

Conformance

DataModel

Build 1

SDKs, sample code, and the tooling you integrate with

Postman

Postman

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 1

Status, limits, changes, and where to get help

RateLimits

RateLimits

Commercial 4

Pricing, plans, and the legal terms of use

Pricing

TermsOfService

PrivacyPolicy

Plans

Company 1

The organization behind the API

Website

Website

Source (apis.yml)

aid: bot-butcher
url: https://raw.githubusercontent.com/api-evangelist/bot-butcher/refs/heads/main/apis.yml
name: Bot Butcher
tags:
- Bots
- Spam Detection
- Contact Forms
- AI Classification
- Security
type: Index
kind: company
deliveryModel:
  model: unknown
  open_source: false
  commercial: true
  callable_host: true
  label: Commercial API — usage-based pricing published, no product licence on record
  confidence: medium
  source:
  - openapi
  - plans
  generated: '2026-09-04'
  method: derived
accessModel:
  pricing: usage-based
  onboarding: self-serve
  trial: true
  try_now: true
  public: true
  label: Usage-based · Self-serve signup · First 10 requests each month free
  confidence: high
  source:
  - plans
  - authentication
  - security
  generated: '2026-09-04'
  method: searched
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/bot-butcher.png
access: 3rd-Party
created: '2025-01-07'
modified: '2026-09-04'
position: Consuming
description: Bot Butcher is an AI-powered spam detection API that uses a fine-tuned large language model to classify contact
  form submissions as spam or legitimate messages. The service analyzes messages within the context of what each website is
  about, providing context-aware classification with 99% reported accuracy against the provider's own human-graded benchmark.
  It supports multi-tenant architectures and is designed for enterprise scalability across vertical SaaS and website builder
  platforms. The API has two operations — classify a message, retrieve a message by id — authenticated with a per-form x-api-key
  header, and is sold on a single usage-based plan whose first ten requests each month are free. Bot Butcher is operated by
  Hillside Lab Inc, a Delaware corporation based in Pasadena, California.
apis:
- aid: bot-butcher:bot-butcher-classification-api
  name: Bot Butcher Classification API
  tags:
  - Spam Detection
  - Bot Detection
  - AI Classification
  - Contact Forms
  - Classification
  humanURL: https://botbutcher.com/documentation
  baseURL: https://api.botbutcher.com
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/bot-butcher.png
  description: Submit contact form data to Bot Butcher and receive a JSON classification result indicating whether the message
    is spam or legitimate. The AI model classifies each message within the context of your specific website, delivering context-aware
    spam detection for multi-tenant and enterprise applications. A message_id returned with each verdict can be used to retrieve
    the stored message and its classification later.
  properties:
  - type: OpenAPI
    url: openapi/bot-butcher-classification-api-openapi.yml
  - type: Documentation
    url: https://botbutcher.com/documentation
  - type: APIReference
    url: https://botbutcher.com/documentation
  - type: PostmanCollection
    url: collections/bot-butcher-api-published.postman_collection.json
  - type: Overlay
    url: overlays/bot-butcher-classification-api-overlay.yaml
  - type: X-MCPServerCandidate
    url: mcp/bot-butcher-mcp.yml
  contact:
  - FN: Bot Butcher Support
    email: botbutcher@hillsidelab.com
    url: https://botbutcher.com/
common:
- type: Website
  url: https://botbutcher.com/
- type: Documentation
  url: https://botbutcher.com/documentation
- type: APIReference
  url: https://botbutcher.com/documentation
- type: GettingStarted
  url: https://botbutcher.com/get-started
- type: SignUp
  url: https://botbutcher.com/get-started
- type: Login
  url: https://botbutcher.com/login
- type: Pricing
  url: https://botbutcher.com/pricing
- type: TermsOfService
  url: https://botbutcher.com/terms
- type: PrivacyPolicy
  url: https://botbutcher.com/privacy
- type: Postman
  url: https://god.postman.co/run-collection/24192121-47f4e172-5026-4788-b752-cbbc5488a03e
- type: AgenticAccess
  url: agentic-access/bot-butcher-agentic-access.yml
- type: DomainSecurity
  url: security/bot-butcher-domain-security.yml
- type: Authentication
  url: authentication/bot-butcher-authentication.yml
- type: Conventions
  url: conventions/bot-butcher-conventions.yml
- type: ErrorCatalog
  url: errors/bot-butcher-problem-types.yml
- type: Lifecycle
  url: lifecycle/bot-butcher-lifecycle.yml
- type: Conformance
  url: conformance/bot-butcher-conformance.yml
- type: DataModel
  url: data-model/bot-butcher-data-model.yml
- type: Plans
  url: plans/bot-butcher-plans-pricing.yml
- type: RateLimits
  url: rate-limits/bot-butcher-rate-limits.yml
- type: LLMsTxt
  url: llms/bot-butcher-llms.txt
- type: AgentSkill
  url: skills/_index.yml
properties:
- type: x-domain
  value: botbutcher.com
- type: x-operator
  value: Hillside Lab Inc (Delaware corporation, Pasadena, California)
- type: x-industry
  value: Cybersecurity, Spam Detection
- type: x-authentication
  value: API Key (x-api-key header, one key per contact form)
- type: x-classification-model
  value: Fine-tuned Large Language Model (LLM)
- type: x-accuracy
  value: 99% against the provider's human-graded benchmark test
- type: x-features
  value: Spam classification, message retrieval by message_id, optional message storage, Do Not Train mode, Do Not Save mode,
    multi-tenant support, unlimited websites, context-aware classification
- type: x-use-cases
  value: Contact form spam filtering, enterprise SaaS spam protection, multi-tenant application security, website builder
    platform integration
- type: x-response-format
  value: JSON
- type: x-workflow
  value: 1. POST contact form data to Bot Butcher endpoint, 2. AI classifies message as spam or not spam, 3. Receive JSON
    result, 4. Optionally retrieve message by message_id
- type: x-no-sdks
  value: No client libraries are published in any package registry; the reference offers copy-paste snippets in seven languages
    built on stock HTTP clients.
- type: x-agent-gaps
  value: No idempotency on the billable write, no reversal path for a stored message, no published rate limits or rate-limit
    headers, and no sandbox or test mode.
maintainers:
- FN: Kin Lane
  email: info@apievangelist.com
specificationVersion: '0.23'
x-enrichment:
  date: '2026-09-04'
  status: enriched
  artifacts_added: 14
  pass: local-v3

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/bot-butcher"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/bot-butcher/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/bot-butcher/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.