Key Deal

Embed and API

Your listings on the website you already have, always current.

Most agencies already have a website, and its listings page is out of date the day it goes up. Key Deal puts your live listings on it with one pasted snippet, or hands your developer a documented API, so the site shows what the team publishes, the moment it is published.

Set up your agencySee pricing
Agency plan30 days free, no card needed
Example
<script src="https://youragency.keydeal.io/embed.js" async></script>
Harbour View 2BRAED 1.79M
Creek Beach 3BRFrom AED 2.95M

1 snippet

Paste and go

The listings widget needs no key and nothing filled in. Paste it where the listings should be.

6 samples

Ready to copy

cURL, Node.js, PHP, Python, the browser and WordPress, each written for your agency's own address.

0 manual updates

When a listing changes

Publish, edit or take a listing down in Key Deal and your website follows. Only published public listings are ever shown.

A property listings widget for your website

Choose the layout and the accent colour, watch the live preview, and copy one snippet. It draws your agency's live listings on any page of your existing site, styled apart from the rest of the page so neither breaks the other.

  • Grid or list, in your accent colour, previewed before you copy
  • No key to create and nothing to fill in
  • Shows each listing's contact name and photo, never a phone number
  • Each listing opens its full page on your Key Deal website
Example
<script src="https://youragency.keydeal.io/embed.js" async></script>
Harbour View 2BRAED 1.79M
Creek Beach 3BRFrom AED 2.95M

A documented real estate listings API

For a developer building your site, the read-only API returns your published listings as JSON. The documentation page covers the keys, every endpoint, filter and field, paging and syncing, errors and limits.

  • Filter by property type, completion, sales status, developer, location, size and words
  • One listing in full, with its unit types and their prices
  • Developers and locations with their counts, for building filter menus
  • Paging with total pages, and updated since for keeping a copy in sync
  • An OpenAPI file for the tools your developer already uses
Example
New listingDraft saved · just now

Step 4 of 7 · Price

“2 bed in Harbour View, 1.79M, 40/60 plan, handover Q1 2028”

Price

AED 1,790,000

Payment plan

40/60

Keys that only work where you say

A website key works only from the sites you list; a server key is refused if a browser sends it. Only a fingerprint of each key is stored, so a key is shown once, when you make it.

  • Choose what a key can see: every listing, some realtors' or chosen listings
  • Realtors' details included or left out, per key
  • Usage per day for every key, and limits per minute
  • Private and unlisted listings, and exact map locations, are never returned
Example
Waiting for approval1

Creek Beach 3BR · change from Mona

PriceAED 3.1M→AED 2.95M
ApproveSend back

One listing anywhere, on any plan

Every published listing can be embedded on its own from its page: Share, then Embed on your website. A card with the photo, title and price, in light or dark, that opens the listing when pressed.

  • Paste the code into any website or blog post
  • Fills whatever size you give it
  • Never carries a client's private tracked link
Example
yourname.keydeal.ioAbout · Contact
BuyOff-plan2 bedUnder AED 2M
Harbour View 2BRAED 1.79M
Creek Gate 1BRAED 1.12M

How to start

Three steps, and it is yours.

  1. Open Embed and API

    Listings, then Embed & API, in the agency dashboard.

  2. Pick the widget or a key

    Set the widget's layout and colour, or make a website or server key for your developer.

  3. Paste it into your site

    Copy the snippet or a code sample. Your site shows your live listings from then on.

Or say it to Claude

  • “Which of our live listings are public, so they show on our website?”
  • “Make Harbour View unlisted so it comes off our website”
How the Claude connector works

Questions

What people ask about embed and api.

Anything else? Search the help centre or ask us.

Do I need a developer to put our listings on our website?

No. The listings widget is one snippet with nothing to fill in: choose the layout and colour, copy it and paste it into a page of your site. The API is there for when a developer wants to build the listings into the site themselves.

Which listings does the embed and the API show?

Only published listings that are public. Drafts, listings waiting for approval, the sample listing, and unlisted or private listings are never shown, and a listing taken down disappears from your website with it.

Does the API return phone numbers and exact locations?

Exact map coordinates are never returned. The keyless widget shows each listing's contact name and photo but never a phone number. With a key, you choose per key whether realtors' details are included.

Is the API read-only?

Yes. The listings API reads your published listings, developers and locations; it cannot create, change or delete anything. Listings are still added and edited in Key Deal, by the team or through Claude.

What are the rate limits?

A website key allows 120 requests a minute and a server key 600. The keyless widget is limited per visitor's address and per agency, which is far more than a website's visitors need.

Can an independent realtor use the API?

The listings widget and the API are part of the agency plan. Any realtor can still embed a single published listing on a website from that listing's Share menu.

Works well with

Every feature
Listings and websiteReal estate websiteYour own property website, filled from your listings.Learn more Listings and websiteListing managementEvery property in one place, from a description to a live page.Learn more Clients and pipelineListing analyticsWhich listings are read, and which clients are warm.Learn more

Run the whole agency from one place.

30 days free, no card needed. Everything on this page comes with the agency plan.

Set up your agencySign in