Feed guide for CRM providers

Rightmove uses client certificates. We use a key per agency instead: the agent creates one under CRM import in their dashboard and gives it to you. Send it on every call as Authorization: Bearer kcf_..., or as an X-Feed-Key header if your system can only set custom headers. The key decides which agency the listings belong to; network_id and branch_id are accepted and echoed back, but not checked. Agents can revoke a key at any time.

Product, performance and lead calls aren't supported: there are no paid products, and enquiries are emailed to the agent.

POST https://kensingtonandchelsea.london/api/feeds/rtdf/v1/property/sendpropertydetails
Authorization: Bearer kcf_...
Content-Type: application/json

{
  "network": { "network_id": 1234 },
  "branch": { "branch_id": 5678, "channel": 2 },
  "property": {
    "agent_ref": "NH-1042",
    "published": true,
    "property_type": 8,
    "status": 1,
    "address": {
      "house_name_number": "21",
      "address_2": "Elgin Crescent",
      "town": "London",
      "postcode_1": "W11",
      "postcode_2": "2JD",
      "display_address": "Elgin Crescent, Notting Hill"
    },
    "price_information": { "price": 3250, "rent_frequency": 12, "deposit": 3750 },
    "details": {
      "summary": "A bright two bedroom flat on Elgin Crescent.",
      "description": "<p>...</p>",
      "bedrooms": 2,
      "bathrooms": 1,
      "council_tax_band": "E"
    },
    "media": [
      { "media_type": 1, "media_url": "https://cdn.example-crm.com/nh-1042/1.jpg", "sort_order": 0 }
    ]
  }
}

Every response uses Rightmove's envelope:

{
  "request_id": "6f3c...",
  "message": "The property was saved as a draft. See the warnings for what it needs.",
  "success": true,
  "request_timestamp": "19-10-2026 11:26:38",
  "response_timestamp": "19-10-2026 11:26:39",
  "property": {
    "agent_ref": "NH-1042",
    "rightmove_id": 76,
    "rightmove_url": null,
    "change_type": "CREATE"
  },
  "errors": null,
  "warnings": [
    {
      "warning_code": "not_live",
      "warning_description": "Not live yet: Add the EPC rating, or why the property is exempt.",
      "warning_value": null
    }
  ]
}

rightmove_id holds our listing number and rightmove_url the public page once it's live. Schema errors return HTTP 400, a missing or revoked key 401. Business-rule problems return 200 with success: false and an errors list.

• Drafts first. A property is saved even when it can't be live yet, and the warnings say what's missing. It goes live on a later send once it's complete, or when the agent fills the gap in their dashboard.
• EPC rating. RTDF and BLM don't carry the rating as a field, but UK listings must show it, so agents add it once on each listing. Later sends keep it.
• Fields you don't send are kept. Anything the formats can't carry (EPC, building safety, the agent's own headline) survives a resend.
• Borough only. Postcodes outside the Royal Borough of Kensington and Chelsea are rejected with postcode_outside.
• Residential lettings take one fixed rent: price qualifiers are dropped (Renters' Rights Act) and weekly rents are converted to monthly. Deposits above the Tenant Fees Act cap are left out, which keeps the listing as a draft.
• Commercial listings are recognised from the commercial property types, let_type 4 or comm_use_class. Old use classes are translated to the current ones where that's unambiguous.
• Status. published: false takes a live listing off the market. RemoveProperty with reason 7 (sold by us) or 12 (let by us) marks it sold or let; other reasons withdraw it.

• We download media from your URLs: public http or https hosts on ports 80 or 443, up to 10 MB each, as JPEG, PNG or WebP (PDF too for floorplans, brochures and EPCs). Up to 80 files per listing.
• Media types 1 (image), 2 (floorplan), 3 (brochure), 6 and 7 (EPC) are imported. Virtual and audio tours are skipped for now.
• A URL we already hold isn't fetched again unless its media_update_date changes. URLs left out of a send are removed, as on Rightmove.

Agents upload a .blm file, or a .zip of the file with its images (up to 50 MB), under CRM import in their dashboard. We read the separators from the header, so any EOF and EOR characters work. Media columns can hold file names from the zip or full URLs. Images 60 and up, and documents 50 and up, are treated as EPCs. The agent can mark an upload as complete, which takes listings missing from it off the market.

Ask an agency you work with to create a key, then send a property with published: false: it's saved as a draft that only the agency can see, and their CRM import page shows the result of every call. For help, email hello@kensingtonandchelsea.london.