Pdf Page Numbers API

Network tool

POST https://api.findutils.com/api/tools/pdf-page-numbers/execute

Add page numbers to a PDF. The format string uses {n} for the page number and {total} for the count, so "Page {n} of {total}" and a bare "{n}" both work. Numbering can start at any value and can skip the first page, which is what a title page usually wants. Input and output are base64-encoded PDFs.

Open the tool Try it

Request body

application/json

pdf

string required

The base64-encoded PDF to number.
position

string optional

Where the number sits. Default: bottom-center. One of bottom-center · bottom-right · bottom-left · top-center · top-right · top-left. Default "bottom-center".
start

integer optional

The number the first numbered page gets. Default: 1. Default 1.
format

string optional

Template with {n} and {total}. Default: "{n}". Default "{n}".
size

number optional

Font size in points. Default: 10. Default 10.
margin

number optional

Distance from the page edge in points. Default: 28. Default 28.
skip_first

boolean optional

Leave page 1 unnumbered, for a title page. Default: false. Default false.

Example arguments

Verified

{
  "pdf": "JVBERi0xLjcK",
  "position": "bottom-center",
  "format": "Page {n} of {total}"
}

curl -X POST https://api.findutils.com/api/tools/pdf-page-numbers/execute \
  -H "Content-Type: application/json" \
  -d '{
    "pdf": "JVBERi0xLjcK",
    "position": "bottom-center",
    "format": "Page {n} of {total}"
  }'

const response = await fetch('https://api.findutils.com/api/tools/pdf-page-numbers/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"pdf":"JVBERi0xLjcK","position":"bottom-center","format":"Page {n} of {total}"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/pdf-page-numbers/execute",
    json={"pdf":"JVBERi0xLjcK","position":"bottom-center","format":"Page {n} of {total}"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/pdf-page-numbers/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"pdf":"JVBERi0xLjcK","position":"bottom-center","format":"Page {n} of {total}"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call pdf_page_numbers from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: pdf-page-numbers
MCP name: pdf_page_numbers
Category: Documents
Machine-readable: openapi.json · markdown.md

This tool fetches a fixed, hard-coded public upstream, never a private host. Results depend on that upstream.

Request body

Example arguments

More Documents tools

More to explore