← Back to Bot Hound

Bot Hound API

Check any 𝕏 (Twitter) account for bot-ness from your own code. Send a username, get a bot-likelihood score back in seconds. No subscription — every check is paid for out of your prepaid balance.

Pricing

Volume	Price
Single scan	$0.40 / scan
Batch of more than 10 accounts	$0.32 / scan

Charges are drawn straight from your account balance — no invoices, no card on file for API usage. Top up your balance.

Batch requests accept up to 1,000 accounts per request.

Quick start

Submit a check with your API key as a Bearer token:

curl -X POST https://api.bot-hound.com/api/v1/bot-checks \
  -H "Authorization: Bearer bh_live_..." \
  -H "Content-Type: application/json" \
  -d '{"username": "suspicious_handle"}'

# -> 202 {"check_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","status":"processing","cost_cents":40,"balance_cents":1420}

Then poll for the result:

curl https://api.bot-hound.com/api/v1/bot-checks/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "Authorization: Bearer bh_live_..."

# -> 200 {"status":"completed","bot_probability":0.87,"verdict":"Very likely a bot", ...}

Full API reference → · Raw spec (openapi.yaml)

Your API key

Usage