Skip to content

/ developer docs

Get your site tolled

Tell naulon who wrote each article and where their cut goes, then point the toll at your origin. Your pages don’t change; agents that want to read them start paying.

Getting tolled

The whole job: a credits endpoint, a wallet per author, your origin. Start here.

The credits API

The one read-only route on your domain that names who wrote each article and where their cut goes.

The catalog endpoint

Optional: list your articles so AI buyers find them in the naulon directory before they’ve read one.

Your public toll record

Publish what agents paid you, what they declined, and what people read free — and embed it as a badge on your own site.

Tolling files

PDFs, datasets and downloads are free until you pick them — and what tolling a paper costs you in Google Scholar.

Settlement

How the money reaches you: buyer → author, direct, custody-free.

For authors

You were invited to claim your articles: accepting, setting the wallet your share lands in, and checking that it arrived.

For buyers

Running an agent that reads tolled pages: one balance, agents with budgets, and what naulon can and cannot do with your money.

Webhooks

A signed POST (or a Slack/Discord/Teams message) when a settlement lands or an anomaly fires.

Crawler policy

Per crawler: reads free, pays the toll, or refused outright, plus one-price section tolling.

Your licence, in RSL

The machine-readable licence we publish for your site, what it grants, and the one line for your robots.txt.

Verified crawler identity

Cryptographically verified bot identity (Web Bot Auth), and masquerade attempts caught.

The naulon fetcher

What the naulon fetcher is, how to recognize it (Web Bot Auth, signed as naulon.app), and how to allow or block it.

Connect your own domain

Two DNS records and a click: your own domain tollable through the edge, with a certificate issued and renewed for you.

Protect your origin

If your origin has its own bot or rate protection: the header that lets naulon's traffic through, per platform, verified end to end.

In-app enforcement

When your origin’s edge rate-limits naulon: run the toll inside your own app, so the agent hits your origin directly. No shared IP, no 429.

Billing and invoices

The account-level bill, not the toll: when a period is actually invoiced, the two ways to pay one, and what an unpaid invoice does and does not cost you.

Team and access

The two rosters around your account, what each role can actually do, and how an invite, a role change and a removal behave.

Enterprise controls

Single sign-on, data subject requests, reconciliation, the audit log, and scheduled exports and anomaly alerts — what each one does and who can configure it.

API reference

The HTTP API for pricing a resource, settling from your own runtime, and pulling earnings and audit data — plus the interactive reference served from the running code.

Authentication

Mint an nln_live_ key, send it as a bearer token, and the scopes each endpoint needs.

Errors

The status codes and response shapes the API returns on failure.

Rate limits

The plan gate, the response row caps, and how to page through large results.