Skip to main content

Quick Start Guide

Get up and running with Trusted Accounts in under 5 minutes. This guide will walk you through setting up bot detection (our core service) and show you how to optionally add other protection layers.

🚀 Step 1: Get Your Credentials​

  1. Visit the Developer Console
  2. Sign up for a free account
  3. Create your first project
  4. Copy your PUBLISHABLE_KEY from the project settings

🎯 Step 2: Add Bot Detection (Required Foundation)​

Add this single script tag to your HTML (in the <head> or <body>):

<script 
  async 
  src="https://api.trustedaccounts.org/js-sdk.js" 
  onload="new TrustedTraffic({publishableKey:'YOUR_PUBLISHABLE_KEY'}).init()">
</script>

That's it! You now have:

  • ✅ Real-time bot detection
  • ✅ Traffic analytics dashboard
  • ✅ Zero backend changes required

📊 Step 3: View Your Results​

  1. Open your Admin Console
  2. Navigate to Traffic Overview
  3. See live charts showing human vs. bot traffic
  4. Monitor suspicious IP clusters and route heatmaps

🔒 Step 4: Add Account Protection (Optional)​

When you're ready to validate individual users, add this backend integration:

Frontend: Get the session ID​

const taSessionId = window.localStorage.getItem('ta_session_id');
// Pass this to your backend (e.g., in signup/login forms)

Note: The API uses Bearer token authentication. Include your secret key in the Authorization header as Bearer YOUR_SECRET_KEY.

Backend: Bind user to traffic​

// Example with Axios
await axios.post(
  `https://api.trustedaccounts.org/api/v1/traffic/bind`,
  {
    trustedSessionId: taSessionId,
    userId: 'your_user_id'
  },
  {
    headers: {
      'Authorization': `Bearer ${SECRET_KEY}`,
      'Content-Type': 'application/json'
    }
  }
);

🚨 Troubleshooting​

Script not loading?​

  • Check your internet connection
  • Verify the script URL is correct
  • Ensure no ad blockers are interfering

No data in dashboard?​

  • Confirm your PUBLISHABLE_KEY is correct
  • Check browser console for errors
  • Wait a few minutes for data to appear

Need help?​

Pro Tip: Start with bot detection and add other services as your security needs grow. The foundation you just built will make adding additional protection layers much easier!