Developers

Built to be integrated

A dependency-free TypeScript SDK, a plain REST endpoint, edge and CDN paths, and an API to verify agents yourself. Wire Lume in however you ship.

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 Solo and up

Send a request’s headers and get back the agent’s verified identity (operator, type, and whether it’s authentic) 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

TypeScript SDK REST Cloudflare Worker Vercel middleware WordPress plugin Fastly Akamai AWS CloudFront GCP Cloudflare Logpush

We dogfood the agentic web

Lume is the AI-agent analytics product, so 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 →