Overview

Quick start

Convert your first PDF to structured output in under 2 minutes.

Option A — Web UI (no code)

1. Create an account

Go to /register and sign up with your email. Free accounts get 50 pages per month — no credit card required. After email verification you are redirected to the dashboard.

2. Upload a PDF

On the dashboard, drag and drop a PDF onto the upload zone or click Browse. The uploader shows your remaining page quota and the file size limit for your plan.

3. Choose your format

In the Output formats section, tick the formats you want. Free accounts can producemarkdown and text. Pro and Business can select all 6.

4. Submit and wait

Click Parse PDF →. The job appears in the Recent jobs list with a processing indicator. Most PDFs complete in under 5 seconds. The page auto-polls every 3 seconds.

5. Download

Once the status is Done, click the job to open the detail page and download each output format individually. Downloads are proxied through the backend — no CORS issues.

Option B — REST API

Pro and Business accounts can create API keys and call the API from any HTTP client.

1. Create an API key

Go to Account settings → API Keys → enter a name → Create key. Copy the key — it is shown only once.

2. Submit a job

curl -X POST https://api.ragify.it/jobs \
  -H "X-Api-Key: rg_your_key_here" \
  -F "file=@report.pdf" \
  -F 'options={"format":["markdown","json"]}'

The response includes the job ID and initial status:

{
  "id": "3f8a1c2d-...",
  "status": "pending",
  "options": { "format": ["markdown", "json"], ... },
  "created_at": "2026-05-14T10:00:00Z"
}

3. Poll for completion

curl https://api.ragify.it/jobs/3f8a1c2d-... \
  -H "X-Api-Key: rg_your_key_here"

{
  "id": "3f8a1c2d-...",
  "status": "done",
  "page_count": 8,
  "download_urls": {
    "markdown": "https://...",
    "json": "https://..."
  }
}

4. Download output

# Download Markdown
curl -O "https://api.ragify.it/jobs/3f8a1c2d-.../download/markdown" \
  -H "X-Api-Key: rg_your_key_here"

# Download JSON
curl -O "https://api.ragify.it/jobs/3f8a1c2d-.../download/json" \
  -H "X-Api-Key: rg_your_key_here"

Next steps