Skip to content
PricingDocs

Developer Tools

API Playground

Try the tracio.ai API without signing up. Build requests, see responses, and explore our device intelligence endpoints.

Identify a visitor by device signals

Request

curl -X POST \
  https://api.tracio.ai/api/v1/identify \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer trc_live_xxxxxxxxxxxx" \
  -d '{
  "visitorId": "auto",
  "signals": {
    "userAgent": "Mozilla/5.0 ...",
    "language": "en-US",
    "platform": "MacIntel",
    "screenResolution": [
      2560,
      1440
    ],
    "timezone": "America/New_York"
  },
  "linkedId": "user-123",
  "tag": {
    "sessionType": "login"
  }
}'
POST /api/v1/identify

Response

Click "Send Request" to see the response

Response Format

All API responses follow a consistent JSON format with request metadata, identification results, and confidence scores.

{
  "requestId": "string",     // Unique request identifier
  "visitorId": "string",     // Stable visitor identifier (trc_...)
  "confidence": {
    "score": 0.995           // 0.0 — 1.0 confidence score
  },
  "firstSeenAt": "ISO8601",  // First time this visitor was seen
  "lastSeenAt": "ISO8601",   // Most recent visit
  "ip": "string",            // Client IP address
  "ipLocation": {            // GeoIP data
    "country": "string",
    "region": "string",
    "city": "string"
  },
  "bot": {                   // Bot detection result
    "result": "notDetected"  // notDetected | bad | good
  }
}

Get Your API Key

Ready to integrate? Sign up for a free account and get your live API key in under a minute.

Get Your API Key