OhoTool API

Developer API

Use OhoTool's tools straight from your own apps and scripts — convert files (Office ↔ PDF, and more) and generate QR codes over a simple REST API. Authenticate with a Bearer key. Included with Pro.

Quick start

  1. 1Upgrade to Pro (API access is a Pro feature).
  2. 2Create a key in Dashboard → API keys. Copy it once — it's shown only at creation.
  3. 3Call the API with your key in the Authorization header (below).

Authentication

Send your key as a Bearer token. Keep it secret — treat it like a password and use it only server-side.

Authorization: Bearer oho_your_api_key

Base URL: https://ohotool.com/api/v1

Endpoints

POST/api/v1/convert

Convert a file (e.g. Office ↔ PDF) or a URL/HTML to PDF. Returns the converted file. Send GET /api/v1/convert for the full list of supported op values.

File → file (multipart)
curl -X POST "https://ohotool.com/api/v1/convert" \
  -H "Authorization: Bearer oho_..." \
  -F op=to-pdf \
  -F file=@document.docx \
  --output document.pdf
URL → PDF (JSON)
curl -X POST "https://ohotool.com/api/v1/convert" \
  -H "Authorization: Bearer oho_..." \
  -H "Content-Type: application/json" \
  -d '{"op":"url-to-pdf","url":"https://example.com"}' \
  --output page.pdf
GET/api/v1/qr

Generate a QR code PNG.

ParamDefaultNotes
dataRequired. Text/URL to encode.
size512128–1024 px.
margin20–10 modules.
ecMError correction: L, M, Q, H.
dark / light000000 / ffffffHex colors.
curl "https://ohotool.com/api/v1/qr?data=https://ohotool.com&size=512" \
  -H "Authorization: Bearer oho_..." \
  --output qr.png
GET/api/v1/me

Verify your key and see your plan.

curl "https://ohotool.com/api/v1/me" -H "Authorization: Bearer oho_..."

Rate limits

The Pro plan includes 1,000 API calls per month (all endpoints combined), resetting on the 1st. Exceeding the limit returns HTTP 429. Need more? Reach out and we'll sort out a higher tier.

Errors

401Missing or invalid API key.
403Key exists but the account isn't on Pro.
400Bad request — unsupported op or missing field.

Errors return JSON like { "error": "..." }.

Build with OhoTool

Get a Pro plan, create a key, and start converting files and generating QR codes from your own apps.

Get an API key