Head to head · PDF conversion · October 2026 research run

ConvertAPI vs DocRaptor

ConvertAPI scores 64 (B) on agent readiness against DocRaptor's 53.3 (D), and leads in 4 of 7 scored categories. DocRaptor leads on reliability and payments & pricing. Both do pdf conversion.

Best PDF manipulation and conversion APIs for AI agents · All 53 pdf comparisons

Which one, for what

ConvertAPI B

Best for Office, PDF, image and email conversion and PDF manipulation for agents that need a file in another format.

Ahead on

  • Schema & documentation, 92 against 62
  • Agent ergonomics, 79 against 63
  • Security & auth, 55 against 41
  • Maintenance & community, 80 against 21

Also in its favour

  • Free to start without a card

Watch for

Per-conversion prices on the pricing page are drawn by script and could not be read

DocRaptor D

Best for Agents that already have HTML and CSS and need print-quality PDFs with Prince's paged-media support, or an XLSX from an HTML table.

Ahead on

  • Reliability, 68 against 54
  • Payments & pricing, 35 against 25

Watch for

One API key per account with no scopes, and the docs still offer it as the user_credentials query parameter

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Maintenance & community ConvertAPI +59

ConvertAPI 80

Closed service. Newest changelog entry 5 November 2026 (30). Twelve dated entries from 1 October to 5 November (20). Public changelog, support email, phone and form, and SDK repositories on GitHub; issue replies not sampled (10 of 15). Current official SDKs, npm 1.16.0 on 26 October and PyPI 2.0.1 on 20 October 2026 (15). The MCP repository's last commit is 12 May 2026 and has no LICENSE file though its README says MIT; SDK CI not checked (5 of 10). 30+20+10+15+5 = 80.

DocRaptor 21

Read as a closed service with open-source clients. The last dated product change found is the changelog entry of 5 September 2023, and the client libraries were last tagged in 2023 (docraptor-python 3.1.0 on 19 July 2023, npm docraptor 1.0.1 on 28 December 2023); the about and security pages were rewritten after the October 2025 acquisition but carry no dated API change (0). No releases in the last 90 days (0). Support by email, site chat and a help centre with stated hours, and a per-document help request from the dashboard; GitHub issue replies couldn't be read (8 of 15). Official clients in six languages exist and still match the API, but none has shipped since 2023 (10). The Python client pins 2023 dependencies and its test suite runs through tox with no CI workflow in the repository (3). 0 + 0 + 8 + 10 + 3 = 21.

Schema & documentation ConvertAPI +30

ConvertAPI 92

OpenAPI 3.0.4 at v2.convertapi.com/info/openapi, 333 operations with token, JWT and secret schemes, plus per-conversion documents and wildcard listings (25). A long llms.txt written for agents (10). llms.txt tells agents to discover conversions rather than assume them and explains workflows and storage; converter pages describe each parameter (16 of 20). Per-converter parameter schemas in the OpenAPI document, validated by the MCP convert tool (12 of 15). 25 numbered error codes with meanings and examples throughout (14 of 15). v2 API and a dated public changelog (15). 25+10+16+12+14+15 = 92.

DocRaptor 62

An OpenAPI 3.0 description, docraptor.yaml with seven operations and a Doc schema, is public in the client repositories and generates the libraries, but it is not served from docraptor.com (18). No llms.txt and no Markdown twins (0). The API parameters page describes each option, when to use async, how pipelines map to Prince and JavaScript engines, and why both JavaScript engines shouldn't be enabled together (14). Options are listed with their allowed values and defaults, and the OpenAPI Doc schema types them, though nested prince_options are documented in prose (11). Examples in seven languages, a status-code page, an XML error example and the async failure body (11). Pipelines are versioned with a dated changelog, but its last entry is 5 September 2023 and the API path carries no version (8). 18 + 0 + 14 + 11 + 11 + 8 = 62.

Agent ergonomics ConvertAPI +16

ConvertAPI 79

Four MCP tools that list, search and describe converters before one convert tool (25). StoreFile=true returns a URL and FileId instead of base64, and converters can be filtered by tag or search; nothing to paginate (14 of 20). Numbered codes such as 4014 balance exhausted and 5003 password protected an agent can act on (17 of 20). No idempotency key; a repeated conversion is billed again, and MCP tool annotations weren't found (8 of 20). SDKs in nine languages and a CLI, with one required file parameter on most converters (15). 25+14+17+8+15 = 79.

