astralpdf.com API

Quickstart

1. Create an account on the developer console.
2. Mint a token. It is shown once, so copy it.
3. Call any tool.

curl -X POST https://astralpdf.com/api/v1/pdf-info \
  -H "Authorization: Bearer ast_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input": "Hello  world — from an AI."}'

{
  "tool": "pdf-info",
  "result": "Hello world - from an AI.",
  "chars": 24,
  "ms": 1
}

Authentication

Send the token in the Authorization header. One token works across all four Astral APIs: astraltext.com, astralpdf.com, astraljson.com and astralbatch.com.

Authorization: Bearer ast_...

Tokens last a year. You can hold five at once and revoke any of them from the console, which takes effect within a minute. A token is a secret: keep it out of client-side code and out of git.

Rate limits and quota

Every successful response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. The per-minute counter is held in memory per server, so a short burst can occasionally exceed it by a few requests. The daily quota is the one that is enforced strictly.

Errors

Errors are RFC 7807 problem documents. The type is a stable URI you can branch on.

{
  "type": "https://astralpdf.com/errors/missing-token",
  "title": "Missing token",
  "status": 401,
  "detail": "Send your token as \"Authorization: Bearer ast_...\"."
}

Privacy

The tools on this site run in your browser and your text never leaves it. That is still true, and the API does not change it.

The API is a different surface, and it has to be said plainly: when you call it, the text in input is sent to our server, processed in memory and returned. It is not written to disk, not logged and not used to train anything. What we do record is the shape of the call: which token, which tool, how many calls, how many failed. If you would rather nothing leave your machine at all, use the tools on the site instead.

GET /api/v1/tools

The catalogue: every tool, its endpoint, its options and the current limits. No token needed, so you can read it before signing up.

curl https://astralpdf.com/api/v1/tools

POST /api/v1/{tool}

Runs one tool. Body fields:

Several documents in one call

Tools whose input type ends in [] read inputs instead of input.

curl -X POST https://astralpdf.com/api/v1/merge-pdf \
  -H "Authorization: Bearer ast_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"inputs": ["first", "second"]}'

Managing tokens

The console does this for you. The endpoints are listed for completeness; they authenticate with a Firebase ID token, not with an API token.

All 9 tools

Each endpoint has its own page: the call, a worked example, its parameters and the errors it can return.

Code samples

const res = await fetch("https://astralpdf.com/api/v1/pdf-info", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ASTRAL_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ input: text }),
});
if (!res.ok) throw new Error((await res.json()).detail);
const { result } = await res.json();

import os, requests

res = requests.post(
    "https://astralpdf.com/api/v1/pdf-info",
    headers={"Authorization": f"Bearer {os.environ['ASTRAL_TOKEN']}"},
    json={"input": text},
    timeout=30,
)
res.raise_for_status()
result = res.json()["result"]