real-estate template

Real Estate Listing API

Send property data and agent details as JSON, get back a 1200x900 listing card PNG.

1200x900Dimensions

sRGBColor space

Not supportedTransparency

140 KB to 380 KBFile size range

Get started free Read the Real Estate Listing API reference

Brokerages and listing platforms use the real estate listing image API to keep social, email, and partner-portal artwork in sync with the active MLS feed. The 1200x900 layout gives space for one hero photo, the price and address, the bed and bath counts, and an agent block, which covers the fields buyers expect to see in a property card. You post the listing data and the response holds a PNG ready for posting or attaching to a CRM-driven email blast.

bash

curl -X POST https://app.html2img.com/api/v1/templates/real-estate-listing \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"price":"$1,495,000","address":"482 Maple Ridge Lane","address_secondary":"Sausalito, CA 94965","beds":"4","baths":"3","sqft":"2,840","status":"Just listed","property_image_url":"https://picsum.photos/seed/real-estate/1200/600","agent_name":"Elena Martinez","agent_title":"Senior Listing Agent","agent_phone":"(415) 555-0142","agent_avatar_url":"https://i.pravatar.cc/160?img=23","brokerage_name":"Bay Bridge Realty","accent_color":"#0F172A"}'

A single cURL call to render a Real Estate Listing as a PNG. Add "format": "pdf" to the payload to get a PDF instead. For the full PHP, Node and Python equivalents, plus every input the template accepts, see the Real Estate Listing API reference. Setting up your key is covered in the authentication guide.

API reference

View the Real Estate Listing API reference: inputs, defaults, error responses and cURL, PHP, Node and Python code samples. Read the docs.

Real Estate Listing template preview, a real-estate image generated by the HTML to Image API

Real Estate Listing 1200x900

Use cases

Estate agencies generating shareable listing cards from MLS exports

Brokerages on a paid MLS feed get nightly exports with hundreds of properties and need a card per listing for social. Loop the export through this endpoint with each agent's branding, and the results post to scheduled queues without a designer in the loop. Bay Bridge Realty cards 240 listings every Sunday and the agents post directly from a shared cloud folder during the week. The cards reuse cleanly on the brokerage website too, replacing a Webflow template that needed manual updates.

Agents posting from a CRM action

CRM-driven listing pipelines benefit from a "Generate share image" action on each property record. The button hits this endpoint with the property data and the agent's vCard fields, and the resulting URL drops into the property's Notes field for one-click sharing. Agents copy the link into Instagram, Facebook, or WhatsApp without leaving the CRM. Linden & Co rolled this out for 60 agents and saw social posting frequency double in the first month.

Email marketing carousels

Newsletter tools that support multi-image email blocks render best with images at the same dimensions. Generate cards for the four featured listings of the week, embed in the email body, and the carousel reads as a coherent set rather than a mix of cropped photos. Riverside Realty publishes a Friday digest with five cards and the engagement runs 2x the rate of plain text-and-link emails.

Partner portal embeds

Brokerages syndicate listings to partner sites that want to show the listing in a card without rebuilding their own templating. Generate the card once, host the URL, and the partner embeds via a simple <img> tag. The partner gets brokerage-branded artwork, the brokerage gets visibility, and there is no shared code between the two systems. Wren Analytics powers this for three regional MLS providers.

Agency-branded WhatsApp share artwork

Agents in WhatsApp-heavy markets share listings through chat as a daily routine. A 1200x900 PNG renders cleanly inside a WhatsApp share, faster than a link preview and richer than a plain photo. Halberd Software ships this in its WhatsApp Business connector for Brazilian brokerages, and 90 percent of listing shares now use the rendered card instead of a stock photo.

Output specifications

Dimensions: 1200x900
Color space: sRGB
Transparency: Not supported
File size range: 140 KB to 380 KB

Matches the spec at Common MLS share format optimized for Instagram and email.

These specifications describe the default PNG output. The template can also return a PDF document with selectable text through the HTML to PDF API: set format to pdf in the request. See the format parameter docs for how PDF output behaves.

How it works

Send a JSON payload

POST to the template endpoint with the values you want rendered. Authenticate with your API key.

We render the image

The template is rendered server-side as a 1200x900 PNG, or as a PDF document if you set format to pdf.

