Test Your Bot

Run your bot through our test environment to get a conduct score (0-100) and a certificate valid for 1 year.

Step 1: Start a test session

curl -X POST https://botconduct.org/test/start \
  -H "Content-Type: application/json" \
  -d '{
    "bot_name": "YourBot",
    "operator": "YourCompany",
    "contact_url": "https://yoursite.com/contact",
    "declaration_url": "https://yoursite.com/bot-declaration.json",
    "report_url": "https://yoursite.com/transparency"
  }'

You'll receive a session_id and a test_url.

Step 2: Crawl the test environment

Point your bot at the test_url. The environment contains 20+ pages including:

• Public content (products, blog, about pages)
• robots.txt with restricted areas
• Honeypot links (hidden, only bots follow them)
• Synthetic PII traps (SSN, credit cards, emails)
• Opt-out signals (X-Bot-Optout header)
• Rate limit headers
• Redirect chains
• Meta nofollow/noindex directives

Your bot should behave as it normally would on any website.

Step 3: Get your score

curl -X POST https://botconduct.org/test/finish/YOUR_SESSION_ID

You'll receive:

• Score (0-100) across 10 conduct criteria
• A signed certificate valid for 1 year
• A renewal token for easy re-certification
• Detailed breakdown of what your bot did right and wrong

Step 4: Renew annually

curl -X POST https://botconduct.org/api/renew \
  -H "Content-Type: application/json" \
  -d '{
    "bot_name": "YourBot",
    "renewal_token": "YOUR_RENEWAL_TOKEN"
  }'

Verify any certificate

curl https://botconduct.org/api/verify/CERTIFICATE_ID

Questions? hello@botconduct.org