RoofRender API

Quickstart

Your first render in one command. Replace the key with yours and point at any photo of a house; about 20 seconds later the JSON response contains your rendered image URL.

curl -X POST https://roofrender.app/api/v1/render \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@house.jpg" \
  -F "material=Standing Seam Metal" \
  -F "color=Onyx Black"

Authentication

Every request needs an API key, available on Growth and Professional plans. Send it as a header, either way works:

Authorization: Bearer YOUR_API_KEY
X-API-Key: YOUR_API_KEY

Renders draw from your plan's monthly quota. Keep your key secret; contact us to rotate it any time.

Render a roof

POST /api/v1/render with multipart form data:

Example request

curl -X POST https://roofrender.app/api/v1/render \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@house.jpg" \
  -F "material=Standing Seam Metal" \
  -F "color=Onyx Black"

Example response

{
  "render_url": "https://...signed image URL...",
  "material": "Standing Seam Metal",
  "color": "Onyx Black",
  "expires_in": 7200
}

The URL is valid for 2 hours; download the image if you need to keep it. Requests typically complete in 15-30 seconds, so use a client timeout of at least 120 seconds.

List materials and colors

GET /api/v1/materials — no auth required. Returns every material with its category, description, and available colors (with hex values), so your app can build pickers that stay in sync with our catalog.

curl https://roofrender.app/api/v1/materials

Errors

Errors return JSON like { "error": "..." } with a matching status code:

API requests are limited to 10 renders per minute per key.

Website widget

Prefer a no-code option? The same renders are available as a drop-in widget for your website: one iframe line, no programming. Ask us for an embed key.

<iframe src="https://roofrender.app/embed/YOUR_EMBED_KEY"
  style="width:100%;max-width:640px;height:1000px;border:0"></iframe>