This is a real render from the API with the example values below, at 1200×630.
For listing portals and agencies: the photo does the selling, the price is the first thing anyone reads and the key facts sit in one row. Shared listings on WhatsApp and Facebook stop looking like bare links.
Fields
Every field is optional. Long text shrinks to fit instead of overflowing; an image field takes a public URL that we fetch on our side.
| Field | Type | Description | Example |
|---|---|---|---|
price |
text | Price as you want it printed, with the currency. default: $0 | $1,250,000 |
address |
text | Street address of the property. | 42 Ocean View Drive |
city |
text | City, region or country under the address. | Marbella, Spain |
beds |
text | Number of bedrooms, with the word. | 4 beds |
baths |
text | Number of bathrooms, with the word. | 3 baths |
area |
text | Floor area, written the way your market writes it. | 2,150 sq ft |
badge |
text | Label on the photo, e.g. For sale or Sold. | For sale |
site |
text | Your domain or a short URL. | coastalhomes.com |
photo |
image URL | Main photo of the property. | https://example.com/images/house.jpg |
logo |
image URL | Agency logo next to the address. | — |
accent |
colour | Brand colour as hex, e.g. #6366f1. Drives buttons, highlights and the background glow. default: #0d9488 | #0d9488 |
theme |
dark | light | Colour scheme: dark or light. default: light | — |
Render it with one request
Use the slug as template. The response holds the URL of the finished PNG; ?wait=true keeps the connection open until it is ready.
curl -X POST "https://imageapi.benchkithq.com/v1/images?wait=true" \
-H "Authorization: Bearer sk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"template": "real-estate",
"modifications": {
"price": "$1,250,000",
"address": "42 Ocean View Drive",
"city": "Marbella, Spain",
"beds": "4 beds",
"baths": "3 baths",
"area": "2,150 sq ft",
"badge": "For sale",
"site": "coastalhomes.com",
"photo": "https://example.com/images/house.jpg"
}
}'Or paste a signed URL into og:image
For static sites, Webflow, Shopify and no-code tools: put the fields in the query string and sign it with your signing secret. The first request renders the image, every later one is a redirect to the cached file. How to compute the signature.
<meta property="og:image" content="https://imageapi.benchkithq.com/i/acc_YOUR_ACCOUNT_ID/real-estate.png?address=42%20Ocean%20View%20Drive&area=2%2C150%20sq%20ft&badge=For%20sale&baths=3%20baths&beds=4%20beds&city=Marbella%2C%20Spain&price=%241%2C250%2C000&site=coastalhomes.com&s=YOUR_SIGNATURE">Make it yours
accent and theme change per request. For anything more, copy the template into your account: you get an ordinary HTML template with the same fields that you can edit in the dashboard or through the API. If the slug is free on your account, the copy takes it — your integrations switch to your version without changing a line.
curl -X POST "https://imageapi.benchkithq.com/v1/templates/library/real-estate/copy" \
-H "Authorization: Bearer sk_live_YOUR_KEY"
Blog post
Job posting
Event
Podcast episode
Changelog / release
Documentation page
Product card
Product on sale
Course lesson
Recipe
Video thumbnail
Newsletter issue
Quote card
Case study / testimonial
GitHub repository
Feature announcement
Profile / author card
Comparison (A vs B)
Stat highlight