MostlyRender

SDKs & integrations

MostlyRender is a plain REST API — use it from any language with an HTTP client. We also ship a Python SDK and a Zapier app.

# Python

Zero dependencies (stdlib only), Python 3.8+.

bash
pip install mostlyrender
python
from mostlyrender import MostlyRender

mr = MostlyRender("mr_live_…")  # or base_url="https://mostly-render-api.web.app"

mr.render("tpl_abc", modifications={"title": "Hello"})           # → { id, url, output }
mr.render_batch(template_id="tpl_abc", items=[{"title": "A"}])    # → { results, count, ok }
mr.screenshot("https://stripe.com", full_page=True)              # → { id, url, output }
mr.list_templates()                                              # → { templates: [...] }
mr.get_account()                                                 # → { plan, email, display_name }

job = mr.render_async("tpl_abc", output="pdf", webhook_url="https://your.app/hook")
final = mr.wait_for_render(job["id"])                            # polls until done

Errors raise MostlyRenderError with .status and .body. See Errors.

# Zapier

Connect MostlyRender in Zapier with your API key (validated against GET /v1/account). Actions:

  • Render a template — fill a template’s modifications and get back an image URL.
  • Screenshot a URL — capture a page.
  • Templates are offered as a dropdown (powered by GET /v1/templates).

# cURL / REST

Anything the SDKs do is a direct REST call:

bash
curl https://api.mostlyrender.com/v1/renders \
  -H "Authorization: Bearer mr_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "template": "tpl_abc", "modifications": { "title": "Hello" } }'

The full machine-readable contract is the OpenAPI spec — import it into your own client generator or Postman. Browse it interactively in the API reference.