Get Started in 5 Minutes
Five steps to accurate device identification. No credit card required.
Sign Up
Create your account in seconds. No credit card required. Get 2,500 free API calls per month.
Get Public Key
Copy your public key from the dashboard. It's a 40-character hex string, safe to ship in client-side code.
Install SDK
Add the @tracio/sdk client library. See the Quick Start for framework-specific packages.
$ npm install @tracio/sdkUsing a framework? See the Quick Start for React, Vue, Angular, and Svelte packages.
Identify a Visitor
Initialize with Tracio.init(), then call tracio.getResult() to receive a unique visitor ID and bot detection result.
import { Tracio } from '@tracio/sdk'
// Initialize the SDK
const tracio = Tracio.init({ publicKey: '5ca175fc...' })
// Get the visitor identification
const result = await tracio.getResult()Verify
Confirm the event landed by querying the server API. Server-side requests authenticate with a Clerk-issued JWT. See the API Reference for the full schema.
$ curl -H "Authorization: Bearer $JWT" \
https://app.tracio.ai/api/v1/subscriptions/{workspaceId}/events/{requestId}{
"ok": true,
"data": {
"request_id": "1710432000_abc123def",
"visitor_id": "X7fh2Hg9LkMn3pQr",
"bot_result": "human",
"confidence": 0.95,
"ip_country": "CZ"
}
}See the API Reference for the full event schema and authentication details.
Troubleshooting
npm install fails?
Make sure you're running Node.js v16 or later. Run node --version to check.
Public key not working?
Verify your key is the 40-character public key from the workspace you're working in.
Empty result?
Check your region configuration matches the region you selected during signup.
CORS error?
Use the proxy integration setup to route requests through your own domain.
Ready to Get Started?
Create your free account and start identifying visitors in under 5 minutes.