You get back a URL

Cache it, embed it in your page, attach it to an email.

Common pitfalls

Photo aspect ratio crops the property out of frame

A vertical phone photo of a kitchen crops the cabinets out of view when squeezed into a horizontal hero slot. Pre-crop the source photo to 4:3 or wider on your side, or supply a different photo for the card than the one in the MLS gallery.

Price formatting differs by market

The same dollar value renders as "$450,000" in California, "£450k" in the UK, and "€450.000" in Germany. Format the price string per market on your side and pass the formatted result, since the renderer does not parse or localize the value.

Agent contact details exposed on public cards

Cards intended for public Instagram should not show the agent's direct phone number. Set show_agent_contact to false for public posts and true for private CRM-driven shares, so the same template serves both audiences.

Inputs at a glance

A quick summary of what the Real Estate Listing template accepts. The full reference, with example values and array shapes, is in the docs.

Name	Type	Required
`price`	string	Required
`address`	string	Required
`address_secondary`	string	Optional
`beds`	string	Optional
`baths`	string	Optional
`sqft`	string	Optional
`status`	string	Optional
`property_image_url`	url	Optional
`agent_name`	string	Optional
`agent_title`	string	Optional
`agent_phone`	string	Optional
`agent_avatar_url`	url	Optional
`brokerage_name`	string	Optional
`logo_url`	url	Optional
`accent_color`	string	Optional

See the full inputs reference for descriptions, examples and validation rules.

Related templates

Other templates in the business and commerce category.

Business Card template preview, a business image generated by the HTML to Image API

Business Card Business card

Digital and print-ready business cards in three layout variants

Certificate of Completion template preview, a business image generated by the HTML to Image API

Certificate of Completion Certificate of completion

Print-ready certificates for course completion, training, and recognition

Coupon Voucher template preview, a business image generated by the HTML to Image API

Coupon Voucher Coupon and voucher

Promotional voucher images sized for email body and SMS preview

Event Ticket template preview, a business image generated by the HTML to Image API

Event Ticket Event ticket

Print- and email-ready tickets with QR/barcode slot and perforated stub

Invoice Image template preview, a business image generated by the HTML to Image API

Invoice Image Invoice image

Render full invoices as PNG images or A4 PDFs for emails, dashboards, and exports

Receipt Image template preview, a business image generated by the HTML to Image API

Receipt Image Receipt image

Compact order receipts as PNGs for confirmation emails or PDFs for expense filing

Browse by category

A starting point from each of the other two template categories.

Social media

Content and marketing

See the full template gallery for every design grouped by category.

Related guides

FAQ

What size works for Instagram?

The 1200x900 output works for Instagram feed posts and crops cleanly to 4:5 portrait if your account favors that aspect. For Stories, switch to the instagram-story template at 1080x1920. Both can be generated from the same property data with two requests. Agents who need a window card can add format: "pdf" and print the listing straight from the A4 file.

How many photos can I include?

The card shows one hero photo via property_image_url. For multi-photo carousels, render multiple cards with different photos and post them as an Instagram or Facebook carousel. The hero photo determines the visual hook, so pick the most attention-grabbing shot.

Will this fit MLS exports?

Yes, the input fields map cleanly to standard MLS columns: list price, address, beds, baths, sqft, status, and agent details. Most brokerages script the mapping once and feed daily exports through it. Custom MLS fields can be ignored or appended via the description field.

Can I show the agent photo?

Yes, pass agent_avatar_url with a public URL to a square portrait. The renderer crops it to a circle and places it in the agent block beside the listing details. For public-facing cards, agents often prefer a professional headshot rather than a casual photo.

Should I include the address publicly?

Set show_address to false for cards posted publicly to keep the exact address private until a buyer expresses interest. For private agent-to-client cards, leave it true so the recipient knows exactly which property is being shared.

Can I batch-render the entire portfolio?

Yes, loop through your listings and call the endpoint per property. The renders run in parallel from your worker pool, and most batches of a few hundred properties complete in under 5 minutes. Cache the URLs on the listing record to avoid re-rendering when the data has not changed.

Try it free

25 renders a month on the free tier. See the pricing page for higher-volume plans.

Create a free account Read the API reference