Free • 50 requests/day
PDFTaco API
Integrate PDF tools into your app with a few lines of code. Merge, split, compress, convert, unlock, and OCR — all via simple REST endpoints.
1
Get an API key
Enter your email below to get a free API key instantly.
2
Send a request
POST your files to any endpoint with your API key in the header.
3
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