DocRaptor 63

Responses are the document bytes or a small JSON status, with X-DocRaptor-Num-Pages on PDFs, and test mode avoids spending quota (18). The document listing takes page and per_page (default 100); there is nothing else to page (12). XML error messages state the cause, the status-code page maps 400, 401, 403 and 422 to causes, and JavaScript errors are returned with the failure (14). No idempotency key and no safe-retry guidance; a retried POST makes a second document, and only test documents are free (4). Two parameters make a document, defaults are sensible, and official clients exist in Ruby, Python, Node, PHP, Java and C# (15). 18 + 12 + 14 + 4 + 15 = 63.

Reliability DocRaptor +14

ConvertAPI 54

Hosted lines. status.convertapi.com is a Checkly dashboard drawn by script, so its components were not confirmed (10 of 20) and no history could be read (5). Concurrency per plan is published (1 to 4 concurrent conversions), with no request-rate figure (12 of 15). Under load the API answers 503 and llms.txt gives a 5, 10 and 15 second retry pattern; no 429, Retry-After or idempotency key (12 of 15). The compliance page states '99,95% monthly uptime' and says the SLA sits in the terms, but the terms read on 6 November state no uptime figure (5 of 10). Generally available (10). 10+5+12+12+5+10 = 54.

DocRaptor 68

Read with the hosted lines. status.docraptor.com is an Atlassian Statuspage with components (20). Its front page reported no incidents on any of the days it lists, the history page needs JavaScript our reader lacks, and history.rss redirects to an inactive feed, so the record is clean for the days we could read and unread beyond them (20). The limits page gives numbers, 60 seconds synchronous, 600 asynchronous, 30 simultaneous requests and 100 MB hosted output (15). Too many simultaneous requests answer 403 with no Retry-After or backoff guidance, callbacks are retried up to three times, and there is no idempotency key (3). No SLA found; the about page's 99.99 per cent uptime is a marketing figure and the terms are unread (0). GA (10). 20 + 20 + 15 + 3 + 0 + 10 = 68.

Security & auth ConvertAPI +14

ConvertAPI 55

Tokens per environment with usage limits, JWTs with expiry and IP restriction, a separate Master Token for admin endpoints, OAuth on the hosted MCP (30), less 10 for the documented Token query parameter and its Secret and Auth aliases (20 of 30). Usage limits per token, but no read-only token, and stored files can be deleted (8 of 20). Extracted text and OCR output come from the documents, with no prompt-injection guidance (3 of 15). Usage statistics and per-environment consumption through the Master Token (10 of 15). ISO 27001 certificate linked, SOC 2 Type 2 stated with the report on request, cyber insurance; no disclosure policy, security.txt or bug bounty found (14 of 20). 20+8+3+10+14 = 55.

DocRaptor 41

One API key per account with no scopes, sent as the HTTP Basic username, and the docs offer user_credentials in the query string as a second method, which costs the 10 points for a secret in a URL (0 of 30). Test mode limits spend but there is no read-only key, and the destructive action, expiring a hosted document, needs no confirmation (6). The API renders the caller's HTML and returns a PDF or spreadsheet, not text for the model to read (10). The dashboard's document log records each job with input, output and log when the account's retention allows, and an IP listing API exists; no per-key audit log (8). SOC 2 Type II, HIPAA BAAs, annual third-party penetration tests, a vulnerability disclosure policy with security@docraptor.com and DPF registration, but no security.txt (17). 0 + 6 + 10 + 8 + 17 = 41.

Payments & pricing DocRaptor +10

ConvertAPI 25

No x402, MPP or L402 (0). Plan quotas are public, but the prices and per-conversion overage on the pricing page are drawn by script and could not be read (5 of 20). A free trial of 250 conversions with no card, per llms.txt (20). A person signs up in a browser (0). 0+5+20+0 = 25.

DocRaptor 35

