SDK & API

Send traffic to Lume from any language

A plain authenticated POST to the ingest endpoint, from any language, runtime, or your own batching layer.

One HTTP POST, server-side · zero client JS

Install

1Create an ingest token

Generate one under Settings → Tokens.

2POST your request metadata

Send a JSON body to https://in.lumetraffic.com/visits with an Authorization: Bearer header, one event per request.

3Send from anywhere

Call it from your server, an edge worker, or your own batching layer. Any stack that can make an HTTPS request works.

Any language: a plain authenticated POST

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" }'

Good to know

The escape hatch when there is no SDK for your stack: any language, any runtime.
Include the visitor IP to enable crawler verification (used transiently, never stored). Omit it and agents are identified by user-agent + catalog and shown as not network-verified.

Works with the rest of your stack

Lume is CDN-agnostic and server-side. This is one of several install paths, all feeding the same dashboard. Mix and match across hosts, or move providers without losing your history.

All integrations Developer docs How it works

REST API FAQ

Which fields does the endpoint accept?

request_host, request_path, user_agent, referer, accept_language, response_status and more. See /developers for the full field list and response codes.

Do I have to batch requests?

No, one POST per request is fine. If you are at high volume, build your own batching layer in front of the endpoint, or use the SDK, which batches for you.

Send your first REST API event in minutes.

Free plan, one ingest token. See every human, bot, and AI agent, however you install.

Start for free →