DOCIFY HOSTED API / FREE TO USE

Free PDF and image
API documentation.

Use Docify's hosted API from your scripts to generate PDFs, optimize images, or convert an image to PDF. No API key or local processing service is required.

Base URL

https://docify.site/api

These are hosted document and image tools, separate from the local codebase documentation CLI. Submitted documents and images are processed for the response and are not retained as uploaded files.

Choose an endpoint

Quick reference

MethodEndpointInputOutput
GET/healthNoneService status JSON
POST/v1/pdfJSON with HTMLapplication/pdf
POST/v1/imagesRaw PNG, JPEG or WebPimage/webp, image/jpeg or image/png
POST/v1/image-to-pdfRaw PNG, JPEG or WebPapplication/pdf

Check service health

curl https://docify.site/api/health

Conversion endpoints accept POST, not GET or HEAD. A 405 Method Not Allowed response to curl -I on a conversion endpoint does not mean the service is offline.

Authentication and browser access

The public conversion endpoints currently need no signup or API key. Call them from server-side scripts or use the tools on docify.site. Browser applications on unrelated domains are restricted by the current CORS policy.

Input limits

  • HTML to PDF accepts an HTML string up to 200,000 characters within a 1 MB JSON body. Use inline CSS and embedded data-image URLs. Remote assets and scripts are blocked.
  • Image optimization and image-to-PDF inputs may be up to 20 MB. Send raw bytes with the matching image Content-Type, not multipart form data.
  • Animated images are not supported. Image-to-PDF returns one page per request.

Handle errors and temporary limits

The public service allows up to 30 requests per minute per IP and limits concurrent processing. Check status codes before writing a response to disk: errors contain JSON with an error field rather than the requested file.

  • 400: invalid JSON or options
  • 413: request is too large
  • 415 / 422: unsupported or invalid input
  • 429: rate limit reached. Follow Retry-After
  • 503: processing capacity is busy. Retry with a bounded delay
  • 500: processing failed. Inspect the input before retrying

To generate codebase documentation locally, see the Docify CLI guides. The CLI does not require these hosted PDF and image endpoints.