API Documentation

Convert PDFs into clean Markdown and structured JSON with a single HTTP request. Integrate in under five minutes.

Authentication

Authenticate every request with your API key as a Bearer token. Generate and rotate keys from your dashboard.

http

Authorization: Bearer rp_live_your_api_key

Get your API key

Parse a PDF

POST

https://api.ragparser.com/v1/parse

Send a multipart/form-data request with a single file field containing your PDF. Maximum file size is 25 MB.

Try it

Upload a PDF, then send a live request to POST /v1/parse. The code samples update as you go.

curl -X POST https://api.ragparser.com/v1/parse \
  -H "Authorization: Bearer rp_live_your_api_key" \
  -F "file=@"

Click document.pdf in the request to upload a PDF (max 25 MB).

Response

A successful request returns 200 OK with the parsed document.

{
  "success": true,
  "pages": 18,
  "title": "Quarterly Report",
  "markdown": "# Quarterly Report\n\n...",
  "text": "Quarterly Report\n\n...",
  "metadata": {
    "author": "Jane Doe",
    "creator": "Microsoft Word",
    "language": "en",
    "pageCount": 18
  }
}

success	boolean	Always true on success.
pages	number	Number of pages parsed.
title	string \| null	Document title, if present.
markdown	string	Clean Markdown representation.
text	string	Plain extracted text.
metadata	object	author, creator, language, pageCount.

Error codes

Errors return a predictable JSON body with an error string.

400

{ "error": "Invalid PDF" }The uploaded file is missing, not a PDF, empty, or too large.

401

{ "error": "Invalid API Key" }The Authorization header is missing or the API key is invalid.

429

{ "error": "Rate limit exceeded" }You exceeded your per-minute rate limit or monthly quota.

500

{ "error": "Internal server error" }Something went wrong on our side. Retry with backoff.

Rate limits

Limits are enforced per API key. Exceeding them returns 429 Rate limit exceeded.

Plan	Monthly quota	Requests / minute
Free	100	10
Pro	5,000	60
Business	Custom	240