PDFTaco API
Integrate PDF tools into your app with a few lines of code. Merge, split, compress, convert, unlock, OCR, rotate, delete pages, add page numbers, watermark, and reorder — all via simple REST endpoints.
Get an API key
Enter your email below to get a free API key instantly.
Send a request
POST your files to any endpoint with your API key in the header.
Get your PDF
Receive the processed PDF directly in the response body.
Get Your API Key
Free — no credit card required. One key per email.
Authentication
Include your API key in the X-API-Key header with every request.
curl -H "X-API-Key: pt_live_abc123..." ...
Endpoints
All endpoints accept multipart/form-data and return the processed file directly.
Rate Limits
Each API key gets 50 requests per day (resets at midnight UTC). Every response includes rate limit headers:
X-RateLimit-Remaining: 47 X-RateLimit-Reset: 2026-02-23T00:00:00.000Z
Check your remaining quota anytime:
curl -H "X-API-Key: YOUR_KEY" https://pdftaco.com/api/v1/keys
Error Codes
All errors return JSON with error and code fields.
| Code | Status | Description |
|---|---|---|
| MISSING_API_KEY | 401 | No X-API-Key header provided |
| INVALID_API_KEY | 401 | API key not found or deactivated |
| RATE_LIMIT_EXCEEDED | 429 | Daily quota of 50 requests used up |
| MISSING_FILE | 400 | Required file field not provided |
| FILE_TOO_LARGE | 400 | File exceeds the endpoint size limit |
| INVALID_FILE_TYPE | 400 | Unsupported file format |
| INVALID_RANGE | 400 | Page range syntax error or out of bounds |
| INVALID_PARAM | 400 | Invalid parameter value |
| PROCESSING_FAILED | 500 | Internal processing error |
Need help? Have questions? Contact us
← Back to tools