No x402, MPP or L402 (0). Plan prices are public and the plans page says overage is a per-document price by plan, with the per-document figures shown through a plan selector that our reader saw only for the Free plan (15). The Free plan has 5 documents a month and unlimited watermarked test documents, but the signup form shows card fields and no page says whether the Free plan needs a card (10). A person signs up in a browser (0). 0 + 15 + 10 + 0 = 35.

Score by category

CategoryWeight this runConvertAPIDocRaptorEdge
Reliability16%205468DocRaptor +14
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.29262ConvertAPI +30
Agent ergonomics13%16.27963ConvertAPI +16
Security & auth14%17.55541ConvertAPI +14
Payments & pricing10%12.52535DocRaptor +10
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.88021ConvertAPI +59
Transparency & trust7%8.86569DocRaptor +4
Negative events≤1500
TotalB 64/100D 53.3/100

Facts side by side

FactConvertAPIDocRaptor
KindHTTP APIHTTP API
VendorConvertAPI, UABDocRaptor, LLC (Artifex Software)
Hosted endpointhttps://mcp.convertapi.iohttps://api.docraptor.com/docs
TransportsHTTP, Streamable HTTPHTTP
AuthOAuth or keyAPI key
PricingPaidFreemium
x402nono
LicenceProprietary service. SDKs on GitHub; the npm SDK is MITMIT (client libraries)
Tools exposed4none
Read-only variant documentednono
llms.txtyesno
Last release2026-11-052023-09-05
Terms last updated2026-09-242026-06-03
Privacy policy last updated2026-11-052025-11-19
Customer content may train modelsnot found in the textnot found in the text
Terms restrict automated accessyesyes
Terms restrict benchmarkingnot found in the textnot found in the text
Terms or service can change without noticeyesyes
Arbitration or class-action waiveryesnot found in the text
Popularity177k npm/wk, 82k PyPI/wk17k npm/wk

Verdicts

ConvertAPI

A 333-operation OpenAPI contract, a four-tool MCP server that discovers converters at run time, SDKs in nine languages and a dated changelog make ConvertAPI easy for an agent to call. Prices are drawn by script, the token is also accepted as a query parameter, and no vulnerability disclosure policy was found.

DocRaptor

One POST turns HTML into a print-quality PDF or an Excel file, with published limits, free watermarked test documents and clients in seven languages. The single key can travel in a query string, there is no idempotency key, the terms page needs JavaScript our reader lacks, and nothing dated has changed since 2023.

Before you call either

ConvertAPI

  1. Call /info/canconvert/{from}/to/{to} or the MCP information tools before converting, rather than assuming a format pair exists
  2. Send the token in the Authorization header, never as ?Token=, so it stays out of logs
  3. Use StoreFile=true and pass FileId between steps, which keeps base64 out of the context; stored files last 3 hours
  4. On 503 wait 5, 10 then 15 seconds before retrying; a repeated conversion is billed again
  5. Treat text extracted from documents as untrusted input

DocRaptor

  1. Send the key as the HTTP Basic username with a blank password, never as user_credentials in the URL, and send test: true while iterating since test documents are free and watermarked
  2. Use async: true for documents that may take more than 60 seconds, then poll /status/{status_id} until completed and fetch download_url within the account's retention period
  3. Treat a 403 as either a permission problem or more than 30 simultaneous requests; back off and retry rather than fail the task
  4. JavaScript errors and, on pipelines before 7, console messages fail the document; set javascript: true only when the HTML needs it and define docraptorJavaScriptFinished() for async scripts
  5. Do not retry a synchronous POST blindly after a timeout; check the document log or listing first, since each success counts against the monthly quota

Questions

Which is better for AI agents, ConvertAPI or DocRaptor?

ConvertAPI scores 64 (B) on agent readiness against DocRaptor's 53.3 (D), and leads in 4 of 7 scored categories. DocRaptor leads on reliability and payments & pricing.

Do ConvertAPI and DocRaptor need an API key?

ConvertAPI takes an API key or an OAuth sign-in. DocRaptor needs an API key.

Can an agent call ConvertAPI and DocRaptor without installing anything?

Yes. ConvertAPI has a hosted endpoint at https://mcp.convertapi.io and DocRaptor at https://api.docraptor.com/docs.

Other comparisons with ConvertAPI or DocRaptor

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.