Piloterr

What is Piloterr?

How Piloterr works, and what you get with an account.

Piloterr is an HTTP API you call from your own backend, automation platform, or AI agent. You send a request with your API key, we do the work, and you get structured JSON back. Each successful call consumes credits from your account balance.

Piloterr — how a call works

Your backend

x-api-key header

Piloterr

JSON response

Billed

200

successful responses

Free

4xx / 5xx

errors cost nothing

Balance

Credits

checked on every call

A request carries your key, comes back as JSON, and only successful calls are billed.

The three things you need

WhatWhere
An accountSign up on the dashboard at https://app.piloterr.com
An API keyAPI Keys in the sidebar, sent as the x-api-key header
CreditsIncluded with your plan, topped up manually or automatically

What happens on a request

Your backend sends the call

The request hits https://api.piloterr.com with the x-api-key header. Never put the key in a browser or mobile app.

We check the key and the balance

Invalid, inactive, or expired keys return 401. An empty balance or unpaid invoice returns 402. Rate limits also return 401, with a message that names the limit.

We run the endpoint and return JSON

On success you get structured data. The call is logged under API Logs with its status, duration, and credit cost.

Credits are deducted only when the call succeeds

Successful responses are billed. Authentication failures, bad parameters, and server errors cost nothing — so you can experiment without burning the balance.

What the dashboard is for

The API itself is stateless: you authenticate with a key and get a response. The dashboard is where you manage everything around it — browsing the endpoint Library, issuing and revoking keys, watching consumption, downloading invoices, and inviting teammates. You never need the dashboard to make a call, but you will use it to keep an integration healthy.

After signup you land on the Library. The remaining balance also sits at the bottom of the sidebar on every screen, so you always know how much runway you have left.

On this page