Quick Start

Getting Started

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

terminal

npm install @lightningresearch/sdk

2. Identify

The SDK collects 90+ browser signals and returns a stable device ID with confidence and risk metadata.

identify.ts

import { LightningResearch } from '@lightningresearch/sdk';

const lr = new LightningResearch({ apiKey: 'pk_live_xxx' });
const { deviceId, confidence } = await lr.identify();

Framework quick links

Prefer hooks, composables, or native modules? Use the official framework package — each wraps the core SDK.

React / Next.js

@lightningresearch/react

Vue / Nuxt

@lightningresearch/vue

Angular

@lightningresearch/angular

React Native

@lightningresearch/react-native

Flutter

lrdefender

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.

Server API reference

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