Dataczar
Browse helpers

API Reference / documents / page-icon

Generate a square icon from a PDF page.

Rasterizes the requested page, fits it into a square canvas (default 256×256), and returns the icon as PNG/JPG/WebP. Drop this helper wherever you want to generate a square icon from a PDF page with a single HTTP call. Send the documented inputs and the API streams back polished results you can hand directly to your users.

GETPOST/documents/page-icon

Where this helper shines

Generate a square icon from a PDF page. keeps documents helpers on autopilot. Use it whenever you need to generate a square icon from a PDF page without pausing a sprint or asking design/dev to jump in.

  • Trigger this helper whenever you need to generate a square icon from a PDF page without waiting on a full deploy.
  • Drop it into automations (Zapier, Make, workers) to generate a square icon from a PDF page as part of your workflow.
  • Share the GET URL so support and success can generate a square icon from a PDF page safely using their Dataczar API key.

Copy & ship snippets

GET

Instant link

GET https://api.dataczar.app/documents/page-icon?url=https%3A%2F%2Fexample.com%2Fsample.png&page=1&size=256&format=png&ak=demo

Open directly in any browser, webhook, or low-code workflow.

curl

curl GET

curl "https://api.dataczar.app/documents/page-icon?url=https%3A%2F%2Fexample.com%2Fsample.png&page=1&size=256&format=png&ak=demo"

Swap ak=demo with your Dataczar API key.

curl

curl POST

curl -X POST "https://api.dataczar.app/documents/page-icon?ak=demo" \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://example.com/sample.png",
  "page": 20,
  "size": 30,
  "format": "png",
  "background": "sample_background",
  "dryrun": true
}'

Send JSON payloads from back-end jobs, queues, or workers.

Parameters

Query Parameters

NameTypeDescription
urlstring
pageinteger
sizeintegerSquare dimension in pixels (32-512).
formatstring
backgroundstring
dryrunboolean

All helper calls accept your Dataczar key via the ak query parameter. Need one? Create or copy a key on Dataczar Connect and drop it into each request.

Responses

Status 200

Icon image bytes.

Examples

Request

"POST /pdf/page-icon?size=128&dryrun=1"

Response

{
  "ok": true,
  "data": {
    "summary": [
      "Render icon from page 1",
      "Size 128px"
    ],
    "preview_png_base64": "..."
  },
  "meta": {
    "dryrun": true
  }
}

File uploads (multipart form-data)

Attach PDFs or images as multipart fields. We'll fill in the field names for you.

Files
file — PDF document

Query parameters

Body parameters

We'll send these as JSON for POST/PUT/PATCH requests and as query params for GET.

Equivalent curl
Grab your Dataczar API key
Every helper runs with the same simple API key. Sign in (or create a free Dataczar account) at Dataczar Connect to issue keys in seconds, then drop the key into any `ak=` parameter and start shipping.
Get your API keyBrowse helpers
Tip: reuse the same key across these helpers, or rotate keys per project from the Connect dashboard.