Getting Started
Quick Start
Identify your first device in under 60 seconds.
Three steps
- Install the browser SDK
- Initialize with your publishable API key
- Call
identify(): session tokens are managed automatically
1. Install
Recommended: drop the CDN script tag into your HTML. No build step; the SDK is exposed as the LightningResearchSDK browser global.
<script src="https://lrdefender.lightningresearch.ai/sdk/v1/lr.min.js"></script>Using a bundler or TypeScript? Install the npm package instead.
npm install @lightningresearch/sdk2. Identify
The SDK collects 90+ browser signals and returns a stable device ID with confidence and risk metadata.
// sessionToken is minted by your server and passed to the browser
const lr = new LightningResearchSDK.LightningResearch({ sessionToken });
const { deviceId, confidence } = await lr.identify();Framework quick links
Prefer hooks, composables, or native modules? The core SDK already runs in every framework via the CDN script tag or @lightningresearch/sdk. Idiomatic framework wrappers are available on request: email support@lightningresearch.ai.
Server-side integration
For merchant backends, use the server SDK to retrieve events, look up visitors, run bot checks, and assess IP threats. Authenticate with your secret API key via Bearer token or X-API-Key.
Need ad-blocker bypass?
Route fingerprint traffic through a first-party subdomain on your domain. Edge proxies defeat ad blockers, enable 1-year visitor cookies, and reduce third-party latency.
Proxy Setup guide