Caribe Scout
REES v0.2 · draft

Connect your listings

Three ways in, from zero effort to full control. Whichever you pick, your listings stay credited to you, link back to your site, and every enquiry goes to you, free.

1. Send us the feed you already have

If your website or CRM already exports listings, we can usually read it as it is:

  • OpenImmo XML, RESO Web API or Data Dictionary exports, Kyero XML
  • WordPress real-estate themes that publish schema.org data (Houzez, WP Residence, RealHomes and similar)
  • A spreadsheet export, for small portfolios

Send the URL to partners@caribescout.com. We map it to REES on our side — see the mappings — and tell you which fields would lift your listings to the next level.

2. Publish a REES feed

The best option if you have a developer or a CRM that allows custom exports.

  1. Expose one URL that returns your feed as JSON over HTTPS, e.g. https://youragency.com/rees.json. Static file or generated on request — both work.
  2. Include every active listing, and keep sold, rented or withdrawn listings in the feed with that status for at least 30 days. That is how receivers learn a listing is gone — one that silently disappears could simply be a broken export.
  3. Keep ids stable. A listing's id never changes and is never reused.
  4. Optionally support deltas. If your URL accepts ?since=2026-10-01T08:00:00Z, return only what changed. We pull deltas hourly and the full feed daily.
  5. Large portfolios: page with next. Keep each page under 5 MB.
  6. Check it with the validator, then send us the URL.

Access control

A public URL is simplest and fine for data already on your website. If you prefer it private, give us a query token (?key=…) or a bearer token we send as Authorization: Bearer …. We fetch from Cloudflare's network with the user agent CaribeScoutBot/1.0 (+https://caribescout.com/bot).

Photos and languages

Link your original photos in media, largest size available; we make one copy for fast display, never watermarked or edited. Send titles and descriptions in every language you have, in the same listing, and amenities as codes from the vocabulary — we display them translated.

3. Use the partner portal

For a handful of listings, or to correct what we already show: claim your free partner account to edit prices, mark sold, add rentals and see every lead.

What happens to your data

  • Every listing shows "Listed by" with your name and a link to its url on your site.
  • Enquiries are sent to you. We charge nothing to buyers, renters or you for routing them.
  • Listings are ordered by value against the neighbourhood, never by who pays.
  • We never publish a listing whose licence does not allow it — see data rights & credit.
  • A Verified or Complete feed earns its badge on each listing.

Send us your feed URL →