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 server-side. TRACIO delivers each identification to your endpoint as a signed webhook, and every event is also visible in your dashboard.
X-Tracio-Signature: t=1710432000,v1=5257a869…
{
"requestId": "9c1f4b2e-7d3a-4f18-8b6c-2e5a71d0c4f9",
"visitorId": "X7fh2Hg9LkMn3pQr5tBvQw3xZa9mK2pL4nR8dT6y",
"bot": { "result": "human", "score": 2 },
"identification": { "confidence": 0.95 },
"geo": { "country": "CZ", "city": "Prague" }
}Verify the X-Tracio-Signature HMAC, then act on the payload. See Webhooks for the full payload and signature verification.
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.