Built to be integrated
A dependency-free TypeScript SDK, a plain REST endpoint, edge and CDN log paths that add zero client JS and no latency, and an API to verify agents yourself. Wire Lume in however you ship — the SDK is optional, not required.
SDK quickstart
Install lumetraffic and send your first event. Zero dependencies, batched and retrying by default.
import { Lume } from 'lumetraffic'
const lume = new Lume(process.env.LUME_INGEST_TOKEN)
// In your request handler:
lume.trackPageview(req, res) REST ingest
No SDK? Post request metadata straight to the ingest endpoint.
curl -X POST https://in.lumetraffic.com/visits \
-H "Authorization: Bearer $LUME_INGEST_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "request_host": "example.com", "request_path": "/",
"user_agent": "GPTBot/1.2" }' Identification API Starter and up
Send a request’s headers and get back the agent’s verified identity — operator, type, and whether it’s genuinely who it claims to be, checked against signatures, reverse DNS, and published IP ranges rather than a user-agent anyone can fake — so you can gate, route, or log agent traffic yourself.
POST https://in.lumetraffic.com/agent-identifications
{ "user_agent": "GPTBot/1.2", "ip": "…", "headers": { … } }
→ { "operator": "openai", "type": "AI Search Crawlers",
"verified": true, "method": "web_bot_auth" } Install paths
We dogfood the agentic web
Lume tells your humans, bots, and AI agents apart, so it practices what it measures: this site ships a real, machine-readable /llms.txt, generated from the same catalog that powers the dashboard.
Send your first event in a minute.
Free plan, one ingest token, dependency-free SDK. Start building.
Start for free →